Task Detail

[タスク] 2. Issue詳細化 + 依存関係設定

入力: $ARGUMENTS

• Milestone名（例: sprint-1）または Issue番号（例: #123）

🎯 目的

• 指定したSprint（Milestone）内のIssueに 実装詳細 を追記する
• 組み込みTaskの 依存関係（blocks/blockedBy） を設定する
• 実装前の調査・準備を明示的に行い、品質を担保する
• GitHub Issue と 組み込みTask の両方に依存関係を反映する

実行手順

1. 対象Issue一覧取得

# Milestone指定の場合
gh issue list --milestone "sprint-1" --state open --json number,title,body

# Issue番号指定の場合
gh issue view 123 --json number,title,body

2. 一覧表示 + 選択

📋 Sprint: sprint-1

┌────┬─────────────────────┬──────────┬─────────────┬─────────────┐
│ #  │ Title               │ Issue    │ Task Status │ 詳細化      │
├────┼─────────────────────┼──────────┼─────────────┼─────────────┤
│ 1  │ ユーザー認証実装     │ #123     │ pending     │ ❌ 未       │
│ 2  │ ログイン画面作成     │ #124     │ pending     │ ❌ 未       │
│ 3  │ API設計             │ #125     │ pending     │ ✅ 済       │
└────┴─────────────────────┴──────────┴─────────────┴─────────────┘

→ どのIssueを詳細化する？ [番号を入力]

3. 調査・準備

選択したIssueに対して以下を調査：

1. コードベース分析

   • 類似機能/参照ファイル/命名規約/テスト雛形の抽出
   • 重複回避を最優先し、既存拡張で解決できるか確認

2. 外部調査

   • 公式Doc(URL)、GitHub実装例、StackOverflow（出典実在のみ）

3. RDD整合チェック

   • 技術スタック/制約/非機能要件の遵守を確認
   • 決定理由/背景を記録

4. 依存関係の特定

   • このタスクが依存するタスク（blockedBy）
   • このタスクを待っているタスク（blocks）

4. Issue本文に詳細追記

# 現在の本文を取得
BODY=$(gh issue view 123 --json body --jq '.body')

# 詳細を追記（⚠️ 確認あり）
gh issue edit 123 --body "${BODY}

---
## 実装詳細（/task-detail で追記）

### 技術スタック
{RDD指定のスタック}

### 参照ドキュメント
- [公式Doc] {タイトル} — {URL}
- [既存コード] {path/to/file}

### 実装ブループリント
\`\`\`typescript
// 擬似コード
function example() {
  // ...
}
\`\`\`

### 依存関係
- **blockedBy**: #124（これが完了してから着手）
- **blocks**: #126（これの完了を待っている）

### 難所検証方針
- {最小サンプルで検証する内容}

### 変更要求（必要時のみ）
> **ADR-lite**: {変更内容と理由}
> **承認状況**: 待ち / 承認済み
"

5. 組み込みTask依存関係設定

GitHub Issue の依存関係を組み込みTaskにも反映する：

TaskUpdate:
  taskId: "{task-id}"        # metadata.issueNumber で特定
  addBlockedBy: ["{blocking-task-id}"]
  addBlocks: ["{blocked-task-id}"]

6. ラベル追加

# 詳細化完了を示すラベル（⚠️ 確認あり）
gh issue edit 123 --add-label "ready-for-dev"

7. Sprint ブランチ作成（Milestone 内の詳細化が完了したら）

対象 Sprint の全 Issue に ready-for-dev が付いたら、実装の受け皿となる sprint/* ブランチを作成する（命名は .claude/rules/git.md 準拠）:

# main から sprint ブランチを作成（⚠️ 確認あり）
git checkout main && git pull
git checkout -b sprint/YYYY-MM-機能名
git push -u origin sprint/YYYY-MM-機能名

このブランチが以降の /auto-task（task/* の親）のマージ先になる。

依存関係の可視化

📊 依存関係グラフ

#123 ユーザー認証実装
  └─→ #124 ログイン画面作成（#123 完了後）
       └─→ #125 E2Eテスト（#124 完了後）

#126 API設計（独立、並行実行可）

出力

GitHub

• Issue本文: 実装詳細セクションを追記
• ラベル: ready-for-dev を追加
• ブランチ: Milestone 内の詳細化完了時に sprint/* を作成

組み込みTask

• TaskUpdate: blocks/blockedBy で依存関係を設定

品質チェックリスト

• 参照ドキュメントが実在するURLである
• 既存コードの参照箇所が特定されている
• 実装ブループリント（擬似コード）が明確
• 依存関係がIssue本文と組み込みTaskの両方に設定されている
• ready-for-dev ラベルが付与されている
• 変更要求がある場合は承認待ちを明記

自己評価

• 成功自信度: (1-10)
• 一言理由: {短く理由を記載}

次のステップ

/auto-task #<issue番号>  # タスクごとに task/* ブランチを切って自律実装ループを実行

• Sprint 内の ready-for-dev な Issue を依存関係順に /auto-task へ渡す（task→sprint マージまで自律）
• Sprint の全タスク完了後、AI が sprint → main の PR を作成して人間へ引き渡す（マージ判断は人間）
• 単発で手動実行したい場合のみ /task-run を使う