承認ゲート共通フォーマット

承認ゲート共通フォーマット

参照元: 各ワークフロー（req-workflow, basic-design-workflow, detailed-design-workflow, implement-issues）から分離された承認ゲートパターン

---

概要

全てのワークフローは、重要なフェーズ移行前にユーザーの明示的な承認を必要とする。

原則: ユーザーからの明示的な応答があるまで次のフェーズに進んではならない。

---

承認ゲートの種類

参照: 合格基準の正式定義は {{skill:workflow-phase-convention}} §レビュースコア閾値を参照

---

出力フォーマット

設計ワークフロー用（共通テンプレート）

---
## 🔔 承認リクエスト: {ドキュメント種別}レビュー完了

### レビュー結果サマリー
| 項目 | 結果 |
|------|------|
| 最終スコア | X/​10点 |
| レビュー回数 | Y回 |
| 合格基準 | {N}点以上 ✅ |

### 成果物
- **パス**: `{file_path}`

### 主要な内容（抜粋）
{summary_table_or_list}

### 未解決課題（あれば）
| ID | 課題 | 対応方針 |
|----|------|---------|
| I-XXX | [課題] | [方針] |

---
**次のアクション**: {next_action}

⏸️ **承認待ち**: 続行してよろしいですか？

1. 続行 → {continue_action}
2. 修正 → 指摘箇所を修正（コメントで指示してください）
3. 中断 → ワークフローを終了

> 番号を選択してください（1-3）:
---

実装ワークフロー用（PR作成承認）

## ✅ 品質レビュー通過 - PR作成承認リクエスト

### Issue情報
- **Issue**: #{issue_id} - {issue_title}
- **ブランチ**: `feature/​issue-{issue_id}-{description}`

### レビュー結果
- **スコア**: {score}/​10
- **レビュアー**: {reviewer_agent}

### 変更概要
- 新規ファイル: {new_files_count}件
- 変更ファイル: {modified_files_count}件
- 削除ファイル: {deleted_files_count}件

### 主な変更内容
{change_summary}

### テスト結果
- 合計: {total_tests}件
- 成功: {passed_tests}件
- 失敗: {failed_tests}件

---

**PR作成を承認しますか？**

1. 続行 → PR作成を続行
2. 修正 → 追加修正が必要（指摘箇所をコメントしてください）
3. 下書き → Draft PRとして作成

> 番号を選択してください（1-3）:

---

ユーザー回答と対応アクション

設計ワークフロー共通

実装ワークフロー（PR作成）

---

タイムアウト仕様（実装ワークフローのみ）

---

実装ガイドライン

1. 承認待ち状態を明示: ⏸️ 承認待ち マークを必ず表示
2. 番号選択形式を使用: 1/2/3 の番号で選択可能にする
3. 選択肢を明確に: 3択（続行/修正/中断 or 下書き）を提示
4. 次のアクションを予告: 承認後に何が起こるか説明
5. 応答なしで進まない: ユーザー応答がない限りブロック

---

---

ワークフロー完了後の次ステップ選択

ワークフロー完了後、自動的に次のワークフローへ進むのではなく、ユーザーに選択肢を提示して次のアクションを決定させる。

対象ワークフロー

出力フォーマット（次ステップ選択）

---
## ✅ ワークフロー完了: {ワークフロー名}

### 成果物サマリー
| 項目 | 結果 |
|------|------|
| 最終スコア | X/​10点 |
| 成果物 | `{file_path}` |
| ステータス | 合格 ✅ |

### 次のステップを選択してください

1. {次ワークフロー名}に進む（`{次ワークフローコマンド}`）
2. 成果物を修正する（指摘箇所をコメントしてください）
3. 一旦終了する

> 番号を選択してください（1-3）:
---

具体例

/​req-workflow 完了後

---
## ✅ ワークフロー完了: 要件定義

### 成果物サマリー
| 項目 | 結果 |
|------|------|
| 最終スコア | 8/​10点 |
| 成果物 | `docs/​requirements/​REQ-XXX-001_機能名.md` |
| ステータス | 合格 ✅ |

### 次のステップを選択してください

1. 基本設計に進む（`/​basic-design-workflow`）
2. 要件定義書を修正する（指摘箇所をコメントしてください）
3. 一旦終了する

> 番号を選択してください（1-3）:
---

/​basic-design-workflow 完了後

---
## ✅ ワークフロー完了: 基本設計

### 成果物サマリー
| 項目 | 結果 |
|------|------|
| 最終スコア | 9/​10点 |
| 成果物 | `docs/​designs/​basic/​BASIC-XXX-001_機能名.md` |
| ステータス | 合格 ✅ |

### 次のステップを選択してください

1. 詳細設計に進む（`/​detailed-design-workflow`）
2. 基本設計書を修正する（指摘箇所をコメントしてください）
3. 一旦終了する

> 番号を選択してください（1-3）:
---

/​detailed-design-workflow 完了後

---
## ✅ ワークフロー完了: 詳細設計

### 成果物サマリー
| 項目 | 結果 |
|------|------|
| 最終スコア | 9/​10点 |
| 成果物 | `docs/​designs/​detailed/​{機能名}/` |
| Epic Issue | #123 |
| 子Issue数 | 5件 |
| ステータス | 合格 ✅ |

### 次のステップを選択してください

1. 実装に進む（`/​implement-issues`）
2. 詳細設計書を修正する（指摘箇所をコメントしてください）
3. 一旦終了する

> 番号を選択してください（1-3）:
---

ユーザー回答と対応アクション

実装ガイドライン

1. 必ず番号選択形式: ユーザーが明確に選択できるように番号を使用
2. 自動実行しない: ユーザーが 1 を選択するまで次ワークフローは開始しない
3. 成果物パスを引き継ぐ: 次ワークフローへの引数として成果物パスを渡す
4. 終了時は成果物を明示: 「終了」選択時は成果物の場所と次回再開方法を提示

---

変更履歴