在用户提及“验收通过”“测试通过”“总结变更”“提交更改”“提交改动”“保持工作区干净”“清理工作区”“收尾记录”等表示当前需求或开发计划已完成的语义时,执行收尾记录流程:检查或创建 docs/PROGRESS.md、检查并清理 git 工作区(必要时提交)、基于开发计划或提交区间生成约150字简体中文连续段落总结,并以“YYYY.MM.dd|当前HEAD前8位: 总结内容”格式仅追加写入 docs/PROGRESS.md。
在开发收尾场景下,确保工作区干净且进度记录可审计。严格执行“只追加、不改写历史”的记录规则。
docs/PROGRESS.md 是否存在。hash1;若不存在,则创建空的 docs/PROGRESS.md。git status --porcelain 检查工作区。hash2;若已干净,则将当前 HEAD 视为 hash2。hash1..hash2 区间内的主要改动文件与变更要点。YYYY.MM.dd)与当前 HEAD 前8位短哈希,按以下格式追加到 docs/PROGRESS.md:
- ({curr_git_head_hash:8}) : {curr_date_yyyy_mm_dd} {content}{content} 必须是一段连续中文文本,不使用列表、编号、小标题或多段结构。若当前上下文包含开发计划,则需要补充开发计划文件的文件名。例如 docs/exec-plans/active/model_design.mddocs/PROGRESS.md 任何历史条目,只允许文件末尾追加。hash1(例如首次创建文件),明确说明“基于当前提交状态生成总结”,并仍按同一格式追加(日期使用当天,格式为 YYYY.MM.dd)。在需要提交时,提交信息必须满足 Conventional Commits:
<type>: <description>type 仅允许:feat|fix|docs|style|refactor|perf|test|build|ci|chore|revertdescription 至少 10 个字符,且必须具体描述技术改动fix、update)、禁止 --amend执行结束后自检:
docs/PROGRESS.md 是否仅新增一条记录。- ({curr_git_head_hash:8}) ({curr_date_yyyy_mm_dd}) : 连续中文段落 格式。entry_line,再执行去重检查,最后才允许追加。grep -Fqx \"$entry_line\" docs/PROGRESS.md。git add/commit 或结束流程。