| name | requirements-to-merge |
| description | 要求開発から計画立案・実装・PR 提出までを一括で実行するエンドツーエンドスキル。 「要求から実装まで一括でやって」「全部通しでやって」「要望から PR まで進めて」 「ワンショットで開発して」「要求開発から merge まで」と言った場合にトリガーする。 develop-requirements → planner → execute-plan → test-verifier(V) → test-verifier(V&V) → submit-pull-request の 6フェーズを Board・Gate と連携して実行する。orchestrate-workflow の要求駆動版として、 要求開発を起点に素早くマージまで完了させる用途に適する。 |
要求開発→計画→実装→PR 一括フロー
前提
.github/settings.json からプロジェクト設定を読み取って使用する- worktree + Board が準備済みであること（未準備の場合は
start-feature スキルを先に実行）
- Board を使用し、各フェーズの成果物を
artifacts に永続化する
- Gate 評価は
gate-profiles.json の Board の gate_profile（= maturity）に従う
orchestrate-workflow との違い
| 観点 | requirements-to-merge | orchestrate-workflow |
|---|
| Board | 使用する | 使用する |
| Gate 評価 | Maturity 別に評価する | Maturity 別に評価する |
| エントリーポイント | 要求開発（requirements-engineer）固定 | 任意のフェーズから開始可能 |
| 影響分析 | execute-plan 内で統合実施 | impact-analyst で独立フェーズとして実施 |
| 構造評価 | execute-plan 内で統合実施 | architect で条件付き独立フェーズとして実施 |
| テスト検証 | test-verifier で独立検証 | test-verifier で独立検証 |
| 妥当性確認 | test-verifier で独立検証【必須】 | test-verifier で独立検証【必須】 |
| コードレビュー | execute-plan 内で統合実施 | reviewer で独立レビュー |
| ドキュメント更新 | execute-plan 内で統合実施 | writer で独立実施 |
| フェーズ数 | 6（要求開発→計画→実装→テスト検証→妥当性確認→PR） | 11（全フェーズ独立） |
| 用途 | 要求開発を起点に一気通貫で完了 | フェーズ単位の制御が必要な場合 |
使い分け: 要求開発から始めて素早くマージしたい場合は本スキル。
フェーズ間で人間の判断を挟みたい、または影響分析・構造評価を独立フェーズとして実施したい場合は orchestrate-workflow。
入力
- ユーザーの要望テキスト（自由形式）
- または既に
develop-requirements で取得済みの検証済み要求
手順
0. 設定読み込み・前提確認
.github/settings.json を読み取る
github.owner, github.repo — PR 提出用agents.model — デフォルトモデルagents.<agent_name>.model — エージェント個別モデル
- ルールの事前ロード:
rules/development-workflow.md（Maturity 判断用）rules/workflow-state.md（状態遷移ポリシー）rules/gate-profiles.json（Gate 条件）
- 現在の作業ディレクトリを確認する:
git branch --show-current
| 確認項目 | 対応 |
|---|
| main ブランチ上にいる | 中断 — start-feature スキルで worktree・Board を準備してから再実行 |
| Feature ブランチ上にいる | 続行 |
| worktree 内にいる | 続行 |
- Board の存在を確認する:
ls .copilot/boards/<feature-id>.json
| 確認項目 | 対応 |
|---|
| Board が存在する | Board を読み取り、flow_state を確認 |
| Board が存在しない | 中断 — start-feature スキルで Board を作成してから再実行 |
- Board の
flow_state に応じた再開判定:
| flow_state | 対応 |
|---|
initialized | フェーズ 1（要求開発）から開始 |
eliciting | 要求開発が途中。フェーズ 1 を再開 |
analyzing / designing / planned | フェーズ 2（計画立案）から再開 |
implementing | フェーズ 3（実装）から再開 |
testing | フェーズ 4（テスト検証）から再開 |
validating | フェーズ 5（妥当性確認）から再開 |
reviewing / approved | フェーズ 6（PR 提出）から再開 |
submitting / completed | 既に完了済み。ユーザーに通知して終了 |
gate-profiles.json から Board の gate_profile に対応するプロファイルを読み込む
1. 要求開発（develop-requirements）
Gate: requirements_gate — gate-profiles.json の required 値に従う
Gate 判定
requirements_gate.required | 動作 |
|---|
true | requirements-engineer を呼び出す |
false | フェーズ 1 をスキップし、フェーズ 2 に進む |
事前コンテキスト収集（並列）
PARALLEL:
- explore: プロジェクトの設計哲学の把握
- explore: 既存の類似機能・関連コードの調査
requirements-engineer 呼び出し
task ツール（agent_type: requirements-engineer）:
- ユーザーの要望: <要望テキスト>
- Maturity: <Board の maturity>
- プロジェクトコンテキスト: <事前収集した情報>
- 出力: 検証済み要求定義（problem_statement, validated_needs, scope_boundary）
- Board 書き込み先: artifacts.requirements_development
flow_state 遷移
initialized → eliciting（requirements-engineer 開始時）
結果判定と Gate 評価
| approval.status | 対応 |
|---|
approved | requirements_gate を passed に更新。フェーズ 2 に進む |
rejected | ユーザーに報告して終了 |
needs_revision | requirements-engineer を再実行（最大 2 回） |
Board 更新
artifacts.requirements_development — requirements-engineer の出力gates.requirements.status — passed / skippedhistory — 要求開発の実施記録を追記
中間報告
## ✅ フェーズ 1/6 完了: 要求開発
- 問題定義: <problem_statement の要約>
- ニーズ: <validated_needs の数>件（Must: N / Should: N / Could: N）
- スコープ: <in_scope の要約>
- Gate: requirements_gate → passed
→ フェーズ 2: 計画立案に進みます
2. 計画立案（planner）
Gate: plan_gate — gate-profiles.json の required 値に従う
Gate 判定
plan_gate.required | 動作 |
|---|
true | planner を呼び出す |
false | フェーズ 2 をスキップし、フェーズ 3 に進む（要求開発の結果から直接実装） |
planner 呼び出し
task ツール（agent_type: planner）:
- 検証済み要求:
- problem_statement: <artifacts.requirements_development.problem_statement>
- validated_needs: <artifacts.requirements_development.validated_needs>
- scope_boundary: <artifacts.requirements_development.scope_boundary>
- プロジェクト情報:
- language: <settings.project.language>
- test_command: <settings.project.test.command>
- Board コンテキスト:
- feature_id: <feature_id>
- maturity: <maturity>
- 出力: タスク一覧（担当エージェント・依存関係・優先度）
- Board 書き込み先: artifacts.execution_plan
- plan.md のパス: <セッションフォルダ>/plan.md
planner は以下を含む plan.md と Board の artifacts.execution_plan を生成する:
- 問題概要と方針
- タスク一覧（マークダウンチェックボックス形式）
- 各タスクの担当エージェント（developer / writer 等）
- タスク間の依存関係
- リスク・注意事項
flow_state 遷移
eliciting（または initialized）→ planned（planner 完了時）
Board 更新
artifacts.execution_plan — planner の出力gates.plan.status — passed / skippedhistory — 計画策定の記録を追記
中間報告
## ✅ フェーズ 2/6 完了: 計画立案
- タスク数: N 件
- 並列実行可能: N 件
- 推定リスク: <リスク概要>
- Gate: plan_gate → passed
→ フェーズ 3: 実装に進みます
3. 実装（execute-plan）
Gate: implementation_gate（全 Maturity で必須）
execute-plan スキルの手順に従い、Board の artifacts.execution_plan からタスクを取得して依存関係に基づき並列実行する。
本フェーズの詳細手順は skills/execute-plan/SKILL.md を参照。
Board 統合モードで実行する（flow_state: implementing として動作）。
flow_state 遷移
planned → implementing（実装開始時）
主な動作:
- Board の
artifacts.execution_plan からタスク一覧を取得
- 依存グラフに基づき実行順序を決定
- 並列安全なタスクは同時実行
- 失敗時は Self-repair ループ（最大 3 回リトライ）
- 全タスク完了後に結果を集計
- Board の
artifacts.implementation を更新
Board 更新
artifacts.implementation — 変更ファイル一覧と実装概要gates.implementation.status — passed（evidence_required に commit_sha を含める）history — 実装の記録を追記
中間報告
## ✅ フェーズ 3/6 完了: 実装
- 完了: N 件
- ブロック: N 件（ある場合は理由付き）
- 変更ファイル: <ファイル一覧>
- Gate: implementation_gate → passed
→ フェーズ 4: テスト検証に進みます
4. テスト検証（Verification）
Gate: test_gate — gate-profiles.json の required 値に従う
test-verifier エージェントに検証を依頼する。execute-plan 内でテストが実行済みでも、
独立した検証を実施する（実装者 ≠ 検証者の原則）。
task ツール（agent_type: test-verifier）:
- テスト仕様: <artifacts.test_design（存在する場合）>
- 要求仕様: <artifacts.requirements_development.validated_needs>
- テストコマンド: <settings.project.test.command>
- Board コンテキスト:
- feature_id: <feature_id>
- maturity: <maturity>
- 出力: テスト検証結果（verdict, traceability, quality_issues）
- Board 書き込み先: artifacts.test_verification
verdict に応じた制御
| verdict | 対応 |
|---|
pass | test_gate を passed に更新。フェーズ 5 に進む |
conditional_pass | planner に許容判断を委ねる |
fail | developer に修正指示を渡してフェーズ 3 に戻る（最大 2 回） |
flow_state 遷移
implementing → testing（test-verifier 開始時）
Board 更新
artifacts.test_verification — test-verifier の出力gates.test.status — passed / failedhistory — テスト検証の記録を追記
5. 妥当性確認（Validation）【スキップ不可・MUST】
⛔ このフェーズは Gate Profile の required 値に関わらず必ず実施する。
testing → reviewing への直接遷移は禁止。必ず testing → validating の経路を通ること。
Phase 4 完了後、必ず別の test-verifier エージェント呼び出しで妥当性確認を実施する。
Phase 4（Verification）と Phase 5（Validation）は同一呼び出しにまとめてはならない。
task ツール（agent_type: test-verifier）:
- 妥当性確認計画: <artifacts.validation_plan（存在する場合）>
- 要求仕様: <artifacts.requirements / artifacts.requirements_development>
- テスト結果: <artifacts.test_verification>
- 出力: 妥当性確認結果（verdict, validation_results, unknowns, residual_risks）
- Board 書き込み先: artifacts.acceptance_validation
- 指示: validation_plan が存在しない場合、requirements の AC から確認項目を自ら構築すること
verdict に応じた制御
| verdict | 対応 |
|---|
validated | validation_gate を passed に更新。フェーズ 6 に進む |
partially_validated | planner に許容判断を委ねる |
not_validated | developer に未充足 AC を渡してフェーズ 3 に戻る（最大 2 回） |
⛔ MUST NOT: artifacts.acceptance_validation が存在しない場合、または
acceptance_validation.verdict が "validated" でない場合、フェーズ 6 に遷移してはならない。
flow_state 遷移
testing → validating（妥当性確認開始時）
Board 更新
artifacts.acceptance_validation — test-verifier の出力gates.validation.status — passed / failedhistory — 妥当性確認の記録を追記
6. PR 提出（submit-pull-request）
Gate: submit_gate（全 Maturity で必須。sandbox の場合は blocked）
submit-pull-request スキルの手順に従い、コミット → プッシュ → PR 作成 → マージ。
本フェーズの詳細手順は skills/submit-pull-request/SKILL.md を参照。
submit_gate の判定
submit_gate.required | 動作 |
|---|
true | PR 提出・マージを実行 |
"blocked" | PR 提出を禁止。approved で作業終了とし、クリーンアップに進む（sandbox） |
flow_state 遷移
validating → approved（妥当性確認完了、PR 準備完了）approved → submitting（PR 作成開始）submitting → completed（マージ完了）
主な動作:
- 事前安全チェック（ブランチ確認・未コミット変更の確認）
git add -A && git commit（コミットメッセージは rules/commit-message.md に従う）git push- PR 作成（タイトル・説明に要求開発の problem_statement を含める）
- マージ（
settings.github.mergeMethod に従う）
PR 説明への要求開発コンテキストの反映
PR の説明文（body）に以下を含める:
## 概要
<problem_statement>
## 検証済みニーズ
<validated_needs のサマリ>
## スコープ
- スコープ内: <in_scope>
- スコープ外: <out_of_scope>
## 変更内容
<execute-plan の変更サマリ>
Board 更新
gates.submit.status — passedflow_state — completedhistory — PR 提出・マージの記録を追記
完了報告
## ✅ 全フェーズ完了
### サマリ
| フェーズ | 状態 | Gate |
|---|---|---|
| 1. 要求開発 | ✅ 完了（ニーズ N 件） | requirements_gate → passed |
| 2. 計画立案 | ✅ 完了（タスク N 件） | plan_gate → passed |
| 3. 実装 | ✅ 完了（変更 N ファイル） | implementation_gate → passed |
| 4. テスト検証 | ✅ 完了 | test_gate → passed |
| 5. 妥当性確認 | ✅ 完了（AC 充足率 N%） | validation_gate → passed |
| 6. PR 提出 | ✅ マージ完了（PR #N） | submit_gate → passed |
### PR
<PR の URL>
### Board
flow_state: completed
フェーズ間のデータ受け渡し
フェーズ間のデータは Board の artifacts を通じて受け渡す。
| データ | Board フィールド | 生成元 | 消費先 |
|---|
| 検証済み要求 | artifacts.requirements_development | フェーズ 1 | フェーズ 2, 4, 5, 6 |
| 実行計画 | artifacts.execution_plan | フェーズ 2 | フェーズ 3 |
| 実装結果 | artifacts.implementation | フェーズ 3 | フェーズ 4, 6 |
| テスト検証結果 | artifacts.test_verification | フェーズ 4 | フェーズ 5, 6 |
| 妥当性確認結果 | artifacts.acceptance_validation | フェーズ 5 | フェーズ 6 |
コンテキスト保全: 各フェーズの出力は Board に永続化される。
コンテキストが圧迫された場合でも、Board ファイルを view で再読み込みすれば状態を完全に復元できる。
plan.md はセッションフォルダに保存し、Board の artifacts.execution_plan と同期する。
中断・再開
Board に状態が永続化されているため、中断後の再開が確実に行える。
| 中断ポイント | Board の状態 | 再開方法 |
|---|
| フェーズ 1 完了後 | flow_state: eliciting, artifacts.requirements_development あり | 本スキルを再実行 → フェーズ 2 から自動再開 |
| フェーズ 2 完了後 | flow_state: planned, artifacts.execution_plan あり | 本スキルを再実行 → フェーズ 3 から自動再開。または execute-plan を直接実行 |
| フェーズ 3 完了後 | flow_state: implementing, artifacts.implementation あり | 本スキルを再実行 → フェーズ 4 から自動再開 |
| フェーズ 4 完了後 | flow_state: testing, artifacts.test_verification あり | 本スキルを再実行 → フェーズ 5 から自動再開 |
| フェーズ 5 完了後 | flow_state: validating, artifacts.acceptance_validation あり | 本スキルを再実行 → フェーズ 6 から自動再開 |
| フェーズ 6 失敗 | flow_state: submitting | submit-pull-request を再実行。コンフリクト時は resolve-conflict |
エラー時の対処
| エラー | 対処 |
|---|
| main ブランチ上で実行 | start-feature スキルでの worktree・Board 準備を案内して中断 |
| Board が存在しない | start-feature スキルでの Board 作成を案内して中断 |
| requirements-engineer が 2 回 needs_revision | ユーザーに要望の再整理を依頼して中断 |
| planner の出力が不十分 | requirements の要約を補強して planner を再実行 |
| execute-plan で全タスク blocked | blocked 理由をユーザーに提示し、対処方針を確認 |
| PR マージ失敗（コンフリクト） | resolve-conflict スキルを使用 |
| submit_gate が blocked（sandbox） | approved で作業終了。cleanup-worktree スキルに進む |
| コンテキストウィンドウ圧迫 | Board に状態が永続化済み。view で Board を再読み込みして復帰 |
