用途:在开始编码前先做规划,把重要信息写入文件系统,便于跨会话与上下文压缩后延续工作。核心思路是上下文窗口相当于易失内存,文件系统相当于持久磁盘,规划阶段成本低于实现阶段。
主要能力:提供 init-plan.sh 脚手架,执行 bash init-plan.sh "Feature Name" 会生成 .plan/ 目录及 task_plan.md、findings.md、progress.md 三个模板文件,并把 .plan/ 加入 .gitignore。计划模板包含方法、范围、文件结构表、分阶段任务、验证与退出条件。主张垂直切片而非按技术分层,每 2-3 个任务设检查点,任务要求动词开头、原子化、具体到文件路径与预期输出,禁止占位式描述。还包含类型一致性检查、提交 SHA 记录、偏离文档化、阶段规模限制等规则。
使用方式:多文件修改、新功能、重构或超过 5 次工具调用时建立完整 .plan/ 计划;3-5 个文件的小改动用内联清单或单个 progress.md;单文件编辑或简单查询则跳过。已有项目在规划前可先用 Glob 和 Grep 查找测试文件与测试配置,确定规范测试命令。会话开始时读取 .plan/progress.md 恢复状态,结束时更新进度。需要深化已有计划时读取原计划、补齐模糊部分,而非重跑全流程。
适用场景与限制:适用于多阶段软件实现与复杂功能拆解。.plan/ 是临时工作状态,不应提交;正式计划放在 docs/plans/。资料未提供具体收费、价格与平台信息。