ai-research-lab

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

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

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

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

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

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

status:ready の issue を claim する。遷移直前に ready を再確認してから in-progress へ atomic 遷移し、二重取得のレース窓を最小化する。issue を処理開始する直前に必ず使う。

[2] design issue の本文に要件定義・詳細設計・調査結果を構造化して書き込む。重い推論工程。コードは変更しない。

[3] impl issue の実装指示に従いコードを変更し、テストを通し、PR を作成する。Step 1 では Claude が Codex を代用。変更は git worktree 内に隔離する。

GitHub issue を 1 件読み、type / status / agent / priority / 親子関係を構造化して把握する。issue を処理する前段で使う。

issue の status ラベルを atomic に遷移する。単一の gh issue edit で旧ラベル除去と新ラベル付与を同時に行い、status の二重化を防ぐ。全ての状態遷移はこのスキルを通す。

type:request ([1]) の issue を吟味し、[2] design 化してよいか・優先度を判定する。人間レビューゲート G1 の補助。