From github-vibe-flow
Use to execute GitHub Issues with tmux + git worktree. Parses execution notation [#1, (#2, #3), #4] and manages parallel/serial agent dispatch.
How this skill is triggered — by the user, by Claude, or both
Slash command
/github-vibe-flow:vf-executeThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
tmuxペインとgit worktreeを使ってGitHub Issueを実行する。実行記法を解析してシリアル/パラレルの実行順序を制御する。
tmuxペインとgit worktreeを使ってGitHub Issueを実行する。実行記法を解析してシリアル/パラレルの実行順序を制御する。
開始時の宣言: 「vf-execute スキルを使って、Issueの実行を開始します。」
引数として実行記法を受け取るか、設計ドキュメントから抽出する:
[#12, (#13, #14), #15]解析ルール:
[...] = シリアルグループ(左から右へ順次実行、各完了を待つ)(...) = パラレルグループ(全項目を同時実行、全完了を待つ)#N = GitHub Issue番号[#1, (#2, [#3, #4]), #5]# tmux内にいるか確認
if [ -n "$TMUX" ]; then
echo "tmuxセッション内です"
else
echo "tmux外です — 新しいセッションを作成します"
tmux new-session -d -s vibe-flow
# 注意: ユーザーにアタッチを案内する: tmux attach -t vibe-flow
fi
実行記法内の各Issue番号について、GitHub MCP経由で詳細を取得する:
実行記法をDAGとして処理する:
シリアルステップごとに:
パラレルグループごとに:
各Issueについて、./agent-prompt.md テンプレートにIssue詳細を埋め込んでAgentプロンプトを構築する:
# リポジトリルートとIssueスラグを取得
REPO_ROOT=$(git rev-parse --show-toplevel)
ISSUE_NUM=12
ISSUE_TITLE_SLUG="add-auth-endpoint" # タイトルをスラグ化
BRANCH_NAME="vf/${ISSUE_NUM}-${ISSUE_TITLE_SLUG}"
# worktreeを作成
git worktree add "${REPO_ROOT}/.worktrees/${BRANCH_NAME}" -b "${BRANCH_NAME}"
# 新しいtmuxウィンドウでClaude Codeを起動(ペインではなくウィンドウを使い、各Agentの進捗を個別に確認可能にする)
tmux new-window -n "vf-${ISSUE_NUM}" "cd ${REPO_ROOT}/.worktrees/${BRANCH_NAME} && claude --dangerously-skip-permissions -p 'AGENT_PROMPT_HERE'"
注意: --print は使用しない。--print は全出力をバッファして完了時に一括表示するため、実行中の進捗が見えなくなる。--print なしであればTUIがリアルタイムで表示され、ユーザーが tmux select-window で各Agentの進捗を確認できる。
各Agentのウィンドウが残っているかで完了を検知する:
# 各Agentウィンドウの生存確認(ウィンドウが閉じれば完了)
tmux list-windows -F '#{window_name} #{window_active}'
シリアルステップの完了(またはパラレルグループの全項目完了)を検知したら、次のステップに進む。
全Issueの処理が完了したら:
/vf-monitor の開始を提案し、レビューコメントの監視を促す呼び出され方:
利用するもの:
npx claudepluginhub ensekitt/github-vibe-flow --plugin github-vibe-flowDelegates GitHub issues to the Orchestrator agent for parallel processing using git worktrees and WezTerm windows, with concurrency guards and issue locking.
Executes GitHub issues by reading content with read-github-issue, delegating tasks to frontend-implementer or general-purpose-assistant sub-agents, running tests/lint, committing on worktree, and creating PRs via commit-push and create-pr.
Executes implementation plans by dispatching fresh subagents per task with dependency analysis, concurrent execution, and built-in two-stage self-review for spec compliance and code quality.