关于 rpi
rpi 是用于推动变更从研究进入设计和实现的 skill。它支持选择工作流阶段,并在任务目录中管理文档。
主要功能
- 01覆盖研究、设计和实现阶段
- 02创建或更新工作流文档
- 03未指定步骤时选择流程
- 04在任务目录中管理产物
适用场景
- 01先研究变更,再选择设计流程
- 02起草或修改 PRD 和技术设计文档
- 03按结构大纲开展实现
- 04恢复未完成的工作流
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ humanlayer/ skills --skill rpi安装后在 Claude Code 中输入/rpi确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/create-design-discussion/process.mdreferences/create-design-discussion/references/design_discussion_final_answer_resolved.mddesign_discussion_final_answer.mddesign_discussion_template.mdreferences/create-prd/process.mdreferences/create-prd/references/prd_final_answer_resolved.mdprd_template.mdreferences/create-research-questions/process.mdreferences/create-research-questions/references/request_template.mdresearch_questions_final_answer.mdresearch_questions_template.mdreferences/create-research/process.mdreferences/create-research/references/research_final_answer.mdresearch_template.mdreferences/create-structure-outline/process.mdreferences/create-structure-outline/references/structure_outline_final_answer.mdstructure_outline_template.mdreferences/create-tdd/process.mdreferences/create-tdd/references/tdd_final_answer_resolved.mdtdd_template.mdreferences/implement-outline/process.mdreferences/implement-outline/references/implement_outline_final_answer.mdreferences/iterate-design-discussion/process.mdreferences/iterate-design-discussion/references/design_discussion_final_answer_resolved.mddesign_discussion_final_answer.mddesign_discussion_template.mdreferences/iterate-implementation/process.mdreferences/iterate-implementation/references/iterate_implementation_final_answer.mdreferences/iterate-prd/process.mdreferences/iterate-prd/references/prd_final_answer_resolved.md详细介绍
研究、设计和实现
帮助用户研究变更、梳理设计并实现。按照用户要求的步骤执行,并遵循下方对应阶段的说明。
$SKILLBASE 表示包含此 SKILL.md 的目录。
模板中的 <rpi-invocation> 表示宿主的技能命令:在 Codex 中为 $rpi,在 Claude Code 中为 /rpi,或宿主提供的插件限定名称。生成后续命令时,使用对应的原生命令。
选择步骤
按照用户要求的步骤执行。在选择或说明工作流或后续步骤时,阅读 $SKILLBASE/references/workflow.md。
如果任务描述没有指定步骤,请先提出研究问题。询问用户想要哪种工作流:研究后讨论设计、编写 PRD、编写 TDD,还是仅进行研究。等待用户选择后再开始阶段,然后在建议的后续命令中沿用该选择。
询问用户选择工作流时,阅读 $SKILLBASE/references/workflow-choice.md,并在提问时展示其中的方框和连线图。
创建会新建文档;迭代会根据用户反馈原地更新现有文档,或从未完成的文档继续工作流。
加载对应步骤的流程说明:$SKILLBASE/references/<step>/process.md:
| 请求 | 步骤 |
|---|---|
| 研究问题 | create-research-questions 或 iterate-research-questions |
| 研究 | create-research 或 iterate-research |
| 设计讨论 | create-design-discussion 或 iterate-design-discussion |
| 产品需求 / PRD | create-prd 或 iterate-prd |
| 技术设计 / TDD | create-tdd 或 iterate-tdd |
| 实现大纲 | create-structure-outline 或 iterate-structure-outline |
| 实现 | implement-outline |
| 实现反馈或修复 | iterate-implementation |
默认更新现有文档;需要或按要求时再创建文档。若有多个文档符合条件,使用最新的一个,并说明选用的文件。
使用任务目录
使用用户提供的目录。
否则,在 .agents/artifacts/ 中查找现有任务目录,其名称和工作流文件与请求或当前任务分支相匹配。若有明显匹配项,则复用,无需询问。若某个目录看似匹配,但可能属于其他任务,或有多个目录都可能符合条件,则在写入前询问用户要使用哪个目录。检查匹配项时,只读取所选阶段允许读取的文档。
若没有合适的现有目录,且分支名称能标识任务,则使用 .agents/artifacts/<branch-name>,并将 / 替换为 -。在 main 分支上,或没有可标识任务的分支时,根据请求选取简短的 kebab-case 名称,并使用 .agents/artifacts/<task-slug>,无需征求批准。说明所选路径,并按需复用或创建目录。
保存到所选路径。如果沙盒阻止在该路径写入,请申请限定范围的写入权限,或询问用户选择一个可写任务目录,然后等待用户选择。
RPI 框架作者建议不要提交这些产物。
在任务目录中,新建的工作流文档使用下一个可用的 NN- 前缀。更新文档时保留现有路径。将配套模型图和示意图保存在文档旁边,并作为普通本地文件链接。
工作流文档的 frontmatter 包含 repos,它是一个列表,列出零个或多个仓库,每项包含 identifier 和 sha。若不适用,则使用 repos: []。必要时为字符串值加引号,以确保 YAML 格式有效。
建议下一步
使用当前阶段的交接说明和 $SKILLBASE/references/workflow.md 选择下一步。默认情况下,用户会在单独的上下文窗口中运行每个阶段。建议下一条命令时,包含任务目录和选定的流程。说明他们可以在此处、压缩上下文后或在新会话中运行。
询问下一步是什么时,使用产物文件名定位当前阶段,然后阅读相应文档,了解未完成的工作和已确定的选择。识别 prd 或 product-requirements、tdd 或 tech-design,以及 structure-outline 或 outline。
使用子代理
按照各阶段的指示,使用随附的 Agent 说明:codebase-locator、codebase-analyzer、codebase-pattern-finder、web-search-researcher 和 outline-implementer-agent。