用途:借助代码库本身澄清用户意图,并保留会话之间容易丢失的推理过程。先调查现状与期望行为的差异,与用户一起思考关键设计取舍,最后留下一份紧凑简报,让另一个强模型无需重建对话即可继续。
工作流:
- 定位。阅读仓库说明、相关产品或设计文档、代码、测试与历史。跟随用户关注点,仅在需要理解依赖或契约时扩大搜索。
- 追踪行为。确认系统当前做什么及原因,优先采用代码与测试的直接证据,而非清单、通用最佳实践或逐类审计。
- 找出决策。暴露矛盾、缺失语义与真实选择;只呈现会导致行为显著不同的选项,推荐最简单且自洽的设计,先尝试从代码库解答问题再询问用户。
- 记录结果。方向稳定后,在 plans/<slug>.md 写入或更新一份简报;若 plans/ 已有其他用途,选择附近适合项目的位置并说明简报去向。
- 向前传递。压缩后或实现会话中,把简报视为事实来源;决策变化时保持更新,删除被取代的推理,而非累积辩论历史。
遵循用户要求的阶段:头脑风暴请求以简报结束;实现请求可使用简报并继续进入改动。
应保留的内容:预期结果及其重要性;用户可见行为与领域语言;语义不变量(输入、输出、状态转换、归属、失败行为,以及相关的顺序或并发规则);仅在约束设计时保留兼容性、迁移、安全、隐私与性能要求;已做出的决策及原因;开始工作所需的当前实现事实与简洁的文件或符号引用;仅当答案可能改变实现时才保留开放问题。表达真实产品或系统行为的负面约束应写入简报,例如数据绝不能离开信任边界;不要把偶然的文件边界或假想的执行者错误变成契约。
简报格式(仅使用承载信息的章节):# <期望结果>;## Intent;## Contracts;## Current state;## Decisions;## Open questions;## Implementation shape;## Verification。省略空章节,必要时用示例或小表格更精确地表达契约。
保持高信噪比:用户精确命名概念或区分时保留其原话;区分观察到的事实、已选决策与未解决问题;证据以指针形式记录而非复制大段代码;实现结构只描述到足以保留设计;偏好少量相互关联的发现而非穷尽清单;省略评分与流程元数据(置信度、不确定性、工作量、规模、风险、状态表、提交戳、维护样板),除非用户明确需要其中某项来决策;省略穷尽文件白名单、黑名单、逐步命令记录以及针对较弱执行者的指令。当新会话能在编辑代码前说明预期结果、定义正确性的契约、已确定的决策与剩余问题时,简报即完整。
限制:资料未提供具体安装命令、收费方式、支持平台或效果数据。