版本发布管理配置

部署 3 个智能体（agent），分别用于生成变更日志、管理版本号以及发布版本公告。

角色说明

配置流程

步骤 1： 向用户询问该智能体应承担的角色，以及要使用的前缀（）。

步骤 2： 为所选角色安装对应技能：

# 配置 changelog-bot：
clawhub install pilot-github-bridge pilot-share pilot-archive

# 配置 version-manager：
clawhub install pilot-task-router pilot-receipt pilot-audit-log

# 配置 announcer：
clawhub install pilot-announce pilot-slack-bridge pilot-webhook-bridge

步骤 3： 设置主机名：

pilotctl --json set-hostname -

步骤 4： 编写配置清单文件（manifest）：

mkdir -p ~/.pilot/setups
cat > ~/.pilot/setups/release-management.json << 'MANIFEST'

MANIFEST

步骤 5： 告知用户需与直连通信对端（direct communication peers）发起握手（handshake）操作。

各角色对应的清单模板

changelog-bot

{
  "setup": "release-management", "setup_name": "Release Management",
  "role": "changelog-bot", "role_name": "Changelog Bot",
  "hostname": "-changelog-bot",
  "description": "Scans merged PRs and commits, generates release notes and changelogs automatically.",
  "skills": {
    "pilot-github-bridge": "Watch for merged PRs, fetch commit history and PR metadata.",
    "pilot-share": "Share generated changelogs with version manager.",
    "pilot-archive": "Archive previous release notes for historical reference."
  },
  "peers": [
    { "role": "version-manager", "hostname": "-version-manager", "description": "Receives release notes for versioning" },
    { "role": "announcer", "hostname": "-announcer", "description": "Final stage — does not communicate directly" }
  ],
  "data_flows": [
    { "direction": "send", "peer": "-version-manager", "port": 1002, "topic": "release-notes", "description": "Release notes with categorized changes" }
  ],
  "handshakes_needed": ["-version-manager"]
}

version-manager

{
  "setup": "release-management", "setup_name": "Release Management",
  "role": "version-manager", "role_name": "Version Manager",
  "hostname": "-version-manager",
  "description": "Bumps semantic versions, tags releases, coordinates rollout schedules.",
  "skills": {
    "pilot-task-router": "Route version bump decisions based on change categories.",
    "pilot-receipt": "Confirm receipt of release notes from changelog bot.",
    "pilot-audit-log": "Log all version bumps and release tags for traceability."
  },
  "peers": [
    { "role": "changelog-bot", "hostname": "-changelog-bot", "description": "Sends release notes with categorized changes" },
    { "role": "announcer", "hostname": "-announcer", "description": "Receives release tags for announcement" }
  ],
  "data_flows": [
    { "direction": "receive", "peer": "-changelog-bot", "port": 1002, "topic": "release-notes", "description": "Release notes with categorized changes" },
    { "direction": "send", "peer": "-announcer", "port": 1002, "topic": "release-tag", "description": "Release tag with version and artifacts" }
  ],
  "handshakes_needed": ["-changelog-bot", "-announcer"]
}

announcer

{
  "setup": "release-management", "setup_name": "Release Management",
  "role": "announcer", "role_name": "Release Announcer",
  "hostname": "-announcer",
  "description": "Posts release announcements to Slack, email lists, and documentation sites.",
  "skills": {
    "pilot-announce": "Broadcast release announcements to all subscribed channels.",
    "pilot-slack-bridge": "Post formatted release notes to Slack channels.",
    "pilot-webhook-bridge": "Notify documentation sites and email services via webhooks."
  },
  "peers": [
    { "role": "changelog-bot", "hostname": "-changelog-bot", "description": "First stage — does not communicate directly" },
    { "role": "version-manager", "hostname": "-version-manager", "description": "Sends release tags for announcement" }
  ],
  "data_flows": [
    { "direction": "receive", "peer": "-version-manager", "port": 1002, "topic": "release-tag", "description": "Release tag with version and artifacts" },
    { "direction": "send", "peer": "external", "port": 443, "topic": "release-announcement", "description": "Release announcement via Slack and webhooks" }
  ],
  "handshakes_needed": ["-version-manager"]
}

数据流向

• changelog-bot -> version-manager：发布 release-notes 事件（端口 1002）
• version-manager -> announcer：发布 release-tag 事件（端口 1002）
• announcer -> external：通过 Webhook 发布 release-announcement（端口 443）

握手命令

# changelog-bot 与 version-manager 相互握手：
pilotctl --json handshake -version-manager "setup: release-management"
pilotctl --json handshake -changelog-bot "setup: release-management"

# version-manager 与 announcer 相互握手：
pilotctl --json handshake -announcer "setup: release-management"
pilotctl --json handshake -version-manager "setup: release-management"

工作流示例

# 在 version-manager 上 — 订阅 release-notes：
pilotctl --json subscribe -changelog-bot release-notes

# 在 announcer 上 — 订阅 release-tag：
pilotctl --json subscribe -version-manager release-tag

# 在 changelog-bot 上 — 发布 release-notes：
pilotctl --json publish -version-manager release-notes '{"version":"1.5.0","changes":[{"type":"feature","description":"Add webhook retry logic"}],"breaking":false}'

# 在 version-manager 上 — 发布 release-tag：
pilotctl --json publish -announcer release-tag '{"version":"v1.5.0","artifacts":["linux-amd64","darwin-arm64"]}'

依赖项

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