用途:创建并维护与 git 分支绑定的 PLAN.md 规划文档。文档面向两类读者——代理据此判断进度并从此前中断处继续,人类可快速查看计划、变更与当前状态。
主要能力与用法:
- 计划引导:改动前先阅读 PLAN.md;恢复会话时读取最新 Status Updates 条目并运行 git diff --stat 检测偏移;用户说“continue”时依最新状态更新确定上次改动与下一步。PLAN.md 视为恢复日志而非任务追踪器,条目保持简短、基于事实。Plan 部分用复选框跟踪进度,并为重要取舍添加 Decisions 条目,为非显而易见的发现添加 Discoveries 条目。
- 工作流:用 git rev-parse --abbrev-ref HEAD 确定当前分支。若在默认分支(常为 main 或 master),询问用户是新建并切换到功能分支还是在默认分支继续;对较大、长期或需评审的工作建议新建分支,简单任务或快速规划可留默认分支;用户选择新建分支时,仅建议具体分支名后停止,待其先切换。若留默认分支,则从请求推导逻辑计划 slug(主题模糊时询问),按 feat/<slug> 继续,除非 fix/ 或 chore/ 更合适。
- 计划路径:真实分支若匹配 ^(feat|fix|chore)/(.+)$,取 prefix 与 feature;不匹配则 prefix 为 feat、feature 为完整分支名。留默认分支时用推导出的逻辑前缀/slug。路径为 docs/plans/<prefix>/<feature>/PLAN.md。不存在时创建目录并按 references/plan-template.md 生成,填写 Goal 与 Plan 部分;已存在则不覆盖,更新复选框并追加状态更新。
- 更新:完成有意义工作后追加 Status Updates 条目(最新在前),含 Change(改了什么)、State now(当前状态)、Validate(一条验证命令);勾选 Plan 中已完成项。
- 错误协议:重复失败采用三次升级——诊断并针对性修复;尝试不同方法(不重复相同失败操作);复查假设并更新计划。三次失败后向用户升级,说明已尝试内容与最佳后续选项。
- 验证:宣称完成前,运行最新状态更新中的 Validate: 命令。
限制:资料未提供收费、价格、平台支持范围等具体信息。