用途:progress-summary 用于把进行中的工作整理成对话式摘要,风格参照写得好的 PR 描述。它服务于“帮我总结一下”“发生了什么”“现在到哪了”“给我个概览”等场景。
主要能力与要求:摘要以动机为先,先说明为什么做这件事,让读者先理解问题再看解决方案;展示决策过程,如考虑过 X 但因 Y 选择 Z;语言口语化但精确,协作内容用“we”,个人观察用“I”。提供三种形态:快速状态(2-4 句,含问题、发现、当前动作)、工作会话回顾(结构为攻克的问题、关键决策及原因、当前可用部分、剩余待办)、架构概览(复杂改动交给 notebook-explanation 负责心智模型与图示语法,progress-summary 仍围绕它说明改了什么、为何改、还有什么没完成)。
使用方式:生成摘要前先收集上下文。资料给出的命令包括:git status、git log --oneline -10、git diff main...HEAD --stat、git log main..HEAD --oneline、git log --oneline --since="1 hour ago"。若环境提供专用 workspace-diff 工具则优先使用,否则用 git diff --stat、git diff 和定向读取文件。还应读取被修改的关键文件,理解改动实质而非只看 diff 统计。
限制与避免事项:不要罗列改动文件,如“更新了 auth.ts、session.ts 和 upload.ts”,而是解释改了什么、为什么;不要用企业腔、营销语言(如“游戏规则改变者”“革命性”“无缝”)或夸张措辞;不要把所有内容都做成列表,尽量用连贯段落;不要过度解释简单改动,解释深度应与复杂度匹配。关于收费、平台支持等其它信息,资料暂未提供。