issue-start
Skill16 starsChanged yesterdayApache-2.0View on GitHub
イシュー着手時に使用。worktreeで分離された開発環境を構築し、Issue本文にメタ情報を追記する
- Commits and pushes
2 other projects use a version of this.
Adopted by
Most recently taken up by
- albertomarturelo/siitheir own version, first seen Nov 1, 2026
- gihwan-dev/claude-code-guitheir own version, first seen Feb 8, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- albertomarturelo/sii★ 19same name
- gihwan-dev/claude-code-gui★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository46 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- llms.txtllms.txt
- baseline-precheckSkill
- grill-meSkill
- herdr-kaji-launchSkill
- i-dev-final-checkSkill
- i-doc-final-checkSkill
- i-doc-fixSkill
- i-doc-reviewSkill
- i-doc-updateSkill
- i-doc-verifySkill
- incident-cycleSkill
- incident-fixSkill
- incident-investigateSkill
- incident-reportSkill
- incident-reviewSkill
- incident-verifySkill
- i-prSkill
- issue-closeSkill
- issue-createSkill
- issue-designSkill
- issue-fix-codeSkill
- issue-fix-designSkill
- issue-fix-readySkill
- issue-implementSkill
- issue-review-codeSkill
- issue-review-designSkill
- issue-review-readySkill
- issue-small-change-executeSkill
- issue-small-change-reviewSkill
- issue-verify-codeSkill
- issue-verify-designSkill
- kaji-run-verifySkill
- pr-fixSkill
- pr-verifySkill
- releaseSkill
- release-starterSkill
- review-cycleSkill
- review-pollSkill
- reviewSkill
- review-starter-updateSkill
- run-watchedSkill
- series-createSkill
- update-starterSkill
- watch-triageSkill
The file
Files
Issue Start
イシュー対応を開始するためのworktreeをセットアップし、Issue本文にメタ情報を追記します。
本 skill は LLM agent を起動しない deterministic skill です。context 取得から worktree 作成・
symlink・Issue NOTE・報告コメント・verdict 出力までを、1 プロセスの Python entry
kaji_harness.scripts.issue_start(処理本体は kaji_harness/issue_start.py)が実行します
(Issue #569。複数の Bash 呼び出し間でシェル変数が失われる #560 と、手書き verdict の書式崩れ #551 の対策)。
起動経路は 2 系統あり、いずれも同じ entry main に合流します:
- workflow の
startstep: frontmatter のexec_scriptにより、harness が entry を subprocess 実行します(agent_runnerが headless / Herdr のどちらでも agent は起動しない)。 step 定義はskill: issue-startとon:だけを持ち、agent/model/effortを書きません。 - 手動: main checkout で
kaji issue start [issue_id]を 1 回実行します(下記「手動実行」)。
入力・副作用・verdict の正本は entry module であり、本ファイルの記述はその契約のミラーです。
いつ使うか
| タイミング | このスキルを使用 |
| コード/ドキュメント変更を伴うイシュー着手 | ✅ 必須 |
| 設計のみ(ファイル変更なし) | ⚠️ 任意 |
| 調査・リサーチのみ | ❌ 不要 |
重要: PRを作成する際やイシュー対応でコミットが必要な場合、git branch ではなくこのスキルを使用してください。
引数
$ARGUMENTS = <issue_id>issue_id(必須): Issue番号 (例: 247 /gh:153)。workflow ではKAJI_ISSUE_IDから取得する
第 2 引数(旧 prefix)は 廃止 されました。ブランチ prefix は
kaji issue context と同じ provider.resolve_issue_context() が返す branch_prefix
(type:* ラベル → chore fallback の優先順)から自動決定します。
kaji issue start に第 2 引数を渡すと usage error(exit 2)で何もせず終了します。
手動 /issue-start で第 2 引数が渡された場合は、コマンドを実行せず ABORT verdict を出して停止し、
廃止アナウンスをユーザに返してください。
命名規則
provider.resolve_issue_context()(kaji issue context と同じ関数)が返す branch_name /
worktree_dir をそのまま使います。
- ブランチ名:
<branch_prefix>/<issue_id>(例:fix/247) - ディレクトリ:
<repo_root>/../<worktree_prefix>-<branch_prefix>-<issue_id>(例:../kaji-fix-247)
手動実行
main checkout(worktree ではない)で次の 1 コマンドを実行し、stdout 末尾の verdict block を そのまま報告してください。途中で止まった場合も、原因を解消してから同じコマンドを再実行します。
kaji issue start [issue_id]処理内容(entry の契約)
正常時は次の順で実行します(現行の副作用・順序を維持):
- 事前検証(Git / Issue への書き込み前): context を 1 回取得し、workflow では runner が注入した
KAJI_WORKTREE_DIR/KAJI_BRANCH_NAME/KAJI_GIT_REMOTE/KAJI_DEFAULT_BRANCHとの一致を 検査する。Issue コメントを読み、既存の start PASS 報告を分類する(下記「再実行」) git fetch <git_remote> <default_branch>の後、FETCH_HEADとrefs/remotes/<git_remote>/<default_branch>の一致を確認する(fetch refspec が base を remote-tracking ref へ写さない設定で、古い ref から作ることを防ぐ)git worktree add --no-track -b <branch_name> <worktree_dir> <git_remote>/<default_branch>。 基点は fetch 直後の remote 側 default branch。ローカルの<default_branch>は基点にせず、更新もしない。--no-trackのため upstream は設定しない(/i-prのgit push -uで設定する)<worktree_dir>/.venv→<main checkout>/.venvの symlink(これによりmake checkが即座に実行可能)- main に
.kaji/config.local.toml(gitignored の overlay)がある場合のみ、<worktree_dir>/.kaji/config.local.toml→ main の overlay の symlink git worktree list --porcelainで<worktree_dir>が<branch_name>で登録されていることを再確認- Issue 本文先頭に NOTE(
build_worktree_note_bodyが生成する> [!NOTE]/ Worktree / Branch の 3 行 と空行 1 行) - 報告コメント(1 行目 marker
<!-- kaji-verdict: step=start status=PASS -->、表に Issue / ブランチ / ディレクトリ / 基点 / venv / config overlay / メタ情報、ローカル<default_branch>に未 push の commit がある場合はその件数の注意、次のステップ、クリーンアップ、末尾に verdict block)。 marker の契約は shared_skill_rules.md § verdict マーカー契約 - verdict: workflow では
KAJI_VERDICT_PATHへ pure YAML を原子的に書き、同じ内容を stdout の---VERDICT---block に出す(#568 の正規化・検証・直列化を通す)
git pull / reset / checkout / clean / branch -D / worktree remove は一切実行しません。
再実行(部分成功からの再開)
途中で止まった後に同じコマンドを再実行すると、次のように扱います。fetch と照合は毎回実行します。
| 状態 | 扱い |
worktree_dir 未登録・パス不在・branch 不在 | 新規作成 |
worktree_dir が branch_name で登録済み・ディレクトリ実在 | 検証して再利用(Git に書き込まない。利用者の commit / 未 commit 変更はそのまま) |
worktree_dir が別 branch / detached で登録済み | ABORT |
branch_name が別パスの worktree で checkout 済み | ABORT |
branch_name は存在するが worktree 未登録 | ABORT(既存 branch を自動で attach しない) |
worktree_dir が未登録だがパスが存在 | ABORT |
| 登録済みだがディレクトリ不在(prunable) | ABORT |
| symlink が既に期待どおり | そのまま |
| symlink の参照先が異なる / 実ファイル・ディレクトリがある | ABORT(上書き・削除しない) |
| 同一 NOTE が本文先頭にある | 追記しない |
再利用時の報告の「基点」は、作成時の基点ではなく、現在の <git_remote>/<default_branch> との
共通祖先(git merge-base)の短縮 SHA として表示し、表に「再利用」行を加えます。
報告コメントの重複判定: 1 行目 marker が step=start status=PASS(metadata の有無は問わない)の
コメントを候補とし、表の ブランチ 行と ディレクトリ 行の値(前後の空白と、値全体を囲む 1 組の
backtick を除く)で分類します。旧形式(agent が投稿した報告)も同じ規則で判定します。
| 既存の候補 | 扱い |
同じ branch_name と ../<worktree_dir の basename> の報告がある | 投稿しない |
同一報告が無く、ブランチ / ディレクトリ 行が欠落・矛盾する報告がある | 書き込み前に ABORT(重複しうるため) |
| 候補なし / 別の branch・ディレクトリの報告のみ | 1 件投稿する |
Verdict 出力
verdict は entry が出力します(agent は書きません)。
---VERDICT---
status: PASS
reason: |
Worktree 構築成功
evidence: |
fetch 直後の origin/main(abc1234)と FETCH_HEAD の一致を確認し、fix/247 を ../kaji-fix-247 に --no-track で作成
(以降、venv / config overlay / Issue NOTE / 報告コメントの扱い)
suggestion: |
---END_VERDICT---status の選択基準
| status | 条件 |
| PASS | worktree の作成または検証付き再利用、symlink、NOTE、報告(同一報告が既存なら省略)が完了 |
| ABORT | context 取得失敗、KAJI_* と context の不一致、識別不能な start PASS 報告、git fetch 失敗、<git_remote>/<default_branch> の未解決・FETCH_HEAD との不一致、worktree のパス / branch 不一致、symlink 衝突、Issue NOTE / 報告コメントの投稿失敗 / 第 2 引数(旧 prefix)が渡された |
ABORT の evidence には失敗した操作・コマンド・終了コード・stderr 末尾と「完了済みの副作用」を、
suggestion には再実行コマンド kaji issue start <issue_id> を書きます。ABORT のときは報告コメントを
投稿しません。別の base(ローカルの <default_branch> 等)へ fallback して続行することはありません。
start は自動 recovery の対象外(non_resumable_skill)のままです。workflow が ABORT / ERROR で
止まった場合は、上記の再実行で start を完了させてから、後続 step から手動で再開してください
(failure-recovery.md)。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

