開発ワークフロー自動化 - シングル/マルチエージェント/Agent Team の開発フローを提供(Issue/PR 連携・git・計画書はフラグ不要で自動判断)

version
6.0.0
GitHub stars
7

Install

/plugin install shiiman-workflow@shiiman-claude-code-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add shiiman/claude-code-plugins.

Contents

Discovered from source

Skills 4

Agent Team Flow

Agent Team(tmux + TeamCreate)で並列実装する開発フロー。 workflow-multi の MCP 依存部分を Agent Team 実行に置き換えたもの。

フラグは不要。タスクを伝えれば、git の状態・発話内容から実行条件を自動判断し、曖昧な点だけ確認する。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-workflow:agent-team - Agent Team 開発フロー

概要:
  Agent Team(tmux + TeamCreate)で並列実装する。
  実装条件(Issue/PR・計画書・ブランチ・git・レビュー)はフラグ不要で自動判断し、
  曖昧な点だけ AskUserQuestion で確認する。

使用方法:
  /shiiman-workflow:agent-team [タスク説明]
  /shiiman-workflow:agent-team --help

オプション:
  --help  このヘルプを表示

例:
  /shiiman-workflow:agent-team                          # 既存計画書から並列実装(あれば)
  /shiiman-workflow:agent-team "API を並列リファクタ"    # タスク説明から並列実装
  /shiiman-workflow:agent-team "認証を実装して PR まで"  # 並列実装・コミット・通常の push・PR 作成
  /shiiman-workflow:agent-team --help                   # ヘルプを表示

指定の伝え方(フラグの代わり):
  - 「計画を立ててから」  → plan mode で計画書を作成してから実装
  - 「ブランチで」        → worktree ではなくブランチを作成
  - 「PR まで」           → コミット・通常の push・PR 作成まで実施
  - 「Issue と PR まで」   → Issue 作成も含めて実施
  - 「コミットだけ」      → 検証後にコミットし、push・Issue・PR は作成しない
  - 「レビュー不要」      → 完了報告前の /shiiman-common:review をスキップ

前提条件

  • CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 が設定済み(必須)
  • claude / tmux / gh コマンドが利用可能
  • gh auth status が成功する(GitHub CLI 認証済み)
  • macOS で cmux / Ghostty / iTerm2 を推奨(未導入時は Terminal.app / 現在端末へフォールバック)

起動時の自動判断(フラグの代わり)

ユーザーにフラグを入力させない。以下を順に決定する。引数・発話に明示があればそれを最優先し、明示がなければ自動判断、それでも曖昧な項目だけ後述の手順で確認する。

項目既定判断ルール
git / no-git自動git rev-parse --is-inside-work-tree 成功なら git。失敗なら no-git(ブランチ作成を省略)
worktree / branchworktree「ブランチで」「worktree なし」等の発話があれば branch
計画書の扱い後述の判定「計画を立てて」「plan で」→ plan mode。引数にタスク説明あり → 直接。なし → 既存計画書を探索
レビュー実行する「レビュー不要」「レビューなし」等の発話があればスキップ

許可された完了範囲

現在の依頼と既存の許可から、操作ごとに実行範囲を判断する。

  • 実装だけの依頼: 実装・レビュー・検証を行い、コミットや Issue・PR を作るかの追加質問はせず終了する。
  • コミットだけの依頼: チェック後に対象変更をコミットする。push や Issue・PR 作成は行わない。
  • PR 作成の依頼: 必要な実装・検証・対象変更のコミット・通常の feature branch push を完了して PR を作成する。Issue は依頼されているか、許可済みのワークフローで必要な場合だけ作成する。
  • Issue 作成の依頼: 依頼された Issue と明示された後続操作だけを行う。必要に応じて確認済みの既存 Issue を参照する。
  • 「push しない」などの明示的な制約を優先する。範囲を黙って広げず、具体的な阻害要因を報告する。

許可済みの操作に --no-confirm、計画承認、完了時の再承認を要求しない。後続の仕上げ手順も個別に許可された操作だけを実行し、依頼されていない手順は省略する。重要な範囲変更、破壊的操作、高影響操作が発生する場合は許可を再確認する。

git の状態判定

git rev-parse --is-inside-work-tree >/dev/null 2>&1
  • 成功 → git モード(ブランチ/worktree を作成)
  • 失敗 → no-git モード(ブランチ作成を省略し、実装とサマリー出力のみ)

計画書の扱いの判定

  1. 「計画を立ててから」等の依頼がある → 計画作成: 計画を説明してから依頼された実装を進める。承認待ちを明示された場合だけ EnterPlanMode で承認を待つ
  2. 引数にタスク説明がある → 直接実行: タスク説明をそのまま実装の指針にする
  3. 引数なし → 既存計画書: 最新の計画書を読み込む(ls -t ~/.claude/plans/*.md | head -1)。見つからなければタスク説明を促して終了

session 名 / slug ルール

  • 確認済みの関連 Issue がある場合 → agent-team-issue-{issue番号}
  • 関連 Issue がない場合 → agent-team-{slug}(slug はタスク内容から英語キーワード。生成できなければ no-git-task)

Phase 1: セットアップと Agent Team 起動

ステップ A: 許可されている場合だけ Issue を作成

Skill ツールで shiiman-github:issue-create --no-confirm を呼び出す。本文は「## 概要 / ## タスク一覧(チェックボックス)/ ## 完了条件」で構成。作成された Issue 番号を session 名と後続に使う。

ステップ 1: ブランチ / worktree 作成

git モードのみ実施(no-git はスキップ)。

  • worktree(既定): Skill ツールで shiiman-github:worktree-create を呼び出す
  • ブランチ: Skill ツールで shiiman-github:branch-create を呼び出す
  • 確認済みの関連 Issue がある場合だけ Issue 番号を渡す。なければタスクに基づく名前を使う。

Note: shiiman-github:worktree-create は mise trust を自動実行する(mise.toml がなければスキップ)。

ステップ 2: 共通スクリプトで tmux セッションを起動

SESSION="{session名}"
REPO_ROOT="$(pwd)"
OPEN_TMUX_SCRIPT="${CLAUDE_PLUGIN_ROOT}/scripts/open_tmux_terminal.sh"
CLEANUP_SCRIPT="${CLAUDE_PLUGIN_ROOT}/scripts/cleanup_tmux_terminal.sh"
TERMINAL_STATE_FILE="$(mktemp)"

bash "$OPEN_TMUX_SCRIPT" \
  --session "$SESSION" \
  --repo-root "$REPO_ROOT" \
  --terminal auto \
  --state-file "$TERMINAL_STATE_FILE"

ステップ 3: tmux 内で Claude Code を起動

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude --dangerously-skip-permissions --teammate-mode tmux

ステップ 4: 送信スクリプトを設定

TARGET="$(tmux display-message -p -t "$SESSION" '#{session_name}:#{window_index}.#{pane_index}' 2>/dev/null || true)"
if [ -z "$TARGET" ]; then
  TARGET="$(tmux list-panes -t "$SESSION" -F '#{session_name}:#{window_index}.#{pane_index}' | head -n 1)"
fi
if [ -z "$TARGET" ]; then
  echo "ERROR: tmux target を解決できませんでした (session: $SESSION)" >&2
  exit 1
fi

PANE_CMD="$(tmux display-message -p -t "$TARGET" '#{pane_current_command}' 2>/dev/null || true)"
if [ "$PANE_CMD" != "claude" ]; then
  echo "WARN: target pane is not claude (target: $TARGET, current: ${PANE_CMD:-unknown})"
  echo "必要に応じて Step 3 の claude 起動をやり直してください。"
fi

SEND_SCRIPT="${CLAUDE_PLUGIN_ROOT}/scripts/send_claude_tmux_message.sh"
  • TARGET は固定値(0.0)を使わず tmux 実値で解決する(base-index / pane-base-index が 1 の環境でも動作)

ステップ 5: 計画書を送信して Agent Team 実行を開始

送信スクリプトは、本文貼り付け後に 2 通目の Enter を自動送信する。

REPO_ROOT="$(pwd)"
COMMIT_NOTICE="コミット(git add / commit / push)は行わないでください。"
REVIEW_NOTICE=""
if [ "{レビュー実行}" = "true" ]; then
  REVIEW_NOTICE="/shiiman-common:review を実行して指摘内容をすべて自動修正し、"
fi
ISSUE_NOTICE=""
if [ "{Issue連携あり}" = "true" ]; then
  ISSUE_NOTICE="Issue #{issue番号} の対応として、"
fi

# 計画書をファイルに保存
TS="$(date +%Y%m%d-%H%M%S)"
PLAN_FILE="${REPO_ROOT}/.claude/tmp/${TS}-${SESSION}-plan.md"
mkdir -p "${REPO_ROOT}/.claude/tmp"
cat >| "$PLAN_FILE" <<EOF
{plan_or_task}
EOF

# パス参照のみを送信
REQUEST_FILE="$(mktemp)"
cat >| "$REQUEST_FILE" <<EOF
TeamCreate ツールを使って Agent Team を作成し、${ISSUE_NOTICE}計画書に従って実装を開始してください。
並列実行には必ず TeamCreate ツールを使用してください(Agent ツールではなく TeamCreate です)。
報告書などのアウトプットがある場合は "${REPO_ROOT}/.claude/tmp" に出力してください。
${COMMIT_NOTICE}

計画書ファイル: ${PLAN_FILE}
Read ツールで上記ファイルを読み込んでから実装を進めてください。

実装完了後、${REVIEW_NOTICE}以下を報告してください。
- 実装サマリー
- 変更ファイル
- テスト結果
- 残課題

完了時は以下コマンドを実行して macOS 通知を送ってください。
osascript -e 'display notification "Agent Team 実装が完了しました" with title "workflow-agent-team" sound name "default"'
EOF
bash "$SEND_SCRIPT" --target "$TARGET" --file "$REQUEST_FILE"
rm -f "$REQUEST_FILE"

ステップ 6: macOS 通知を待機

完了通知が届く想定。進捗確認が必要なら tmux 出力を確認:

CAPTURE_TARGET="$(tmux display-message -p -t "$SESSION" '#{session_name}:#{window_index}.#{pane_index}' 2>/dev/null || tmux list-panes -t "$SESSION" -F '#{session_name}:#{window_index}.#{pane_index}' | head -n 1)"
tmux capture-pane -pt "$CAPTURE_TARGET" | tail -n 120

Phase 2-4: Agent Team の自律実行

Agent Team が計画書を分解して実装を進める。呼び出し元は利用可能な状態確認や tmux 出力で完了を監視し、完了報告を確認したらユーザーの追加指示を待たず Phase 5 へ進む。

Phase 5: 結果確認と許可範囲内の続行

ステップ 1: 変更内容を確認

git モード:

git status --short --branch
git diff
git diff --cached

no-git モード: Agent Team の最終報告(実装サマリー・変更ファイル・テスト結果・残課題)を確認。

ステップ 2: 結果と許可の確認

実際の差分と検証結果を確認し、範囲内の対応すべき指摘を修正する。実装と後続操作が許可済みなら自動で続行する。重要な未解決の判断や未許可の影響についてだけ質問し、形式的な「OK」を待たない。

クリーンアップツールが削除する対象を確認する。今回のタスクが所有するエージェントと一時リソースだけを片付け、worktree・変更・有用なユーザーの作業は保持する。ツールで範囲を保証できなければ削除せず報告する。

修正が必要な場合は、以下の再送手順で必要な修正だけを実行する。問題がなければ再承認を待たず後続処理へ進む。

NG(修正依頼)の場合

修正内容を変数に入れて送信スクリプトで再送({レビュー実行} / COMMIT_NOTICE はステップ 5 と同じ規則):

USER_FEEDBACK="{user_feedback}"
TS="$(date +%Y%m%d-%H%M%S)"
FIX_REQUEST_FILE="${REPO_ROOT}/.claude/tmp/${TS}-fix-request.md"
mkdir -p "${REPO_ROOT}/.claude/tmp"
cat >| "$FIX_REQUEST_FILE" <<EOF
${USER_FEEDBACK}
EOF

FIX_FILE="$(mktemp)"
cat >| "$FIX_FILE" <<EOF
TeamCreate ツールを使って Agent Team を作成し、修正指示に従って実装を開始してください。
並列実行には必ず TeamCreate ツールを使用してください(Agent ツールではなく TeamCreate です)。
${COMMIT_NOTICE}

修正依頼ファイル: ${FIX_REQUEST_FILE}
Read ツールで上記ファイルを読み込んでから修正を進めてください。

上記を反映し、${REVIEW_NOTICE}実装サマリー・変更ファイル・テスト結果・残課題を再報告してください。
完了時は osascript で macOS 通知を送ってください。
EOF
bash "$SEND_SCRIPT" --target "$TARGET" --file "$FIX_FILE"
rm -f "$FIX_FILE"

→ Phase 2-4 に戻って再実行。

保留の場合

tmux セッションを維持して待機。明示的な再開指示が来るまでクリーンアップしない。

検証完了後の処理

  1. 今回新規に作成し所有していると確認できた tmux session・window だけをクリーンアップする。既存 session への attach や所有が不明な場合は、以下の削除コマンドを実行せず保持して報告する:

    bash "$CLEANUP_SCRIPT" --session "$SESSION" --state-file "$TERMINAL_STATE_FILE"
    rm -f "$TERMINAL_STATE_FILE"
    
  2. セキュリティチェック: 機密ファイル(.env* / *.pem / credentials.json)を検出したら警告

    git status   # git モード
    find . -maxdepth 3 \( -name ".env*" -o -name "*.pem" -o -name "credentials.json" \)  # no-git モード
    
  3. 「仕上げ」へ進む

仕上げ

許可された仕上げ操作

  1. 更新が許可された Issue のうち、実際に完了したタスクだけをチェックする。未完了タスクを完了にしない。
  2. コミット: shiiman-git:add-commit スキルのワークフローに従い、--no-confirm オプションでコミットする
  3. push または PR 作成が許可されていれば、remote・送信先・対象コミットを確認して実際の feature branch を通常の push で公開する。この許可だけで force-push、デフォルトブランチへの push、無関係な作業の公開は行わない。
  4. PR 作成: shiiman-github:pr-create スキルのワークフローに従い、--no-confirm オプションで PR を作成する。日本語で概要・並列タスクの結果・検証結果を記載する。Closes #N は確認済みの関連 Issue がある場合だけ含め、なければ Issue 欄を省略する。
  5. 実際の変更・チェック・完了した操作を報告する。Issue・PR の番号と URL は存在する場合だけ含め、未実行の操作を完了と主張しない。

Issue/PR 連携なし(軽量)

実装だけの依頼では、変更と検証結果を報告して終了し、コミット・push・Issue・PR 作成は行わない。コミットだけの明示的な依頼では、検証して対象変更をコミットし、結果を報告する。任意の後続操作を追加で質問しない。

## 実装完了

### 作成されたブランチ / worktree(git モード時のみ)
- {ブランチ名} / パス: {worktree のパス}(worktree モード時のみ)

### 推奨コミットメッセージ
{リポジトリとグローバル指示に従う Conventional Commits メッセージ}

### 検証結果
{実行したチェック・結果・残課題}

### worktree クリーンアップ(worktree モード時のみ)
PR マージ後、`/shiiman-git:worktree` で gtr rm または gtr clean を実行してください。

失敗時の対応

  • gh 認証失敗: gh auth login 実施後に再開
  • claude / tmux 未インストール: 導入後に再実行
  • Agent Team 側で部分失敗: 失敗タスクのみを再指示してループ

重要な注意事項

  • ✅ ユーザーにフラグを入力させない(git・worktree/branch・計画書・レビュー・Issue/PR を自動判断、曖昧なら確認)
  • ✅ 並列実行には必ず TeamCreate ツールを使う(Agent ツールではない)
  • タスク所有の一時リソースだけを片付け、有用な作業や worktree を保持する。形式的な完了承認は求めない。
  • ✅ コミットメッセージは .claude/settings.json の設定に従う(なければ Conventional Commits)
  • コミット・push・Issue・PR は操作ごとに許可された範囲だけを実行する。

Issue Branch PR Create(Backward フロー)

既存の変更内容から Issue → ブランチ → コミット → push → PR を作成する Backward フロー。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-workflow:issue-branch-pr-create - 既存変更から Issue・PR を作成する Backward フロー

概要:
  ワーキングツリーの変更やコミット済み未プッシュの変更から
  Issue → ブランチ/worktree → コミット → push → PR を自動作成する。

使用方法:
  /shiiman-workflow:issue-branch-pr-create
  /shiiman-workflow:issue-branch-pr-create --help

オプション:
  --help  このヘルプを表示

例:
  /shiiman-workflow:issue-branch-pr-create         # 既存変更から Issue・PR を作成(既定はブランチ)
  /shiiman-workflow:issue-branch-pr-create --help  # ヘルプを表示

指定の伝え方(フラグの代わり):
  - 「worktree で」  → ブランチではなく worktree を作成(既存変更は stash 経由で移動)

フロー概要

既存変更 → 確認 → Issue 作成 → ブランチ/worktree 作成 → コミット → push → PR 作成

状態分岐テーブル

ブランチ変更状態IssueBranchCommitPushPR
default未コミットあり実行実行実行実行実行
defaultコミット済み未push実行実行スキップ実行実行
feature未コミットあり実行スキップ実行実行実行
featureコミット済み未push実行スキップスキップ実行実行
any変更なしエラー終了----

実行フロー

ステップ 1: 変更確認

Bash で現在の変更状態を確認する。

git status
git diff
git diff --cached

未プッシュコミットの確認:

git log @{u}..HEAD --oneline 2>/dev/null || git log origin/$(git rev-parse --abbrev-ref HEAD)..HEAD --oneline 2>/dev/null

判定ロジック:

  1. ステージング済み変更・未ステージング変更・未プッシュコミットのいずれもない場合 → エラー終了:
## エラー: 変更がありません

コミット対象の変更が見つかりませんでした。
変更を加えてから再度実行してください。
  1. デフォルトブランチ(main/master)か feature ブランチかを判定:
DEFAULT_BRANCH="$(gh repo view --json defaultBranchRef -q '.defaultBranchRef.name')"
CURRENT_BRANCH="$(git rev-parse --abbrev-ref HEAD)"
  • CURRENT_BRANCH が DEFAULT_BRANCH と一致 → デフォルトブランチ上
  • それ以外 → feature ブランチ上
  1. 未コミット変更があるか、コミット済み未プッシュのみかを判定

ステップ 2: Issue 作成

Skill ツールで Issue を作成する。変更内容のサマリーを引数に渡す。

Skill: shiiman-github:issue-create
Args: --no-confirm {変更内容のサマリー}

作成された Issue 番号を記録する。

ステップ 3: ブランチ / worktree 作成

デフォルトブランチ上の場合のみ実行。feature ブランチ上ならスキップ。

既定はブランチ。発話に「worktree で」等があれば worktree を作成する。

ブランチ(既定):

Skill: shiiman-github:branch-create
Args: {issue番号}

worktree(「worktree で」と指示された場合):

⚠️ worktree は別ディレクトリに作成されるため、既存の未コミット変更の移動が必要です。 以下の手順で変更を移動する:

  1. 元ディレクトリで変更を stash する
git stash push -m "worktree migration: {issue番号}"
  1. worktree を作成する
Skill: shiiman-github:worktree-create
Args: {issue番号}
  1. worktree ディレクトリで stash を適用する
git stash pop

stash pop が失敗した場合(コンフリクト等):

  • git stash pop がコンフリクトした場合、手動でコンフリクトを解消する
  • 元の変更は git stash list で確認可能(git stash pop 失敗時は stash は残る)
  • 復旧が困難な場合は git stash pop --abort 後、元ディレクトリに戻り git stash pop で変更を復元し、--worktree なしでやり直す

ステップ 4: コミット

未コミット変更がある場合のみ実行。コミット済みならスキップ。

Skill ツールでコミットを実行する。

Skill: shiiman-git:add-commit
Args: --no-confirm

ステップ 5: 許可された feature branch の push

この Issue から PR までのフロー全体の明示的な依頼には、Issue・branch・コミット・通常の push・PR 作成を含む。remote・対象 feature branch・送信対象のコミットを確認して git push -u origin {branch} を実行する。この許可だけで force-push、デフォルトブランチへの push、無関係な変更の送信は行わない。

「push しない」と明示されている場合はそれを守り、未公開コミットのため PR 作成を完了できないことを報告する。push できたものとして続行したり PR 作成済みと主張したりしない。既存の許可で十分であり、--no-confirm は任意の互換オプションで、指定自体が許可を与えるものではない。

ステップ 6: PR 作成

Skill ツールで PR を作成する。

Skill: shiiman-github:pr-create
Args: --no-confirm

ステップ 7: 完了報告

## Backward フロー完了

### 作成された Issue
- #{issue番号}: {タイトル}

### ブランチ
- {ブランチ名}

### 作成された PR
- PR #{pr番号}: {タイトル}
- URL: {pr_url}

PR がマージされると Issue #{issue番号} は自動的にクローズされます。

### worktree クリーンアップ(worktree 作成時のみ)

PR マージ後、不要になった worktree を削除してください:
`/shiiman-git:worktree` で gtr rm または gtr clean を実行

重要な注意事項

  • 許可された PR 作成フローに必要な通常の feature branch push を実行する。
  • ✅ 変更がない場合はエラー終了する
  • ✅ デフォルトブランチ上の場合のみブランチを作成する
  • ✅ 未コミット変更がある場合のみコミットを実行する
  • ✅ Issue 作成・コミット・PR 作成は Skill ツール経由で実行する
  • ❌ 変更がないまま Issue や PR を作成しない
  • 既存の許可がある操作は再確認せず、force-push・デフォルトブランチへの push・無関係な変更の公開には許可を広げない。

Multi Flow

multi-agent-mcp(Owner/Admin/Worker)で並列実装する開発フロー。

フラグは不要。タスクを伝えれば、git の状態・発話内容から実行条件を自動判断し、曖昧な点だけ確認する。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

shiiman-workflow:multi - マルチエージェント開発フロー

概要:
  multi-agent-mcp(Owner/Admin/Worker)で並列実装する。
  実装条件(Issue/PR・計画書・ブランチ・git)はフラグ不要で自動判断し、
  曖昧な点だけ確認する。

使用方法:
  shiiman-workflow:multi [タスク説明]
  shiiman-workflow:multi --help

オプション:
  --help  このヘルプを表示

例:
  shiiman-workflow:multi                            # 既存計画書から並列実装(あれば)
  shiiman-workflow:multi "API を並列リファクタ"      # タスク説明から並列実装
  shiiman-workflow:multi "認証を実装して PR まで"    # 並列実装・コミット・push・PR 作成
  shiiman-workflow:multi --help                     # ヘルプを表示

指定の伝え方(フラグの代わり):
  - 「計画を立ててから」  → 計画書を作成してから実装
  - 「ブランチで」        → worktree ではなくブランチを作成
  - 「PR まで」           → コミット・通常の push・PR 作成まで実施
  - 「Issue と PR まで」   → Issue 作成も含めて実施
  - 「コミットだけ」      → 検証後にコミットし、push・Issue・PR は作成しない

前提条件

  • multi-agent-mcpが利用可能(必須)
  • tmux がインストール済み(必須)
  • gh コマンドが利用可能
  • gh auth status が成功する(GitHub CLI 認証済み)

環境変数

モデルプロファイルは環境変数で設定(.env または export):

MCP_MODEL_PROFILE_ACTIVE=performance  # standard または performance

⚠️ caller_agent_id について(重要)

全ての multi-agent-mcp ツールには caller_agent_id パラメータが必須です。

  • mcp__multi-agent-mcp__create_agent() の戻り値から自分の ID を取得し、{owner_id} として保存
  • 以降の multi-agent-mcp ツール呼び出しで caller_agent_id="{owner_id}" を指定

起動時の自動判断(フラグの代わり)

ユーザーにフラグを入力させない。以下を順に決定する。発話・タスク説明に明示があればそれを最優先し、明示がなければ自動判断、それでも曖昧な項目だけ後述の手順で確認する。

項目既定判断ルール
git / no-git自動git rev-parse --is-inside-work-tree 成功なら git。失敗なら no-git(ブランチ作成を省略)
worktree / branchworktree「ブランチで」「worktree なし」等の発話があれば branch
計画書の扱い後述の判定「計画を立てて」「plan で」→ 計画書作成。タスク説明あり → 直接。なし → 既存計画書を探索

許可された完了範囲

現在の依頼と既存の許可から、操作ごとに実行範囲を判断する。

  • 実装だけの依頼: 実装・レビュー・検証を行い、コミットや Issue・PR を作るかの追加質問はせず終了する。
  • コミットだけの依頼: チェック後に対象変更をコミットする。push や Issue・PR 作成は行わない。
  • PR 作成の依頼: 必要な実装・検証・対象変更のコミット・通常の feature branch push を完了して PR を作成する。Issue は依頼されているか、許可済みのワークフローで必要な場合だけ作成する。
  • Issue 作成の依頼: 依頼された Issue と明示された後続操作だけを行う。必要に応じて確認済みの既存 Issue を参照する。
  • 「push しない」などの明示的な制約を優先する。範囲を黙って広げず、具体的な阻害要因を報告する。

許可済みの操作に --no-confirm、計画承認、完了時の再承認を要求しない。後続の仕上げ手順も個別に許可された操作だけを実行し、依頼されていない手順は省略する。重要な範囲変更、破壊的操作、高影響操作が発生する場合は許可を再確認する。

git の状態判定

git rev-parse --is-inside-work-tree >/dev/null 2>&1
  • 成功 → git モード(ブランチ/worktree を作成、init_tmux_workspace は通常設定)
  • 失敗 → no-git モード(ブランチ作成を省略、init_tmux_workspace に enable_git=false を渡す)

計画書の扱いの判定

  1. 「計画を立ててから」等の依頼がある → 計画作成: .claude/plans/ に計画を保存する。実装も依頼されていれば説明後に続行し、計画承認を明示的に求められた場合や重要な未解決の判断がある場合だけ待機する
  2. タスク説明がある → 直接実行: タスク説明をそのまま実装の指針にする
  3. タスク説明なし → 既存計画書: 最新の計画書を読み込む(ls -t ~/.claude/plans/*.md | head -1)。見つからなければタスク説明を促して終了

session_id / slug ルール

  • 確認済みの関連 Issue がある場合は、その番号を session_id に使う。
  • なければ PR 作成の有無によらず、タスクに基づく簡潔な英語 slug を session_id に使う。

Phase 1: セットアップ + Admin 起動

ステップ A: 許可されている場合だけ Issue を作成

shiiman-github:issue-create スキルのワークフローに従い、--no-confirm オプションで Issue を作成する。本文は「## 概要 / ## タスク一覧(チェックボックス)/ ## 完了条件」で構成。作成された Issue 番号を session_id と後続に使う。

ステップ 1: ブランチ / worktree 作成

git モードのみ実施(no-git はスキップ)。

  • worktree(既定): shiiman-github:worktree-create スキルのワークフローに従う
  • ブランチ: shiiman-github:branch-create スキルのワークフローに従う
  • 確認済みの関連 Issue がある場合だけ Issue 番号を渡し、なければタスクに基づくブランチ名を使う。

ステップ 2: Owner エージェント作成

owner_result = mcp__multi-agent-mcp__create_agent(role="owner", working_dir="パス")
# owner_result["agent"]["id"] を {owner_id} として保存

ステップ 3: Owner の役割を取得(🔴 必須)

mcp__multi-agent-mcp__get_role_guide(role="owner", caller_agent_id="{owner_id}")

ステップ 4: ワークスペース初期化

mcp__multi-agent-mcp__init_tmux_workspace(
    working_dir="プロジェクトのルートパス",
    open_terminal=true,
    auto_setup_gtr=true,
    session_id="{session_id}",
    caller_agent_id="{owner_id}"
    # no-git モードのときのみ、以下を追加:
    # enable_git=false,
)

no-git モードでは enable_git=false を必ず追加で渡す(git モードでは省略してよい)。

ステップ 5: Admin エージェント作成

admin_result = mcp__multi-agent-mcp__create_agent(
    role="admin", working_dir="パス", caller_agent_id="{owner_id}"
)
# admin_result["agent"]["id"] を {admin_id} として保存

ステップ 6: Admin に計画書を送信

mcp__multi-agent-mcp__send_task(
    agent_id="{admin_id}",
    task_content="計画書またはタスク説明",
    session_id="{session_id}",
    branch_name="feature/{session_id}",  # git モードのみ。no-git では渡さない
    caller_agent_id="{owner_id}"
)

no-git モードでは branch_name を渡さない。

ステップ 7: Admin の完了を待機

利用可能なエージェントの状態確認・待機ツールで完了を監視し、完了したら Phase 5 へ進む。続行のためにユーザーから状態確認を依頼されるのを待たない。

mcp__multi-agent-mcp__get_dashboard_summary(caller_agent_id="{owner_id}")
mcp__multi-agent-mcp__read_messages(agent_id="{owner_id}", caller_agent_id="{owner_id}")

Phase 2-4: Admin/Worker の自律実行

自動制御。Owner は待機のみ。

Phase 5: 結果を検証して続行

ステップ 1: 完了報告と変更内容を表示

mcp__multi-agent-mcp__read_messages(agent_id="{owner_id}", caller_agent_id="{owner_id}")

git モード:

git status --short --branch
git diff
git diff --cached

no-git モード: Admin の最終報告(実装サマリー・変更ファイル・テスト結果・残課題)を表示。

ステップ 2: 結果と許可の確認

実際の差分と検証結果を確認し、範囲内の対応すべき指摘を修正する。実装と後続操作が許可済みなら自動で続行する。重要な未解決の判断や未許可の影響についてだけ質問し、形式的な「OK」を待たない。

クリーンアップツールが削除する対象を確認する。今回のタスクが所有するエージェントと一時リソースだけを片付け、worktree・変更・有用なユーザーの作業は保持する。ツールで範囲を保証できなければ削除せず報告する。

検証後の処理

  1. Admin に検証完了と許可済みの後続操作への移行を通知する。

    mcp__multi-agent-mcp__send_message(
        sender_id="{owner_id}", receiver_id="{admin_id}",
        message_type="task_approved", content="検証完了。許可済みの範囲で後続処理へ進みます。",
        caller_agent_id="{owner_id}"
    )
    
  2. クリーンアップ:

    mcp__multi-agent-mcp__check_all_tasks_completed(caller_agent_id="{owner_id}")
    mcp__multi-agent-mcp__cleanup_on_completion(caller_agent_id="{owner_id}")
    
  3. セキュリティチェック: 機密ファイル(.env* / *.pem / credentials.json)を検出したら警告

    git status   # git モード
    find . -maxdepth 3 \( -name ".env*" -o -name "*.pem" -o -name "credentials.json" \)  # no-git モード
    
  4. 「仕上げ」へ進む

仕上げ

許可された仕上げ操作

  1. 更新が許可された Issue のうち、実際に完了したタスクだけをチェックする。未完了タスクを完了にしない。
  2. コミット: shiiman-git:add-commit スキルのワークフローに従い、--no-confirm オプションでコミットする
  3. push または PR 作成が許可されていれば、remote・送信先・対象コミットを確認して実際の feature branch を通常の push で公開する。この許可だけで force-push、デフォルトブランチへの push、無関係な作業の公開は行わない。
  4. PR 作成: shiiman-github:pr-create スキルのワークフローに従い、--no-confirm オプションで PR を作成する。日本語で概要・並列タスクの結果・検証結果を記載する。Closes #N は確認済みの関連 Issue がある場合だけ含め、なければ Issue 欄を省略する。
  5. 実際の変更・チェック・完了した操作を報告する。Issue・PR の番号と URL は存在する場合だけ含め、未実行の操作を完了と主張しない。

Issue/PR 連携なし(軽量)

実装だけの依頼では、変更と検証結果を報告して終了し、コミット・push・Issue・PR 作成は行わない。コミットだけの明示的な依頼では、検証して対象変更をコミットし、結果を報告する。任意の後続操作を追加で質問しない。

## 実装完了

### 作成されたブランチ / worktree(git モード時のみ)
- {ブランチ名} / パス: {worktree のパス}(worktree モード時のみ)

### 推奨コミットメッセージ
{リポジトリとグローバル指示に従う Conventional Commits メッセージ}

### 検証結果
{実行したチェック・結果・残課題}

### worktree クリーンアップ(worktree モード時のみ)
PR マージ後、`/shiiman-git:worktree` で gtr rm または gtr clean を実行してください。

重要な注意事項

  • ✅ ユーザーにフラグを入力させない(git・worktree/branch・計画書・Issue/PR を自動判断、曖昧なら確認)
  • ✅ multi-agent-mcp のツールにだけ caller_agent_id を渡す
  • ✅ no-git モードでは enable_git=false と branch_name 省略を徹底
  • クリーンアップの範囲と作業の保護を確認し、形式的な完了承認は追加しない。
  • コミットの規約はリポジトリとグローバル指示に従い、未対応の設定キーを仮定しない。
  • 外部操作や Git の仕上げ操作は、それぞれ許可された範囲内だけで実行する。

Single Flow

シングルエージェントで計画書またはタスク説明を順次実装する開発フロー。

フラグは不要。タスクを伝えれば、git の状態・発話内容から実行条件を自動判断し、曖昧な点だけ確認する。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

shiiman-workflow:single - シングルエージェント開発フロー

概要:
  計画書またはタスク説明を 1 エージェントで順次実装する。
  実装条件(Issue/PR・計画書・ブランチ・git)はフラグ不要で自動判断し、
  曖昧な点だけ確認する。

使用方法:
  shiiman-workflow:single [タスク説明]
  shiiman-workflow:single --help

オプション:
  --help  このヘルプを表示

例:
  shiiman-workflow:single                          # 既存計画書から実装(あれば)
  shiiman-workflow:single "ログイン機能を追加"      # タスク説明から実装
  shiiman-workflow:single "認証を実装して PR まで"  # 実装・コミット・push・PR 作成
  shiiman-workflow:single --help                   # ヘルプを表示

指定の伝え方(フラグの代わり):
  - 「計画を立ててから」  → 計画書を作成してから実装
  - 「ブランチで」        → worktree ではなくブランチを作成
  - 「PR まで」           → コミット・通常の push・PR 作成まで実施
  - 「Issue と PR まで」   → Issue 作成も含めて実施
  - 「コミットだけ」      → 検証後にコミットし、push・Issue・PR は作成しない

前提条件

  • gh コマンドが利用可能
  • gh auth status が成功する(GitHub CLI 認証済み)

起動時の自動判断(フラグの代わり)

ユーザーにフラグを入力させない。以下を順に決定する。発話・タスク説明に明示があればそれを最優先し、明示がなければ自動判断、それでも曖昧な項目だけ後述の手順で確認する。

項目既定判断ルール
git / no-git自動git rev-parse --is-inside-work-tree 成功なら git。失敗なら no-git(ブランチ作成を省略)
worktree / branchworktree「ブランチで」「worktree なし」等の発話があれば branch
計画書の扱い後述の判定「計画を立てて」「plan で」→ 計画書作成。タスク説明あり → 直接。なし → 既存計画書を探索

許可された完了範囲

現在の依頼と既存の許可から、操作ごとに実行範囲を判断する。

  • 実装だけの依頼: 実装・レビュー・検証を行い、コミットや Issue・PR を作るかの追加質問はせず終了する。
  • コミットだけの依頼: チェック後に対象変更をコミットする。push や Issue・PR 作成は行わない。
  • PR 作成の依頼: 必要な実装・検証・対象変更のコミット・通常の feature branch push を完了して PR を作成する。Issue は依頼されているか、許可済みのワークフローで必要な場合だけ作成する。
  • Issue 作成の依頼: 依頼された Issue と明示された後続操作だけを行う。必要に応じて確認済みの既存 Issue を参照する。
  • 「push しない」などの明示的な制約を優先する。範囲を黙って広げず、具体的な阻害要因を報告する。

許可済みの操作に --no-confirm、計画承認、完了時の再承認を要求しない。後続の仕上げ手順も個別に許可された操作だけを実行し、依頼されていない手順は省略する。重要な範囲変更、破壊的操作、高影響操作が発生する場合は許可を再確認する。

git の状態判定

git rev-parse --is-inside-work-tree >/dev/null 2>&1
  • 成功 → git モード(ブランチ/worktree を作成)
  • 失敗 → no-git モード(ブランチ作成を省略し、実装とサマリー出力のみ)

計画書の扱いの判定

  1. 「計画を立ててから」等の依頼がある → 計画作成: .claude/plans/ に計画を保存する。実装も依頼されていれば説明後に続行し、計画承認を明示的に求められた場合や重要な未解決の判断がある場合だけ待機する
  2. タスク説明がある → 直接実行: タスク説明をそのまま実装の指針にする(計画書を作らない)
  3. タスク説明なし → 既存計画書: 最新の計画書を読み込む
ls -t ~/.claude/plans/*.md 2>/dev/null | head -1

計画書が見つからなければ「タスク説明を教えてください。または計画を立ててから実装することもできます」と案内して終了。

実行フロー(共通)

[Issue 作成が許可済みの場合のみ] Issue 作成 →
ブランチ/worktree 作成 → 実装 → セキュリティチェック&自己レビュー →
[許可済みの操作のみ] コミット → push → PR 作成 → 完了報告
[連携なし] コミットメッセージ出力で終了

ステップ A: 許可されている場合だけ Issue を作成

shiiman-github:issue-create スキルのワークフローに従い、--no-confirm オプションで Issue を作成する。タスク内容を 50 文字以内のタイトルにし、本文は「## 概要 / ## タスク(チェックボックス)/ ## 完了条件」で構成する。ラベルは内容に応じて enhancement / bug / documentation / improvement を付与。

作成された Issue 番号を後続ステップで使う。

ステップ 1: ブランチ / worktree 作成

git モードのみ実施(no-git モードはスキップ)。

  • worktree(既定): shiiman-github:worktree-create スキルのワークフローに従う
  • ブランチ: shiiman-github:branch-create スキルのワークフローに従う
  • 確認済みの関連 Issue がある場合だけ Issue 番号を渡し、なければタスクに基づくブランチ名を使う。

ユーザーがベースブランチを明示した場合はそちらを優先する。

ステップ 2: 実装

計画書またはタスク説明に基づいて実装する。

  1. 必要なファイルを特定
  2. コード変更を実施
  3. 動作確認(可能な場合)
  4. 更新が許可された確認済みの Issue について、実際に完了したタスクだけチェックボックスを更新する。

ステップ 3: セキュリティチェック&自己レビュー

git status
git diff
  • 機密ファイルを検出したら警告: .env*(環境変数)、*.pem / *.key(秘密鍵)、credentials.json(認証情報)、node_modules/ / vendor/(依存)
  • 自己レビュー観点: コード品質・命名規則 / セキュリティ(OWASP Top 10)/ パフォーマンス(N+1・メモリリーク)

ステップ 4: 検証後に許可範囲内で続行

検証済みの変更とチェック結果を進捗で報告し、許可された仕上げの操作を続ける。差分やコミットメッセージの承認だけを理由に停止しない。具体的なリスクや未解決の範囲判断で確認が必要な場合は、確認可能な成果を準備してその判断だけを質問する。

仕上げ

許可された仕上げ操作

以下のうち許可された操作だけを実行する。同じ内容の再承認は不要。

  1. 更新が許可された Issue のうち、実際に完了したタスクだけをチェックする。未完了タスクを完了にしない。

  2. コミット: shiiman-git:add-commit スキルのワークフローに従い、--no-confirm オプションでコミットする

  3. push または PR 作成が許可されている場合は、remote・送信先の branch・送信対象のコミットを確認して git push -u origin {branch} で対象 feature branch を push する。この許可だけで force-push、デフォルトブランチへの push、無関係な作業の公開は行わない。

  4. PR 作成: shiiman-github:pr-create スキルのワークフローに従い、--no-confirm オプションで PR を作成する。日本語で概要・変更内容・検証結果を記載する。Closes #N は確認済みの関連 Issue がある場合だけ含め、なければ Issue 欄を省略する。

  5. 実際に完了した操作だけを報告し、未実行の Issue・PR の項目は省略する。

    ## 開発フロー完了
    
    ### 作成された Issue
    - #{issue番号}: {タイトル}
    
    ### 作成されたブランチ / worktree
    - {ブランチ名}
    - パス: {worktree のパス}(worktree モード時のみ)
    
    ### 作成された PR
    - PR #{pr番号}: {タイトル} / {pr_url}
    
    PR がマージされると Issue #{issue番号} は自動的にクローズされます。
    
    ### worktree クリーンアップ(worktree モード時のみ)
    PR マージ後、`/shiiman-git:worktree` で gtr rm または gtr clean を実行してください。
    

Issue/PR 連携なし(軽量)

実装だけの依頼では、変更と検証結果を報告して終了し、コミット・push・Issue・PR 作成は行わない。コミットだけの明示的な依頼では、検証して対象変更をコミットし、結果を報告する。任意の後続操作を追加で質問しない。

## 実装完了

### 作成されたブランチ / worktree(git モード時のみ)
- {ブランチ名}
- パス: {worktree のパス}(worktree モード時のみ)

### 変更サマリー
{git diff --stat}

### 推奨コミットメッセージ
{リポジトリとグローバル指示に従う Conventional Commits メッセージ}

### 検証結果
{実行したチェック・結果・残課題}

重要な注意事項

  • ✅ ユーザーにフラグを入力させない(git・worktree/branch・計画書・Issue/PR を自動判断、曖昧なら確認)
  • ✅ 計画書作成は「計画を立ててから」と依頼されたときのみ実施
  • 許可済みの仕上げ操作は再確認せず続行する。
  • ✅ 機密ファイルを警告・除外する
  • コミットの規約はリポジトリとグローバル指示に従い、未対応の設定キーを仮定しない。
  • ❌ デフォルトブランチで直接作業・コミットしない
  • 外部操作や Git の仕上げ操作は、それぞれ許可された範囲内だけで実行する。

Sponsors

Details

Marketplace
shiiman/claude-code-plugins
Source
plugins/shiiman-workflow
Category
Developer Tools

More from shiiman/claude-code-plugins

All 9