# 工人派遣 ## 概述使用**任务工具和`run_in_background: true`** 生成并管理工作人员 Claude 代理。工作人员作为并行后台代理运行，通过 **TaskOutput** 进行监控。 **核心原则：** 工作人员是孤立的、有范围的、可消耗的。状态存在于 GitHub 中，而不是工作人员中。 **关键优化：** 在生成之前预提取问题上下文。工作人员收到的是重点背景信息，而不是原始问题。 ## 工作树隔离（强制） **关键：** 每个工人必须有自己的 git 工作树。工作人员永远不会在主存储库中操作。主存储库 (./) ← 仅 Orchestrator │ └── 工作树（孤立） ├── ../project-worker-123/ ← #123 的工人 ├── ../project-worker-124/ ← #124 的工人 └── ../project-worker-125/ ← #125 的工人 **编排者职责：** 在生成工作人员之前创建工作树。 **工作人员责任：** 在任何工作之前验证隔离（请参阅“工作人员协议”）。这可以防止并行工作人员之间的文件损坏。 ## 工人类型类型 |子代理 |目的|何时使用 ---|---|---|--- 实施 | `通用` |全功能作品 |标准发行工作研究| `探索` |只读调查|实施前分析、调试公关决议| `通用` |修复 CI，合并 PR |现有公关清理 ## 预提取（关键） **在产生之前提取问题上下文。**工作人员不应花费代币重新阅读问题。 extract_issue_context() { 本地问题=$1 # 单个 API 调用即可获取所有内容 ISSUE_JSON=$(gh 问题视图 "$issue" --json 标题、正文、标签、评论、受让人) TITLE=$(echo "$ISSUE_JSON" | jq -r '.title') BODY=$(echo "$ISSUE_JSON" | jq -r '.body') LABELS=$(echo "$ISSUE_JSON" | jq -r '[.labels[].name] | join(", ")') # 提取接受标准（如果存在）接受=$(echo "$BODY" | sed -n '/## 接受标准/,/^## /p' | head -20) [ -z "$ACCEPTANCE" ] && ACCEPTANCE=$(echo "$BODY" | sed -n '/- \[/p' | head -10) # 获取最新的切换（如果存在）交接=$(回显“$ISSUE_JSON”| jq -r ' [.评论[] | select(.body | contains(""))] | 复制代码最后| .body //“” '） # 获取最近的进度评论进度=$(回显“$ISSUE_JSON”| jq -r ' [.comments[-3:][].body] |加入("\n---\n") ' |头-50) } ## 产生实施工作者 ### 第 1 步：提取上下文并创建工作树 spawn_implementation_worker() { 本地问题=$1 本地尝试=${2:-1} # 预提取上下文 extract_issue_context“$问题” worker_id =“worker-$（日期+％s）-$问题” issues_slug=$(echo "$TITLE" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | cut -c1-40) 分支=“功能/$issue-$issue_slug” worktree_path="../$(basename $PWD)-worker-$issue" # 创建工作树 git fetch origin 主要 git 分支“$branch”origin/main 2>/dev/null ||真实 git worktree 添加“$worktree_path”“$branch” } ### 第 2 步：在 GitHub 中注册注册工人（）{ 本地问题=$1worker_id=$2worktree=$3 gh 问题评论 "$issue" --body " {\"worker_id\": \"$worker_id\", \"assigned_at\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"} **分配的工作人员：** \`$worker_id\` 在 $(date -u +%H:%M:%S)Z" update_project_status“$issue”“进行中” } ### 第 3 步：构建重点提示 **~50 行，带有预先提取的上下文：** 构造_worker_提示（）{ 本地问题=$1worker_id=$2尝试=$3 # 使用预先提取的：TITLE、ACCEPTANCE、HANDOVER、PROGRESS 猫<<提示工人 $worker_id |问题 #$问题 |尝试$尝试 ## 任务 $标题 ## 要求 $承兑 ## 约束条件 - 只处理问题 #$issue - TDD：首先编写测试 - PR之前必须通过所有测试 - 在 PR 之前完成代码审查（发布工件） - 最多 100 回合 - 90+ 时交接 ## 退出条件完成后返回 JSON： ``````json {“status”：“COMPLETED|BLOCKED|HANDOVER”，“pr”：null，“summary”：“...”} `````` |状态 |意义| |--------|---------| |已完成 | PR 创建，测试通过 | |被封锁 |没有外部输入就无法继续 | |交接|转弯极限逼近，上下文已发布 | ## 进度协议发布有关问题的简短更新。移交时，使用标记发布完整上下文。 $([ -n "$HANDOVER" ] && echo "## 上一次移交 $移交") $([ -n "$PROGRESS" ] && echo "## 最近活动 $进展”）现在开始实施。提示 } ### 第 4 步：生成工人任务（描述：“问题#[ISSUE]工人”，提示：[FOCUSED_PROMPT]， subagent_type: "通用", run_in_background：true ） **返回：** 用于监控的`task_id`。 ## 产生研究人员在实施之前使用“Explore”子代理进行只读调查：构造研究提示（）{ 本地问题=$1 问题=$2 猫<<提示针对问题 #$issue 的研究：$TITLE ## 问题 $问题 ## 范围研究代码库来回答问题。返回结构化结果。 ## 输出格式 ``````json { "findings": ["关键发现 1", "关键发现 2"], "relevant_files": ["path/to/file.ts"], "patterns": ["要遵循的现有模式"], "concerns": ["需要解决的潜在问题"], "recommendation": "摘要推荐" } `````` 不要修改任何文件。仅供研究。提示 } 任务（描述：“研究#[ISSUE]”，提示：[RESEARCH_PROMPT]， subagent_type: "探索", run_in_background：true ） **使用案例：** * 实施前：“相似的功能存在哪些模式？” * 调试：“这个错误来自哪里？” * 影响分析：“这个变化会影响什么？” ## 并行调度在一条消息中生成多个工作线程以并发执行： ## 派遣 3 名工人 1. 提取每个问题的上下文（按顺序） 2. 在同一消息中调用所有任务工具（并行）：任务（描述：“问题＃123工人”，提示：[...]，subagent_type：“通用”，run_in_background：true）任务（描述：“问题＃124工人”，提示：[...]，subagent_type：“通用”，run_in_background：true）任务（描述：“问题＃125工人”，提示：[...]，subagent_type：“通用”，run_in_background：true） 3. 存储所有返回的task_id ## 监控工人 TaskOutput(task_id: "[ID]", 块: false, 超时: 1000) 结果 |意义|行动 ---|---|--- “任务仍在运行...” |工人活跃 |继续监控带有状态的 JSON |工人完成 |解析结果，更新GitHub 错误 |工人失败 |检查 GitHub 的上下文 **解析完成：** 结果=$(echo "$OUTPUT" | grep -oP '\{.*\}' | jq -r '.status') PR=$(echo "$OUTPUT" | grep -oP '\{.*\}' | jq -r '.pr // 空') ## 公关人员解决现有 PR（CI 失败、缺少评论、合并）：构造_pr_worker_prompt() { 本地pr=$1worker_id=$2 猫<<提示公关人员 $worker_id |公关 #$pr ## 使命 1. 检查 CI：\`gh pr 检查 $pr\` 2. 如果失败：调查、修复、推动 3. 验证链接问题上是否存在审核工件 4. 如果可合并：\`gh pr merge $pr --squash --delete-branch\` ## 输出 ``````json {“状态”：“合并|阻止|切换”，“摘要”：“...”} `````` ## 约束条件 - 仅修复 CI 相关问题 - 仅推送到现有分支 - 检查不合并标签开头：\`gh pr 检查 $pr\` 提示 } ## 工人清理完成时（通过 TaskOutput 检测到）： cleanup_worker() { 本地问题=$1 task_id=$2 结果=$3 gh 问题评论 "$issue" --body " {\"已分配\": false, \"cleared_at\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"} **工作人员完成：** $结果” 案例“$结果” 已完成) update_project_status "$issue" "审核中" ;; 已阻止) update_project_status "$issue" "已阻止" ;; 交出） ;; # 保持进行中，生成替换埃萨克 } ## 替代工人当工人返回 HANDOVER 时： 1. 移交上下文在问题评论中（已经由工作人员发布） 2. 通过：`extract_issue_context` 提取（包括 HANDOVER 变量） 3. 生成替换为尝试+1 4.新的worker自动接收完整的上下文 ## 清单 **产卵前：** * 预先提取问题上下文 * 在功能分支上创建工作树 * 在 GitHub 上注册的 Worker * 项目委员会状态：进行中 **提示包括：** * 预先提取的标题和验收标准 * JSON输出格式要求 * 之前的移交（如果有） * 近期进展评论 **完成后：** * JSON结果解析 * GitHub 状态已更新 * 项目板状态已更新 * Task_id从活动列表中删除 ## 整合 **使用者：** `autonomous-orchestration`、`claude-autonomous --pr` **用途：** `worker-protocol`（行为契约）、`worker-handover`（上下文格式）、`ci-monitoring`（公关工作者）

工人派遣

包含技能