Update commit skill to four-pass method#2
Update commit skill to four-pass method#2mikemindel wants to merge 1 commit intochriswickett:mainfrom
Conversation
The old commit skill was a flat three-pass process pointing at a monolithic reference file. Replace with the structured four-pass methodology from codefu: separate SKILL.md, WORKFLOW.md, and a references directory for supporting documents. - Rewrite SKILL.md with coherence test, atomicity mistakes, format ref - Add WORKFLOW.md with the five-pass execution sequence - Move atomic-git-commits.md into references/ - Add chris-beams-commit-style.md reference
5dfbabf to
fcdf015
Compare
|
I like the structure and the references cleanup, but I'm not sure about the multi-commit methodology for this use case. To adopt this properly, we'd need to update the Actions skills (pr-start, pr-fix) to make multiple commits per task. That means reviewing a feature spread across several commits instead of one clean diff, which makes it harder for me to see what Claude did in a given pass. For me, I wouldn't want that in this repo for how I like to work with my other clients. If you are married to small commits, then perhaps we need to start thinking about how agentic might implement config/preferences that can be changed per-client repo? Any ideas? I'd also argue that SKILL.md and the reference file cover a lot of the same ground which would swell the token cost (something I need to keep an eye on!) |
|
Also, I like the deterministic nature of Claude having to write one commit_msg.txt. It so far has made it easier to see if it succeeded or not to do the task. |
Summary
What changed
The old commit skill was a single SKILL.md pointing at a monolithic reference file. The new structure splits concerns across focused documents:
Test plan
/commitskill triggers correctly