issue-start

description	イシュー着手時に使用。worktreeで分離された開発環境を構築し、Issue本文にメタ情報を追記する
name	issue-start

Issue Start

イシュー対応を開始するためのworktreeをセットアップし、Issue本文にメタ情報を追記します。

いつ使うか

タイミング	このスキルを使用
コード/ドキュメント変更を伴うイシュー着手	✅ 必須
設計のみ（ファイル変更なし）	⚠️ 任意
調査・リサーチのみ	❌ 不要

重要: PRを作成する際やイシュー対応でコミットが必要な場合、git branch ではなくこのスキルを使用してください。

引数

$ARGUMENTS = <issue_id>

• issue_id (必須): Issue番号 (例: 247 / local-pc1-3 / gh:153)

第 2 引数は 廃止 されています。ブランチ prefix は uv run kaji issue context が返す branch_prefix（frontmatter branch_prefix → type:* ラベル → chore fallback の優先順）から自動決定します。

命名規則

uv run kaji issue context <issue_id> の出力（kaji 側の解決結果が正本）から 取得する branch_name / worktree_dir をそのまま使います。

• ブランチ名: <branch_prefix>/<issue_id> (例: fix/247)
• ディレクトリ: <repo_root>/../kaji-<branch_prefix>-<issue_id> (例: ../kaji-fix-247)

実行手順

Step 0: 引数の検査

$ARGUMENTS から issue_id を取得してください。第 2 引数（旧 prefix）が 渡された場合は ABORT verdict を出して停止し、廃止アナウンスをユーザに返してください （label / frontmatter からの自動導出に一本化されているため）。

Step 1: context 正本の取得

system jq バイナリ依存を持ち込まないため、uv run kaji issue context の -q (Python jq) を使う:

PREFIX=$(uv run kaji issue context [issue_id] -q '.branch_prefix')
BRANCH=$(uv run kaji issue context [issue_id] -q '.branch_name')
WT=$(uv run kaji issue context [issue_id] -q '.worktree_dir')

worktree_dir は絶対パスで返ります。以降の手順では上記 3 変数を使います。

Step 2: ブランチとWorktreeの作成

メインリポジトリのルートから実行:

MAIN_REPO=$(git rev-parse --show-toplevel)
git worktree add -b "$BRANCH" "$WT" main

Step 2.5: venv シンボリックリンク作成

main プロジェクトの .venv へのシンボリックリンクを作成:

ln -s "$MAIN_REPO/.venv" "$WT/.venv"

これにより make check が即座に実行可能になります。

Step 2.6: provider overlay (.kaji/config.local.toml) シンボリックリンク作成

.kaji/config.local.toml は gitignored のため git worktree add では worktree に転写されない。 overlay 不在の worktree では kaji CLI が .kaji/config.toml の provider.type=github 既定値で動き、 local-* / gl:N 形式 ID が拒否される（agent が worktree 配下で uv run kaji issue comment を 叩けず、レビュー判定の Issue 記録が欠落する原因）。

main の overlay が存在する場合のみ、worktree の .kaji/ にシンボリックリンクで共有する:

if [ -f "$MAIN_REPO/.kaji/config.local.toml" ]; then
  ln -sf "$MAIN_REPO/.kaji/config.local.toml" "$WT/.kaji/config.local.toml"
fi

-f で再作成を許容（既存 symlink を上書き）。.gitignore に登録済みのパスなので worktree 側 git status には現れない。provider=github 運用では main にも overlay が 無いため何も起きない（既存挙動と等価）。

Step 3: Worktreeの確認

git worktree list

ワークツリーが正しく作成されたことを確認してください。

Step 4: Issue本文にメタ情報を追記

Issue本文の先頭にWorktree情報を追記します。本文合成は kaji 内部の決定的な 経路が担うため、エージェントは単一トークン引数を 3 つ渡すだけでよい （multi-line 本文を自前で組み立てない）:

WT_BASENAME=$(basename "$WT")
uv run kaji issue prepend-note [issue_id] --worktree "$WT_BASENAME" --branch "$BRANCH" --commit

uv run kaji issue prepend-note は現在の Issue 本文を取得し、> [!NOTE] メタブロックと 本文の間に 空行ちょうど 1 行 を保証して合成・更新する。blank line がエージェント ではなく kaji 側の文字列リテラルに固定されるため、どのモデルでも blockquote と本文 heading が密着しない。--commit は local provider で issue.md を atomic commit する（github では silent に無視）。

Step 5: セットアップ完了報告

以下の形式で報告してください（$PREFIX / $BRANCH / $WT の値で埋めること）:

## Worktree セットアップ完了

| 項目 | 値 |
|------|-----|
| Issue | [issue_ref] |
| ブランチ | $BRANCH |
| ディレクトリ | ../$(basename "$WT") |
| 基点ブランチ | main |
| venv | シンボリックリンク作成済み |
| provider overlay | シンボリックリンク作成済み / 不要（main に未配置） |
| メタ情報 | Issue本文に追記済み |

### 次のステップ

このタスクに関する今後のコマンドは、すべて以下のディレクトリ内で実行してください:

cd ../$(basename "$WT")

### クリーンアップ（作業完了後）

作業が完了したら `/issue-close [issue_id]` を実行してください。

Verdict 出力

実行完了後、以下の形式で verdict を出力すること:

---VERDICT---
status: PASS
reason: |
  Worktree 構築成功
evidence: |
  worktree 作成、venv symlink 済み
suggestion: |
---END_VERDICT---

重要: verdict は stdout にそのまま出力 すること。Issue コメントや Issue 本文更新とは別に、最終的な verdict ブロックは stdout に残す。

status の選択基準

status	条件
PASS	Worktree 構築成功
ABORT	構築失敗 / 第 2 引数（旧 prefix）が渡された