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 までしか進めない。

Más de este repositorio

mismo repositorio

md-to-html

linnefromice/ai-research-lab

Markdown を共通テーマの HTML（画面ダーク / 印刷は A4 ライトテーマ）に変換する。「HTML 化して」「HTML 版を作って」「PDF にしたい」で起動。調査/設計/レポート md の配布・印刷用途に。素早く出すなら scripts/render-html.sh、リッチな card/box レイアウトが要るときは LLM 整形。

2026-06-160

md-to-slide

linnefromice/ai-research-lab

調査/レポート md を発表スライド (Marp) に昇華する。report.md を要約・分割して slides.md を作り、HTML/PDF/PPTX に書き出す。「スライドにして」「発表資料を作って」「Marp で」で起動。文書とスライドは編集距離があるため別ファイル (slides.md) として作る。

2026-06-160

readable-md

linnefromice/ai-research-lab

Markdown を「人が読みやすく、かつ機械が HTML/スライドへ変換しやすい」構造に執筆・整形する。新規に調査/設計 md を書くときや、既存 md を昇華 (md→HTML→slide) の前に整えるときに使う。「読みやすい md にして」「昇華しやすく整形して」「調査 md を書いて」で起動。

2026-06-160

design-review

linnefromice/ai-research-lab

生成した HTML / スライドが「見た目 human friendly」か、ノンデザイナーズ・デザインブックの C.R.A.P. (Contrast/Repetition/Alignment/Proximity) + タイポグラフィで品質レビューする。「デザインを見て」「読みやすい見た目か」「レイアウトをレビュー」で起動。機械監査 (design-audit.sh) を先に走らせ、静的に測れない整列・近接・視覚的印象を補う。

2026-06-160

breakdown-design

linnefromice/ai-research-lab

[2] design を実装単位に分解し、複数の [3] impl issue を起票する ([2]→[3] のブレイクダウン)。[2] を review + needs-human に遷移する。

2026-05-250

breakdown-request

linnefromice/ai-research-lab

[1] request を入力に [2] design issue を起票する ([1]→[2] のブレイクダウン)。元の [1] は close する。

2026-05-250

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 までしか進めない。