Agent 团团

An AgentTeams-native delivery team that turns an Agent brief into a checked minimum Agent project package.

Agent 团团面向需要独自兼顾产品、架构、工具、测试、部署和文档的 Agent 工程师/AI Builder。它把一份自然语言 Brief 推进为具有架构、代码、Skill、Tool、Eval、安全证据、回滚说明和交付文档的最小 Agent 项目。

项目参加 2026 GOAI Agent Infra 方向三“软件研发全流程协同”。

核心设计

• 单一平台路径：统一使用阿里云 AgentTeams 管理的千问/QwenPaw。
• 10 个平台可见 Identity：1 个 Manager；业务 Team 内 1 个独立 Team Leader + 8 个专业 Worker。
• 21 个业务节点 + 2 个 Join：增加 Agent 生态知识检索和 Skill 资产检索，设计分支仍须 3/3，构建分支仍须 2/2。
• 14 个可版本化 Skill：从 Brief、Radar、双知识检索、架构、Graph 到 Build、Eval、安全、证据和沉淀。
• 14 类等价工具契约：逐项声明协议、鉴权、Schema、权限、重试、幂等、审计、降级和 MCP 迁移成本。
• 双专家知识层：Agent 专家查询 19 个核心生态 × 18 个主题；Skill 大师查询 11 个来源、21 个候选资产，并保留证据等级和测试门。
• 独立验证：Builder、Eval、Security 与 Human Approval 分离。
• 受控副作用：POC 自动动作不超过 L1 隔离 workspace；L2/L3 不自动执行。

flowchart LR
  U["Agent Engineer / AI Builder"] --> L["Agent 团团 Leader"]
  L --> P["Brief Product"]
  L --> A["Radar Architect"]
  L --> X["Agent Expert\nEcosystem RAG"]
  L --> M["Skill Master\nAsset RAG"]
  L --> B["Agent Builder"]
  L --> E["Eval Quality"]
  L --> S["Security Release"]
  L --> K["Learning Sediment"]
  P & A & X & M & B & E & S & K --> T["Skills + Scoped Tools + Evidence"]
  T --> O["Checked Agent Project Package"]

Loading

当前证据边界

已经验证：

• 项目结构检查通过：9 个 Team AgentSpec、14 个 Skill、21 个业务节点、2 个 Join。
• 本地知识查询检查通过：19 个核心生态、53 个候选主体、18 个一级主题、72 个二级检查项；Skill 资产保持 candidate_only。
• 本地 HTTP mock gateway smoke 通过：Brief、双知识检索、workspace、Build、Test、确定性 Eval、Security、Registry、Manifest；18 个结构化 Trace span 契约通过。

尚未声称：

• 阿里云 AgentTeams 云端 Team/Worker 已创建或运行。
• 千问完成了黄金任务。
• 具备 Production SLA 或真实客户效率提升。

黄金 Demo

固定场景是构建“客服工单分类与回复建议 Agent”。用户只提供 Brief、样例和授权边界；Agent 团团应主动取证、隔离构建、独立评测并形成 evidence pack。生成的 Agent 只能建议回复，不能自动发送、退款或部署生产。

快速开始

要求：Python 3。POC mock gateway 仅使用 Python 标准库。

python3 tests/check_project_structure.py
python3 tests/test_knowledge_queries.py
python3 tests/smoke_mock_gateway.py

手动启动工具网关：

python3 tools/mock_tool_server.py --host 0.0.0.0 --port 18089
curl http://127.0.0.1:18089/health

阿里云 AgentTeams 的 Team/Worker 创建和黄金任务步骤见 运行手册。

仓库结构

agents/       Team Leader 与 8 个 Worker 的 SOUL/AgentSpec
skills/       14 个版本化 SKILL.md
knowledge/    Agent 生态与 Skill 资产的可追溯 RAG 快照
graph/        21 节点 + 2 Join 的机器可读 Graph
tools/        HTTP mock gateway、Tool Catalog 与 MCP 映射
scenarios/    黄金 Brief、样例与验收 fixture
at/           AgentTeams TeamSpec、创建配置和 Runbook
tests/        结构检查与本地 smoke
evidence/     不冒充云端实跑的本地证据
docs/         架构、Identity、Graph、Skill 与安全设计

设计文档

• 总体架构与端到端闭环
• Agent Identity 清单
• Node Graph Spec
• Skill Registry
• Tool、Context、Trace 与安全契约

HTTP 到 MCP

当前工具网关是可运行的 HTTP POC adapter，不冒充 MCP Server。14 类工具都在 Tool Catalog 与 MCP Mapping 中保留协议无关契约和未来 AgentTeams MCP/Higress MCP 映射；迁移时只替换协议、鉴权和后端适配，不静默改变 Skill/Graph 语义。

作者

唐汇文：项目负责人及独立开发者，香港岭南大学人工智能专业背景，前 AI 研发工程师，参与过多个多 Agent 金融研报项目。

GitHub：@pagoda111king

License

Apache License 2.0。详见 LICENSE 与 NOTICE。