mcpField
I
issue-to-prd

issue-to-prd

github.com/fellowship-dev開発3224 回インストール2 週間前に更新
リポジトリ

issue-to-prd について

GitHub issue と段階的な ICM 手順を使うチーム向けに、issue を PRD へ整理するスキルです。依頼をトリアージし、不足情報があれば質問し、必要に応じてガードレールとテスト計画を含む PRD を公開します。

主な機能

  1. 01対象外 issue の事前チェック
  2. 02既存の仕組みとの照合とトリアージ
  3. 03コンテキストと明確さの評価
  4. 04失敗モードとテスト計画
  5. 05質問または PRD の公開

活用シーン

  1. 01新しい GitHub issue の PRD 化
  2. 02情報不足の issue への確認依頼
  3. 03重複または不適切な依頼の停止や再スコープ

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fellowship-dev/dogfooded-skills --skill issue-to-prd

インストール後、Claude Code で/issue-to-prdを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CONTEXT.md
evals/
linked-metric-001.json
no-causal-contract-001.json
outcomes_contract_harness.py
outcomes-api-failure-001.json
redundant-mechanism-001.json
test_triage_label_contract.py
shared/
failure-modes.md
prd-template.md
prototype-mission-brief.md
stages/00-automation-guard/
CONTEXT.md
stages/00-automation-guard/output/
.gitkeep
stages/01-read-issue/
CONTEXT.md
stages/01-read-issue/output/
.gitkeep
stages/01b-triage-challenge/
CONTEXT.md
stages/01b-triage-challenge/output/
.gitkeep
stages/02-context-completeness/
CONTEXT.md
stages/02-context-completeness/output/
.gitkeep
stages/03-assess-clarity/
CONTEXT.md
stages/03-assess-clarity/output/
.gitkeep
stages/03-assess-clarity/references/
gap-checklist.md
stages/04-failure-modes/
CONTEXT.md
stages/04-failure-modes/output/
.gitkeep
stages/05-test-plan/
CONTEXT.md
stages/05-test-plan/output/
.gitkeep
stages/05b-prototype-gate/
CONTEXT.md
stages/05b-prototype-gate/output/
.gitkeep
stages/05b-prototype-gate/references/
gate-checklist.md
stages/05c-outcomes-baseline/
CONTEXT.md
stages/05c-outcomes-baseline/output/
.gitkeep

詳細

issue-to-prd

ICM 手順：新しい GitHub issue を構造化された PRD に変換するか、明確化の質問を投稿します。

起動方法

/issue-to-prd {repo} {issue_number}

例：/issue-to-prd fellowship-dev/pylot 123

使用するタイミング

  • 新しい issue が届き、構造化が必要な場合（challenge-new-issue イベントルールで起動）
  • 人間が open-questions に回答し、再チャレンジが起動する場合（rechallenge-after-answers で起動）
  • 特定の issue を構造化するために手動で起動する場合

実行内容

11 段階の ICM 手順：

  1. 00-automation-guard — 何も読む前に、no-automation／epic／クローズ済みの issue を拒否します
  2. 01-read-issue — issue のデータ（タイトル、本文、ラベル、コメント）を取得します
  3. 01b-triage-challenge — 同じニーズに応える既存の仕組みを検索し、その最小バージョンと照らして依頼内容を確認します → delete-retire／close／re-scope／prd。prd 以外の場合はパイプラインを停止します（ステージ 02〜07 はスキップ）
  4. 02-context-completeness — 新しいエージェントが見落としそうな暗黙のコンテキスト不足を監査します
  5. 03-assess-clarity — 8 セクションの不足項目チェックリストと照合します → clear または needs-questions
  6. 04-failure-modes — エージェントが誤った方向に進む可能性を予測します → PRD のガードレール
  7. 05-test-plan — テスト戦略と前提条件（マージ前およびマージ後）
  8. 05b-prototype-gate — UI の探索かどうかを判定します → skip／ask／dispatch／picked
  9. 05c-outcomes-baseline — issue に因果関係のある目標／評価／成果の契約があるかを検出します。その場合に限り、名前が指定されたメトリクスのベースラインとして GET /outcomes/summary を取得します（フェイルオープン）
  10. 06-ask-or-structure — 判断：質問を投稿（終了）するか、PRD を作成します（契約がある場合のみ Measurable Impact を含め、それ以外は「該当なし」とします）
  11. 07-publish — issue の本文を PRD に書き換え、ラベルを適用します

終了経路

  • ガード経路（ステージ 00）：読み取りなし、書き込みなし、status=success で停止
  • トリアージ経路（ステージ 01b）：判定と根拠として引用した証拠を明記したコメントを 1 件投稿し、wontfix または needs-rescope を適用して停止します（ステージ 02〜07 はスキップ）。引用がなければ絶対に実行されません
  • 質問経路（ステージ 06）：GH コメントを投稿し、open-questions ラベルを追加して停止します
  • PRD 経路（ステージ 07）：issue の本文を書き換え、prd-ready を追加します（プロトタイプの候補が保留中でない限り、ready-to-work も追加）

プロトタイプの候補

ステージ 05b は、proto/<issue>-a|b|c ブランチをプッシュし、スクリーンショットと起動手順を記載した選択肢コメントを 1 件投稿するミッションをディスパッチできます。担当者はそこから候補を選びます。厳格な条件があります。自動検出でできるのは質問することだけであり、ディスパッチできるのは明示的な担当者のシグナル（prototype-options ラベル、または「プロトタイプを作成する」という回答）がある場合に限られます。 詳細は stages/05b-prototype-gate/CONTEXT.md を参照してください。

ステージ間の引き継ぎ

各ステージは output/handoff.md に書き込みます。後続のステージは、先行ステージの引き継ぎ情報を読み取ります。 すべての出力ディレクトリは stages/{stage}/output/ にあります。

実行

ステージを順番に実行します。実行前に、各ステージの CONTEXT.md を読みます。 ステージ 00 は厳格なゲートです。中断された場合は、ほかの処理を実行しないでください。 ステージ 01b は厳格なゲートです。判定が prd 以外の場合は、それ以降を実行しないでください（ステージ 02〜07 はスキップ）。 ステージ 05c は常に実行します（フェイルオープン）。ステージ 06 のゲートにはなりません。 ステージ 06 の後、質問が投稿されていた場合はステージ 07 をスキップします。

参照ファイル

  • shared/prd-template.md — PRD の構成（ステージ 06 で使用）。## Measurable Impact セクションは、ステージ 05c の契約判定に応じて含めるかどうかを決定します
  • shared/failure-modes.md — エージェントによくある落とし穴のカタログ（ステージ 04 で使用）
  • shared/prototype-mission-brief.md — 候補ミッション用の自己完結型ブリーフ（ステージ 05b）
  • stages/03-assess-clarity/references/gap-checklist.md — 8 セクションのチェックリスト
  • stages/05b-prototype-gate/references/gate-checklist.md — プロトタイプのゲートと分類例
  • stages/05c-outcomes-baseline/CONTEXT.md — 因果関係のある契約の検出と、範囲を限定したフェイルオープンのベースライン形式

コメント

Markdown 対応