jpskill.com
🛠️ 開発・MCP コミュニティ

implement-issue

GitHubのIssue番号とベースブランチが与えられた際に、関連する変更を端から端まで実装し、開発作業を効率的に進めるのを支援するSkill。

📜 元の英語説明(参考)

Use when given a GitHub issue number and base branch to implement end-to-end

🇯🇵 日本人クリエイター向け解説

一言でいうと

GitHubのIssue番号とベースブランチが与えられた際に、関連する変更を端から端まで実装し、開発作業を効率的に進めるのを支援するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o implement-issue.zip https://jpskill.com/download/8585.zip && unzip -o implement-issue.zip && rm implement-issue.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/8585.zip -OutFile "$d\implement-issue.zip"; Expand-Archive "$d\implement-issue.zip" -DestinationPath $d -Force; ri "$d\implement-issue.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して implement-issue.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → implement-issue フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Issue の実装

オーケストレータスクリプトによるエンドツーエンドの issue 実装。

開始時のアナウンス: "implement-issue を使用して #$ISSUE に対して $BRANCH のオーケストレータを実行します"

引数:

  • $1 — GitHub issue 番号 (必須)
  • $2 — ベースブランチ名 (必須)

起動

オーケストレータを即座に起動します:

.claude/scripts/implement-issue-orchestrator.sh \
  --issue $ISSUE_NUMBER \
  --branch $BASE_BRANCH

または、明示的なエージェントのオーバーライドを使用します:

.claude/scripts/implement-issue-orchestrator.sh \
  --issue $ISSUE_NUMBER \
  --branch $BASE_BRANCH \
  --agent patch-engineer

モニタリング

status.json を介して進捗状況を確認します:

jq . status.json

ライブで監視します:

watch -n 5 'jq -c "{state,stage:.current_stage,task:.current_task,quality:.quality_iterations}" status.json'

ステージ

Stage Agent Description
setup default fetch, worktree, research, evaluate, plan
implement per-task plan からの各タスクを実行
task-review spec-reviewer タスクが目標を達成したか検証
fix per-task レビューの指摘事項に対応
simplify cdd-code-simplifier コードを整理
test bats-test-validator テストスイートを実行 (shellcheck + BATS)
lint default shellcheck と actionlint を実行
review code-reviewer 内部コードレビュー
pr default PR を作成/更新
spec-review spec-reviewer PR が issue の目標を達成したか検証
code-review code-reviewer 最終的なコード品質チェック
complete default サマリーを投稿

スキーマ

.claude/scripts/schemas/implement-issue-*.json にあります

ロギング

ログは logs/implement-issue/issue-N-timestamp/ に書き込まれます:

  • orchestrator.log — メインログ
  • stages/ — ステージごとの Claude の出力
  • context/ — 解析された出力 (tasks.json など)
  • status.json — 最終的なステータスのスナップショット

終了コード

Code Meaning
0 成功、PR が作成され承認されました
1 ステージ中のエラー
2 最大イテレーション回数を超過
3 設定/引数のエラー

エージェントの選択

タスクは issue の種類に基づいて専門のエージェントに割り当てられます:

Agent Use For
patch-engineer build.sh の Minified JS パッチ、sed/regex パターン
packaging-specialist .deb, .rpm, AppImage パッケージング、control ファイル
electron-linux-specialist BrowserWindow, Wayland/X11, DBus tray, ネイティブテーマ
ci-workflow-architect GitHub Actions ワークフロー、リリース自動化
bash-script-craftsman シェルスクリプト、ランチャー、ビルドシステム

統合

handle-issues から batch-orchestrator.sh 経由で呼び出されます。

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Implement Issue

End-to-end issue implementation via orchestrator script.

Announce at start: "Using implement-issue to run orchestrator for #$ISSUE against $BRANCH"

Arguments:

  • $1 — GitHub issue number (required)
  • $2 — Base branch name (required)

Invocation

Immediately launch the orchestrator:

.claude/scripts/implement-issue-orchestrator.sh \
  --issue $ISSUE_NUMBER \
  --branch $BASE_BRANCH

Or with explicit agent override:

.claude/scripts/implement-issue-orchestrator.sh \
  --issue $ISSUE_NUMBER \
  --branch $BASE_BRANCH \
  --agent patch-engineer

Monitoring

Check progress via status.json:

jq . status.json

Watch live:

watch -n 5 'jq -c "{state,stage:.current_stage,task:.current_task,quality:.quality_iterations}" status.json'

Stages

Stage Agent Description
setup default fetch, worktree, research, evaluate, plan
implement per-task execute each task from plan
task-review spec-reviewer verify task achieved goal
fix per-task address review findings
simplify cdd-code-simplifier clean up code
test bats-test-validator run test suite (shellcheck + BATS)
lint default run shellcheck and actionlint
review code-reviewer internal code review
pr default create/update PR
spec-review spec-reviewer verify PR achieves issue goals
code-review code-reviewer final code quality check
complete default post summary

Schemas

Located in .claude/scripts/schemas/implement-issue-*.json

Logging

Logs written to logs/implement-issue/issue-N-timestamp/:

  • orchestrator.log — main log
  • stages/ — per-stage Claude output
  • context/ — parsed outputs (tasks.json, etc.)
  • status.json — final status snapshot

Exit Codes

Code Meaning
0 Success, PR created and approved
1 Error during a stage
2 Max iterations exceeded
3 Configuration/argument error

Agent Selection

Tasks are assigned to specialist agents based on the issue type:

Agent Use For
patch-engineer Minified JS patches in build.sh, sed/regex patterns
packaging-specialist .deb, .rpm, AppImage packaging, control files
electron-linux-specialist BrowserWindow, Wayland/X11, DBus tray, native theme
ci-workflow-architect GitHub Actions workflows, release automation
bash-script-craftsman Shell scripts, launcher, build system

Integration

Called by handle-issues via batch-orchestrator.sh.