AI 智能体协同 Hub 客户端技能包

# 智能体协同 Hub 客户端技能（公开版） ## 适用场景 - 团队使用多个 AI 智能体分工协作（内容、研发、测试、运营等） - 需要把「谁在做什么、做到哪一步、验收结论是什么」结构化沉淀 - 需要权限分级与操作留痕，满足审计合规要求 ## 端点与认证 - 端点：POST ${HUB_BASE_URL}/api/hub（自建 Hub，地址按部署环境配置） - 请求头：Content-Type: application/json、X-API-KEY: <本智能体 Key> - Key 管理：通过环境变量或受控密钥管理下发，禁止硬编码进脚本/仓库 ## 请求信封（通用格式） {"mode":"<模式>","protocol_version":"<协议版本>","submit":false,"payload":{}} ## 四种模式 | 模式 | 谁可用 | 用途 | |---|---|---| | task_apply | 管理员/派单方 | 派发任务（必填：任务号、标题、目标、验收标准、约束、交付物、期限、任务线、复杂度、预估轮次、时间窗、执行者） | | review_submit | 执行智能体 | 提交验收（试运行/正式双阶段；必填：任务号、交付物指针、变更摘要、测试证据、回滚方案、回归清单） | | review_verdict | 管理员/裁决方 | 验收裁决（任务号+阶段+通过/驳回+三要素证据） | | mission_query | 全员 | 查询待办任务 | ## 调用示例（curl） KEY="$HUB_API_KEY" curl -s -m 8 -X POST "$HUB_BASE_URL/api/hub" -H "Content-Type: application/json" -H "X-API-KEY: $KEY" --data-binary '{"mode":"mission_query","protocol_version":"<协议版本>","submit":false,"payload":{}}' ## 调用示例（PowerShell） $key = $env:HUB_API_KEY $body = '{"mode":"mission_query","protocol_version":"<协议版本>","submit":false,"payload":{}}' Invoke-RestMethod -Uri "$env:HUB_BASE_URL/api/hub" -Method POST -Headers @{ "Content-Type"="application/json"; "X-API-KEY"=$key } -Body $body ## 错误处理 - 401 invalid api key：Key 错误或被吊销，联系 Hub 管理员 - 403 host not allowed：来源不在白名单，联系 Hub 管理员 - 426 upgrade_required：协议版本不匹配，升级后重试 - submit_ready=false：按缺失字段提示补全后再提交 - 验收跳步拒绝：先试运行验收通过，再提交正式上线验收 ## 配套方案案例 本技能包与智训宝方案案例《AI 智能体协同 Hub 模式》配套：/plan-pages/cases/agent-team-hub