| name | design-issue |
| description | [2] design issue の本文に要件定義・詳細設計・調査結果を構造化して書き込む。重い推論工程。コードは変更しない。 |
design-issue スキル
概要
[2] 設計工程の本体。type:design issue の本文を DoD を満たす設計ドキュメントに
仕上げる。コードは書かない(実装は [3] の仕事)。
実行手順
入力: claim 済み(status:in-progress)の type:design issue N。
issue-read で [2] と親 [1] を把握する。
- 必要なら
TARGET_REPO のコードを Read / Grep / WebSearch で調査する。
- 設計本文を作る。本文 DoD(protocol §7):
- 冒頭の
親: / 由来: 行を保持する — 既存本文(breakdown-request が
書いた)からそのまま引き継ぐ。--body-file は本文を全置換するため、
ヘッダ行を新本文に必ず含める。
- 背景 — 何を・なぜ(親 [1] の要約)
- 要件 — 満たすべき条件
- 設計 — 方針・構成・データフロー・影響範囲
- 調査ソース — 参照した一次情報・コード位置(事実誤認を G3 で検証可能に)
- 子 [3] のリスト — 実装単位の見出し(起票は
breakdown-design が行う)
- issue 本文を更新する。env var は永続しないため
.env の source は同一ブロックで
行う(protocol §9):
set -a; . ./.env; set +a
gh issue edit <N> --repo "$TARGET_REPO" --body-file <設計本文ファイル>
- 本文を更新したら呼び出し元へ「設計完了」を返す(
breakdown-design に続く)。
注意
- このスキルの工程は
--allowedTools から Edit/Write を外す前提(protocol /
レポート §7-4)。設計はコードを変更しない。
- 設計方針の承認(G3)は人間。エージェントは
review までしか進めない。