agentdev-epic-tracker

Imported from yogata/agent-dev-flow (src/opencode/skills/agentdev-epic-tracker/SKILL.md). Install upstream with npx skills add yogata/agent-dev-flow --skill agentdev-epic-tracker. Copyright stays with the author.

name: agentdev-epic-tracker description: Updates parent Epic Issue status tracking tables in case-close workflows (single-writer). USE FOR: case-close Epic Issue status writes (pending→completed/blocked/failed), tracking child Issue progress in parent Epics, detecting parent-child relationships via Parent: #N patterns. DO NOT USE FOR: creating Epics, managing non-Epic Issues, general Issue operations.

Epic 状態追跡（Epic Status Tracker）

親Epic Issueのステータス追跡テーブル（pending/ completed/ blocked/ failed）を更新する知識ベースである。 ready/ running は case-run(#epic) の内部状態であり、Epic Issue 本文（永続状態）には書き込まれない（Decision 単一書き手制約、epic-wave-model Design 参照）。

• 参照元: case-close（completed/ blocked/ failed 更新、単一書き手）。case-auto、case-run は Epic Issue 本文を読み取るのみで書き込まない
• ⏭スキップ は採用しない。前提未達の Issue は pending のまま選択対象外となる。Wave status は保存せず、Wave 内 Issue 状態から導出する

入力

• 子Issue 本文（Parent: #{N} パターン）、子Issue の実行結果（completed-pr/ blocked/ failed）、PR 番号/ URL

出力

• 更新された親Epic Issue 本文のステータス追跡テーブル行（pending → completed ([PR#N](URL))/ blocked/ failed）

副作用

• 親Epic Issue 本文を更新する（agentdev_gh の issue_update 操作経由）。子Issue 本文、PR は更新しない

常に守る不変条件

• 単一書き手: Epic Issue 本文のステータス追跡テーブルは case-close(#epic) のみが書き込む。case-run(#epic)、case-auto は書き込まない
• 永続状態に書き込むステータス値: pending/ completed/ blocked/ failed のみ。ready/ running は case-run(#epic) の内部状態であり、Epic Issue 本文には書き込まれない
• べき等性: 既に completed/ blocked/ failed の行は更新対象外（スキップ）。case-close は確定済み終了状態を上書きしない
• 一括更新順序: 複数子Issueの一括更新時は子Issue番号の昇順

ステータス値定義

子Issue 実行状態 enum（epic-wave-model Design「子Issue実行状態 enum」参照）:

Epic自動クローズ判定では completed を終了状態として扱う（blocked/ failed は終了状態だが自動クローズ完了とはみなさない）。

永続状態遷移: Epic Issue 本文（永続状態）に書き込まれるのは pending → completed/ blocked/ failed の遷移のみ。

親Epic検出

子Issue本文から Parent: #{N} パターンを検出し、{N} を親Epic Issue番号として扱う。

• Parent: パターンなし → 親Epicなし。ステータス更新をスキップ（エラーにしない）
• Parent: #N の # は省略可能（Parent: 42 も有効）

主要な判断順序（case-close: completed/ blocked/ failed 更新）

1. 子Issue本文から Parent: #{N} を検出。親Epicが存在しない → スキップ
2. agentdev_gh の issue_read 操作でEpic本文を取得
3. 正規表現で該当子Issue行を特定（新4列/旧4列形式に対応）
4. べき等性確認（既に終了状態ならスキップ）
5. pending を置換（completed なら PR番号/ URL 付き、blocked/ failed なら当該ステータス値）
6. agentdev_gh の issue_update 操作でEpic本文を更新

blocked/ failed は case-close が case-run(#epic) の実行結果（completed-pr/ blocked/ failed）から確定して Epic Issue 本文へ反映する終了状態。

reference選択表

通常経路で全 reference を無条件読込しない。 必要な条件に応じて読む reference を選択する。

See Also

• Custom Tool agentdev_gh（Epic Issue 本文の読み取り・更新）
• agentdev-workflow-lifecycle: Epic振る舞いルール、進捗追跡テーブル定義