开发团队助手配置

部署 4 个代理，自动化 PR 工作流：review（代码审查）、test（测试）、docs（文档生成）和 coordination（协调）。

角色

配置流程

步骤 1： 向用户询问所选角色及前缀（）。

步骤 2： 安装对应技能：

# reviewer:
clawhub install pilot-github-bridge pilot-review pilot-chat
# test-runner:
clawhub install pilot-github-bridge pilot-task-router pilot-audit-log
# doc-writer:
clawhub install pilot-github-bridge pilot-share pilot-task-router
# coordinator:
clawhub install pilot-github-bridge pilot-task-chain pilot-slack-bridge pilot-broadcast

步骤 3： 设置主机名，并将清单文件写入 ~/.pilot/setups/dev-team-assistants.json。

步骤 4： 与 coordinator 建立握手（所有代理均需与 coordinator 握手）。

各角色的清单模板

coordinator

{
  "setup": "dev-team-assistants", "role": "coordinator", "role_name": "PR Coordinator",
  "hostname": "-coordinator",
  "skills": {
    "pilot-github-bridge": "Watch GitHub for new PRs, post unified summary comments.",
    "pilot-task-chain": "Fan out review/test/doc tasks and collect results.",
    "pilot-slack-bridge": "Post PR status updates to Slack.",
    "pilot-broadcast": "Broadcast new PR notifications to all assistants."
  },
  "data_flows": [
    { "direction": "send", "peer": "-reviewer", "port": 1002, "topic": "pr-review", "description": "PR details for review" },
    { "direction": "send", "peer": "-test-runner", "port": 1002, "topic": "pr-test", "description": "PR details for testing" },
    { "direction": "send", "peer": "-doc-writer", "port": 1002, "topic": "pr-docs", "description": "PR details for docs" },
    { "direction": "receive", "peer": "-reviewer", "port": 1002, "topic": "review-result", "description": "Review findings" },
    { "direction": "receive", "peer": "-test-runner", "port": 1002, "topic": "test-result", "description": "Test results" },
    { "direction": "receive", "peer": "-doc-writer", "port": 1001, "topic": "docs-result", "description": "Generated docs" }
  ],
  "handshakes_needed": ["-reviewer", "-test-runner", "-doc-writer"]
}

reviewer

{
  "setup": "dev-team-assistants", "role": "reviewer", "role_name": "Code Reviewer",
  "hostname": "-reviewer",
  "skills": {
    "pilot-github-bridge": "Fetch PR diffs from GitHub.",
    "pilot-review": "Analyze code for quality, security, and style issues.",
    "pilot-chat": "Discuss review findings with coordinator."
  },
  "data_flows": [
    { "direction": "receive", "peer": "-coordinator", "port": 1002, "topic": "pr-review", "description": "PR details" },
    { "direction": "send", "peer": "-coordinator", "port": 1002, "topic": "review-result", "description": "Review findings" }
  ],
  "handshakes_needed": ["-coordinator"]
}

数据流向

• coordinator → reviewer/test-runner/doc-writer：PR 详情（端口 1002）
• reviewer/test-runner → coordinator：执行结果（端口 1002）
• doc-writer → coordinator：生成的文档（端口 1001）

工作流示例

# 在 coordinator 上 —— 分发任务：
pilotctl --json task submit -reviewer --task '{"pr":1234,"repo":"acme/api","action":"review"}'
pilotctl --json task submit -test-runner --task '{"pr":1234,"action":"test","branch":"feature/auth"}'
# 在 reviewer 上 —— 返回结果：
pilotctl --json publish -coordinator review-result '{"pr":1234,"issues":2,"approval":"changes_requested"}'
# 在 test-runner 上 —— 返回结果：
pilotctl --json publish -coordinator test-result '{"pr":1234,"passed":89,"failed":0,"coverage":82}'

依赖项

需要 pilot-protocol 技能、pilotctl 二进制程序、clawhub 二进制程序，以及一个正在运行的守护进程（daemon）。