rpi について
rpiは、定義されたワークフローの段階に沿って、調査、設計、実装を進めるエージェントスキルです。プロセスの選択やタスク文書の管理、次の段階への移行を支援します。
主な機能
- 01段階に沿った調査と実装
- 02フロー選択と次段階への引き継ぎ
- 03タスク成果物ディレクトリの管理
- 04ワークフロー文書の作成・更新
活用シーン
- 01変更作業を調査質問から始める
- 02PRDや技術設計を作成する
- 03既存のアウトラインに沿って実装する
インストール
コマンドをコピーしてターミナルで実行します。
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 を読み、質問とともに、そのボックスと線で構成された図を提示してください。
Create は新しいドキュメントを作成します。iterate はユーザーのフィードバックに基づいて既存のドキュメントをその場で更新するか、途中まで作成されたドキュメントからワークフローを再開します。
該当するプロセスを $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 の場合、またはブランチからタスクを特定できない場合は、リクエストから短いケバブケースのスラッグを作り、承認を求めずに .agents/artifacts/<task-slug> を使用してください。選択したパスを明示し、必要に応じてディレクトリを再利用または作成してください。
サンドボックスによってその場所への書き込みが妨げられる場合は、対象を限定した書き込みアクセス、または書き込み可能なタスクディレクトリをユーザーに求め、その選択を待ってください。
RPI フレームワークの作成者は、成果物をコミットしないことを推奨しています。
新しいワークフロードキュメントには、タスクディレクトリ内で次に使用可能な NN- プレフィックスを付けてください。ドキュメントを更新する場合は、既存のパスを維持してください。補助的なモックアップや図はドキュメントと同じ場所に保存し、通常のローカルファイルとしてリンクしてください。
ワークフロードキュメントのフロントマターには、各エントリに identifier と sha を含む、リポジトリのリスト repos を記載します。該当するリポジトリがない場合は repos: [] を使用してください。有効な YAML になるよう、必要に応じて文字列値を引用符で囲んでください。
ドキュメントをレビューする
ワークフロードキュメントを書き込んだ後、または更新した後に、$SKILLBASE/references/prose.md と $SKILLBASE/references/show-me.md を読み、両方の基準に照らしてドキュメントをレビューしてください。文章を短く、視覚的にわかりやすく、人が読み取りやすいものにしてください。必要性のない単語やセクションを削り、密度の高い文章は要点を伝える最小限の表現に置き換え、それを補足する短い説明のそばに各図を配置してください。
次のステップを提案する
フェーズの引き継ぎ手順と $SKILLBASE/references/workflow.md を使って、次に何を行うか選択します。デフォルトでは、ユーザーは各フェーズを別々のコンテキストウィンドウで実行します。次のコマンドを提案する際は、タスクディレクトリと選択したフローを含めます。現在のセッション、コンパクション後、または新しいセッションで実行できることも伝えます。
次に何をすべきか尋ねられた場合は、成果物のファイル名から現在のフェーズを特定し、そのドキュメントを読んで未完了の作業と確定した選択を確認します。prd または product-requirements、tdd または tech-design、structure-outline または outline を認識します。
サブエージェントを使う
各フェーズの指示に従って、同梱されている codebase-locator、codebase-analyzer、codebase-pattern-finder、web-search-researcher、outline-implementer-agent のエージェント指示を使います。