docs(skill): genericize multi-agent-mux-loop SKILL manual by replacing hardcoded agent session names with placeholders

This commit is contained in:
2026-07-16 23:46:27 +09:00
parent 52c270eea7
commit f85fdfc1f9
+7 -7
View File
@@ -10,7 +10,7 @@
Run an autonomous planning-execution-review loop using multiple agents (Planner, Creator, Reviewers) in the workspace. It supports: Run an autonomous planning-execution-review loop using multiple agents (Planner, Creator, Reviewers) in the workspace. It supports:
- **Collaborative Planning** (`--plan` and `--plan-talk N`): Planner designs the solution, Creator challenges the plan for N turns to resolve edge cases, then implementation starts. - **Collaborative Planning** (`--plan` and `--plan-talk N`): Planner designs the solution, Creator challenges the plan for N turns to resolve edge cases, then implementation starts.
- **Existing Plan Execution** (default without `--plan`): Planner 에이전트에게 계획 작성을 위임하지 않고 기존에 승격된 계획서(`.agents/reports/canary-projects-multi-agent-mux-planner-reviewer-claude/report-final.md`)의 내용을 로드하여 작업자(Creator)의 판단하에 즉시 구현을 시작합니다. - **Existing Plan Execution** (default without `--plan`): Planner 에이전트에게 계획 작성을 위임하지 않고 기존에 승격된 계획서(`.agents/reports/<planner-session-name>/report-final.md`)의 내용을 로드하여 작업자(Creator)의 판단하에 즉시 구현을 시작합니다.
- **Targeted Peer-Review** (`--reviewer`): Runs custom-selected reviewer agents to verify code changes. - **Targeted Peer-Review** (`--reviewer`): Runs custom-selected reviewer agents to verify code changes.
- **Total Peer-Review** (`--all-reviewer`): Enforces a unanimous PASS verdict from all registered reviewer sessions. - **Total Peer-Review** (`--all-reviewer`): Enforces a unanimous PASS verdict from all registered reviewer sessions.
- **Self-Review** (default): Creator verifies its code changes autonomously without peer reviews. - **Self-Review** (default): Creator verifies its code changes autonomously without peer reviews.
@@ -77,8 +77,8 @@ Run an autonomous planning-execution-review loop using multiple agents (Planner,
sequenceDiagram sequenceDiagram
autonumber autonumber
actor Loop as run_loop.sh actor Loop as run_loop.sh
participant Plan as Planner Claude participant Plan as Planner Agent
participant Dev as Creator Claude participant Dev as Creator Agent
participant Rev as Reviewer Agents participant Rev as Reviewer Agents
Loop->>Loop: Parse args & validate session states Loop->>Loop: Parse args & validate session states
@@ -152,7 +152,7 @@ sequenceDiagram
```bash ```bash
# 1. Existing-plan execution + Self-review (direct task execution using existing promoted plan) # 1. Existing-plan execution + Self-review (direct task execution using existing promoted plan)
bash .agents/skills/multi-agent-mux-loop/scripts/run_loop.sh \ bash .agents/skills/multi-agent-mux-loop/scripts/run_loop.sh \
--target-agent "canary-projects-multi-agent-mux-creator-claude" \ --target-agent "<creator-session-name>" \
--task "Fix typo in deploy/README.md" --task "Fix typo in deploy/README.md"
# 2. Collaborative planning + Targeted Reviewers + Safety limits # 2. Collaborative planning + Targeted Reviewers + Safety limits
@@ -160,11 +160,11 @@ bash .agents/skills/multi-agent-mux-loop/scripts/run_loop.sh \
bash .agents/skills/multi-agent-mux-loop/scripts/run_loop.sh \ bash .agents/skills/multi-agent-mux-loop/scripts/run_loop.sh \
--plan \ --plan \
--plan-talk 1 \ --plan-talk 1 \
--reviewer "canary-projects-multi-agent-mux-reviewer-cline,canary-projects-multi-agent-mux-reviewer-claude" \ --reviewer "<reviewer-session-name-1>,<reviewer-session-name-2>" \
--all-reviewer \ --all-reviewer \
--max-loop 3 \ --max-loop 3 \
--verbose \ --verbose \
--target-agent "canary-projects-multi-agent-mux-creator-claude" \ --target-agent "<creator-session-name>" \
--task "Refactor the session backup mechanism to handle NFS flock" --task "Refactor the session backup mechanism to handle NFS flock"
# 3. Total validation (all reviewers must PASS) # 3. Total validation (all reviewers must PASS)
@@ -172,7 +172,7 @@ bash .agents/skills/multi-agent-mux-loop/scripts/run_loop.sh \
--all-reviewer \ --all-reviewer \
--max-loop 5 \ --max-loop 5 \
--cleanup \ --cleanup \
--target-agent "canary-projects-multi-agent-mux-creator-claude" \ --target-agent "<creator-session-name>" \
--task "Close CI shellcheck coverage gaps" --task "Close CI shellcheck coverage gaps"
``` ```