mcpField
R
rpi

rpi

github.com/humanlayerAgent 工作流5.5k486 次安装3 周前更新
代码仓库

关于 rpi

rpi 是用于推动变更从研究进入设计和实现的 skill。它支持选择工作流阶段,并在任务目录中管理文档。

主要功能

  1. 01覆盖研究、设计和实现阶段
  2. 02创建或更新工作流文档
  3. 03未指定步骤时选择流程
  4. 04在任务目录中管理产物

适用场景

  1. 01先研究变更,再选择设计流程
  2. 02起草或修改 PRD 和技术设计文档
  3. 03按结构大纲开展实现
  4. 04恢复未完成的工作流

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/humanlayer/skills --skill rpi

安装后在 Claude Code 中输入/rpi确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/create-design-discussion/
process.md
references/create-design-discussion/references/
design_discussion_final_answer_resolved.md
design_discussion_final_answer.md
design_discussion_template.md
references/create-prd/
process.md
references/create-prd/references/
prd_final_answer_resolved.md
prd_template.md
references/create-research-questions/
process.md
references/create-research-questions/references/
request_template.md
research_questions_final_answer.md
research_questions_template.md
references/create-research/
process.md
references/create-research/references/
research_final_answer.md
research_template.md
references/create-structure-outline/
process.md
references/create-structure-outline/references/
structure_outline_final_answer.md
structure_outline_template.md
references/create-tdd/
process.md
references/create-tdd/references/
tdd_final_answer_resolved.md
tdd_template.md
references/implement-outline/
process.md
references/implement-outline/references/
implement_outline_final_answer.md
references/iterate-design-discussion/
process.md
references/iterate-design-discussion/references/
design_discussion_final_answer_resolved.md
design_discussion_final_answer.md
design_discussion_template.md
references/iterate-implementation/
process.md
references/iterate-implementation/references/
iterate_implementation_final_answer.md
references/iterate-prd/
process.md
references/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
产品需求 / PRDcreate-prd 或 iterate-prd
技术设计 / TDDcreate-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。

从 $SKILLBASE/references/subagents/SUBAGENT_NAME.md 读取子代理说明 从 $SKILLBASE/references/subagents/SUBAGENT_NAME.md 读取子代理说明,并将其连同主提示词一起传递给子代理,格式如下: REFERENCE_CONTENTS YOUR_MESSAGE_ON_WHAT_TO_LOOK_FOR_OR_BUILD

评论

支持 Markdown