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

implement-issue スキル

概要

[3] 実装工程。type:impl issue を実装し PR を出す。Step 2 以降は Codex が担うが、 Step 1 では Claude が代用する。

実行手順

入力: claim 済み（status:in-progress）の type:impl issue N。

issue-read で [3] と親 [2] を把握し、実装指示・完了条件を確定する。
worktree 隔離: .env の LOCAL_CLONE（TARGET_REPO のローカル clone）から作業用 worktree を切る。env var は永続しないため .env の source は同一ブロックで行う（protocol §9）:
```
set -a; . ./.env; set +a
git -C "$LOCAL_CLONE" worktree add "$WORKTREE_BASE/issue-<N>" -b "impl/issue-<N>"
```
破壊的なコード変更はこの worktree 内に限定する。
issue 本文の指示に従い worktree 内のファイルを実装する（Edit / Write）。
テスト・lint を実行し green にする。永続 cd は禁止（CWD はプロジェクトルートに保つ — protocol §9）。worktree 内での実行はサブシェルで: ( cd "<WORKTREE_BASE>/issue-<N>" && <test/lint コマンド> )。失敗が解消できなければ手順 7 へ。

commit・push・PR 作成。git は -C、gh pr create はサブシェルで worktree から実行する（.env を同一ブロックで source）:

set -a; . ./.env; set +a
wt="$WORKTREE_BASE/issue-<N>"
git -C "$wt" add -A
git -C "$wt" commit -m "<message>"
git -C "$wt" push -u origin "impl/issue-<N>"
( cd "$wt" && gh pr create --repo "$TARGET_REPO" \
    --head "impl/issue-<N>" --title "<title>" --body "Closes #<N>" )

[3] を in-progress→review + needs-human に遷移する（issue-transition）。 PR レビュー・マージ（G4）と issue close は人間が行う。
失敗時: [3] を in-progress→blocked + failed に遷移し、issue にコメントで理由（どこで詰まったか）を残す。

注意

Edit / Write を使うのは [3] 実装工程のみ。[2] 設計工程には渡さない（protocol / レポート §7-4）。
worktree は PR マージ後に人間 or 後片付け手順で git worktree remove する。

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

implement-issue スキル

概要

[3] 実装工程。type:impl issue を実装し PR を出す。Step 2 以降は Codex が担うが、 Step 1 では Claude が代用する。

実行手順

入力: claim 済み（status:in-progress）の type:impl issue N。

issue-read で [3] と親 [2] を把握し、実装指示・完了条件を確定する。

worktree 隔離: .env の LOCAL_CLONE（TARGET_REPO のローカル clone）から作業用 worktree を切る。env var は永続しないため .env の source は同一ブロックで行う（protocol §9）:

set -a; . ./.env; set +a
git -C "$LOCAL_CLONE" worktree add "$WORKTREE_BASE/issue-<N>" -b "impl/issue-<N>"

破壊的なコード変更はこの worktree 内に限定する。

issue 本文の指示に従い worktree 内のファイルを実装する（Edit / Write）。

テスト・lint を実行し green にする。永続 cd は禁止（CWD はプロジェクトルートに保つ — protocol §9）。worktree 内での実行はサブシェルで: ( cd "<WORKTREE_BASE>/issue-<N>" && <test/lint コマンド> )。失敗が解消できなければ手順 7 へ。

commit・push・PR 作成。git は -C、gh pr create はサブシェルで worktree から実行する（.env を同一ブロックで source）:

set -a; . ./.env; set +a
wt="$WORKTREE_BASE/issue-<N>"
git -C "$wt" add -A
git -C "$wt" commit -m "<message>"
git -C "$wt" push -u origin "impl/issue-<N>"
( cd "$wt" && gh pr create --repo "$TARGET_REPO" \
    --head "impl/issue-<N>" --title "<title>" --body "Closes #<N>" )

[3] を in-progress→review + needs-human に遷移する（issue-transition）。 PR レビュー・マージ（G4）と issue close は人間が行う。

失敗時: [3] を in-progress→blocked + failed に遷移し、issue にコメントで理由（どこで詰まったか）を残す。

注意

Edit / Write を使うのは [3] 実装工程のみ。[2] 設計工程には渡さない（protocol / レポート §7-4）。

worktree は PR マージ後に人間 or 後片付け手順で git worktree remove する。