agentleFS
mae616mae616/ai-template/.claude/skills/task-detail/SKILL.md

task-detail

Skill9 starsChanged 3 months agoMITView on GitHub

Sprint配下のIssueに実装詳細と依存関係を設定し、ready-for-devラベルを付与する。スプリント計画後のタスク詳細化で使う。

  • Commits and pushes

The file

Files
SKILL.md

[タスク] 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 を使う

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.