用途 该技能用于在单次会话中完整执行 Research → Plan → Implement(RPI)三个阶段的开发流程。它通过子代理(subagent)把每个阶段放到独立的上下文窗口中运行,由编排器统一协调审批关口和阶段切换。相比跨多个会话分别运行 RPI 各阶段,该流程避免上下文丢失与手工衔接。
架构 编排器(主上下文)保持轻量:它通过 Agent 工具为每个阶段派生子代理,读取子代理输出的文件产物,向用户展示摘要,并处理审批关口。编排器本身不执行研究、规划或实现。流程为:
- 研究阶段:并行派发代码库探索、网络调研、综合等子代理,输出 docs/plans/YYYY-MM-DD-<topic>-research.md。
- 审批关口:用户确认研究结论。
- 规划阶段:派发规划子代理,读取研究文件并写出 docs/plans/YYYY-MM-DD-<topic>-plan.md。
- 审批关口:用户批准计划。
- 实现阶段:派发实现子代理,读取计划并执行,输出代码变更与测试结果。 核心原则是子代理通过文件而非对话上下文通信。
适用场景 需要理解不熟悉的代码或 API 的功能;规划前需调查多个方面;需要完整的研究→规划→实现循环;希望避免手工衔接各阶段会话。不适用于:需求已明确(可直接用 rpikit:writing-plans)、已有计划(用 rpikit:implementing-plans)、简单缺陷修复(用 rpikit:systematic-debugging)、只需研究无需实现。
使用方式 研究阶段先定义 2-3 个独立研究问题(代码库现状、外部 API/库/模式、安全/性能关注点),用 Agent 工具并行派发子代理(如 codebase-researcher、web-researcher、security-researcher),各子代理将发现写入独立文件,研究代理不得使用 isolation: "worktree"。随后派发 synthesizer 子代理调用 rpikit:synthesizing-research 汇总为研究文档,并向用户展示摘要表格与审批选项。 规划阶段派发 planner 子代理(提示中指定 model 为 opus),读取研究文档并调用 rpikit:writing-plans 生成自包含计划,不得向用户提问。完成后向用户展示 stakes、阶段数、步骤数并要求批准。 实现阶段派发 implementer 子代理(isolation: worktree),读取计划并调用 rpikit:implementing-plans,按顺序执行步骤、每步验证、跟踪进度、完成时做代码审查与安全审查,并在结束前提交所有更改(隔离 worktree 中未提交的工作会在清理时被销毁)。
定制与规则 若已有研究或计划产物,可跳过相应阶段;仅需研究则在第一阶段后停止。研究深度随复杂度调整:简单 1 个子代理、中等 2 个、复杂 3-4 个。需求不清时可先用 rpikit:brainstorming。模型选择建议:haiku 用于文件查找,sonnet 用于研究、综合、代码审查,opus 用于规划、实现、架构。编排器必须保持轻量,不亲自做研究、写计划或改代码;不得跳过审批关口;研究子代理控制在 2-4 个,且只并行独立问题。
限制 资料未提供安装命令、收费、价格或平台支持等具体信息,暂未提供。