用途
implementing-plans 是 rpikit 技能集中的实施阶段技能,目标不是“写出能跑的代码”,而是按已批准方案完成可验证、有记录、与方案一致的实现。它强调:把方案当契约、逐步验证、进度可见、偏差需审批。
主要能力
- 定位并校验方案:若参数是文件路径(以 / 开头、以 docs/ 开头或以 .md 结尾)则直接读取;否则按主题在 docs/plans/YYYY-MM-DD-<topic>-plan.md 中查找匹配 *-<topic>-plan.md 的文件,并检查方案是否标记为已批准。
- 按风险分级执行:高风险(架构性、安全敏感、难以回滚)必须有获批方案,否则停止并建议先使用 researching-codebase 与 writing-plans 技能;中风险无方案时询问用户“先制定方案”“谨慎继续”或“取消”;低风险可在提示后直接内联规划并继续。
- 工作区隔离建议:先检查 .git 是否为文件以判断是否已在 worktree 中;不在时按风险等级提议使用 EnterWorktree 创建隔离工作区。完成后用 ExitWorktree 的 keep 保留分支,中止时用 discard 清理。
- 任务化进度跟踪:用 TaskCreate 把方案步骤转为任务,以祈使句作主题,写入动作与验证标准,设置进行时描述,并用 addBlockedBy 表达步骤间依赖;开始执行时标记 in_progress,验证通过后立即标记 completed,避免批量完成。
- 逐步执行与验证:每一步先定位并读取目标文件再修改,严格按方案执行,运行验证标准,通过后才进入下一步,并同步更新方案文档的状态与备注。支持测试驱动执行(红-绿-重构),测试通过才标记完成。
- 阶段检查点:每个阶段完成后汇总进度与验证结果,询问用户“继续下一阶段”“查看目前改动”或“暂停实施”。
- 失败处理:验证失败时停止、报告原因、诊断(外部库或陌生问题可借助检索代理),提出修复;若需变更方案,则请求“批准调整并继续”“返回规划”或“取消实施”。
- 收尾审查:全部步骤完成后运行最终验证(如全量测试)、代码审查与安全审查;代码审查若为“要求修改”属软门槛,可由用户选择先处理、继续或取消;安全审查失败则必须停止处理。最后输出完成步骤数、阶段数、变更文件、测试状态与方案文档更新情况。
使用方式
以方案路径或主题作为参数触发;技能通过 Bash 检查 .git 状态,通过 Task 工具调用 file-finder、web-researcher、code-reviewer、security-reviewer 等子代理,并通过 AskUserQuestion 在关键节点请求用户决策。实施全程需遵守:修改前先读文件、每步后运行验证、完成即标记任务、阶段检查点需确认、任何偏差需记录并获批。
适用场景
适合已有获批方案的中大型代码改动、需要严格验证与可追溯进度的实现工作,以及希望以隔离 worktree 降低风险并保留审查环节的团队流程。
限制与注意
依赖 TaskCreate/TaskUpdate/TaskList、EnterWorktree/ExitWorktree 等工具环境;EnterWorktree 存在已知问题(bypassPermissions 可能失效、后台代理工作目录可能不正确),进入后需核实工作目录。该技能不替代人工审批:高风险无获批方案时不会继续,安全审查失败即停止。方案缺失时具体行为按上述风险分级处理,其余未在资料中说明的细节暂未提供。