Issue を作成し、ブランチと worktree を準備して新規作業を開始する。ユーザーが新しいタスクや機能の作業を始めたいときに使用する。
.github/settings.json からプロジェクト設定を読み取って使用する。
ユーザーが作業内容を説明する。以下を判断:
<type>: <説明> 形式)settings.branch.format に従う).github/settings.json を読み取り、以下の値を使用する:
issueTracker.provider — Issue トラッカー種別issueTracker.mcpServer — MCP サーバー名issueTracker.team — チーム名issueTracker.projectId — プロジェクト IDissueTracker.prefix — Issue プレフィックス(以降 <prefix> と表記)branch.user — ブランチのユーザー名(以降 <user> と表記)branch.format — ブランチ名のフォーマットissueTracker.provider が "none" の場合はこのステップをスキップする。
provider: "linear")mcp_<issueTracker.mcpServer>_create_issue:
title: "<type>: <説明>"
description: "## 概要\n<作業内容>\n\n## タスク\n- [ ] <具体的なタスク>"
teamId: "<issueTracker.team>"
projectId: "<issueTracker.projectId>"
state: "In Progress"
parentId: "<親IssueのID(ある場合)>"
返却された以下の値を記録する:
id(UUID、例: 17ac3f2d-062a-...)— cleanup 時の Issue 更新に必要identifier(例: <prefix>-20)— コミットメッセージ・ブランチ名に使用provider: "github")mcp_io_github_git_issue_write:
owner: "<github.owner>"
repo: "<github.repo>"
title: "<type>: <説明>"
body: "## 概要\n<作業内容>\n\n## タスク\n- [ ] <具体的なタスク>"
返却された以下の値を記録する:
number(例: 20)— コミットメッセージ・ブランチ名に使用(#20 形式)#<number> として扱うbranch.format に従ってブランチ名を組み立てる:
# Issue トラッカー利用時:
git branch <user>/<prefix>-<番号>-<type>-<説明>
# Issue トラッカー未使用時(provider: "none"):
git branch <user>/<type>-<説明>
git worktree add .worktrees/<ブランチ名(user/ を除いた部分)> <フルブランチ名>
ブランチ/worktree が既に存在する場合:
git branchやgit worktree addがエラーになったら、git branch -l/git worktree listで既存の状態を確認し、不要なら削除してからリトライする。
worktree ディレクトリ内に .gitignore が存在するか確認する:
test -f .gitignore
.gitignore が存在しない場合:
generate-gitignore スキルを使って .gitignore を生成するsettings.json の project.language を元にテンプレートを自動決定する.gitignore が既に存在する場合:
generate-gitignore スキルの「マージ」手順を参照)Why: 前回の検証で
__pycache__/や.coverageが Git 管理対象になりかけた。 Feature 開始時に .gitignore を確保することで、不要ファイルのコミットを防止する。
worktree ディレクトリ内でファイルの変更を行う。
親ブランチが既にある場合:
# 親の worktree に移動
cd .worktrees/<親ブランチ名>
# サブブランチを作成(親から分岐)
git branch <user>/<prefix>-<番号>-<type>-<説明>
# メインディレクトリに戻る
cd ../..
# サブ worktree を作成
git worktree add .worktrees/<prefix>-<番号>-<type>-<説明> <user>/<prefix>-<番号>-<type>-<説明>