Skip to content
BranchesTags

Repository files navigation

xiaoming-coding-team

软件研发全流程协同 · 多 Agent 闭环系统 面向企业软件研发场景的深度研究项目：以多 Agent 协同、角色权限治理、可观测审计、Skill 复盘沉淀为核心的 AI 算法与工程实现。 以 AgentTeams（原名 HiClaw） 为协同设计基点

框架 License

缺陷与需求从多源输入到复盘沉淀的端到端无人值守闭环：

多源缺陷/需求（Issue、日志告警、用户反馈、工单）
  → Manager 拆解调度
  → sentinel 聚合 / 去重 / 根因定位 / 影响面分析（只读）
  → forge 修复方案 / 自动化编码 / 测试 / 提 PR
  → guardian 独立验证 / 发布确认 / 证据归档 / 复盘沉淀
  → L2/L3 人工审批 · 权限熔断 · 回滚预案 全程护航

为什么是多 Agent

断点 单 Agent 本方案
修验不分 自我修复自我通过 forge / guardian 身份、凭证双隔离，独立质量门禁
动作失控 直持 Token，权限不可细分 L0–L3 分级审批 + Higress 网关秒级权限熔断
过程黑盒 无审计链 Matrix + 共享存储 + 网关日志 + OTel Trace + 审批链五源互证
经验流失 会话结束即遗忘 复盘自动蒸馏为新 Skill，能力持续进化

系统架构

                 ┌──────────── admin（人类 Tech Lead）────────────┐
                 │        Matrix 房间 · L2/L3 审批 · 纠正          │
                 └───────────────────▲───────────────────────────┘
                                     │
            ┌────────────────────────┴─────────────────────────┐
            │   Manager（项目 AI 值班长 · 不写代码不持凭证）     │
            │   任务拆解 / 状态机推进 / 审批发起 / 心跳巡检      │
            └───▲───────────────▲───────────────▲──────────────┘
                │               │               │
        ┌───────┴─────┐ ┌───────┴──────┐ ┌──────┴───────┐
        │  sentinel   │ │    forge     │ │   guardian   │
        │  聚合·诊断   │ │   修复·编码   │ │  验证·复盘    │
        │  （只读）    │ │ （白名单仓库）│ │  （禁改代码） │
        └───────┬─────┘ └───────┬──────┘ └──────┬───────┘
                └───────────────┼───────────────┘
            ┌───────────────────┴───────────────────────────┐
            │  Skill 层（12 个）→ MCP 层 → Higress 安全网关  │
            │  真实 PAT / LLM Key 永不下发 Worker            │
            └───────────────────────────────────────────────┘
            MinIO 共享状态（shared/tasks/{task-id}/）+ Matrix 消息

任务状态机（meta.json 为单一事实来源）：

intake → intake-done → analyzed → planned → fixed → verified → closed
              异常分支：needs-human / failed / rollback-pending / rolled-back

快速开始

前置条件（依赖说明）

依赖 要求 用途
Docker Docker Desktop / Engine，daemon 已启动 AgentTeams 运行环境
硬件 ≥ 4C8G 内存、≥ 15GB 磁盘 Embedded 模式最小部署
DeepSeek API Key platform.deepseek.com Worker 推理（openai-compat，可换任意兼容模型）
GitHub PAT repo 权限 forge 提 PR（仅存于 Higress 网关）
测试仓库 任意公开/私有仓库 PoC 修复对象
Python ≥ 3.10（仅 alert-bot 需要） 告警入口

Python 依赖（alert-bot/requirements.txt）：flask、requests。

1. 安装 AgentTeams（HiClaw）

bash <(curl -sSL https://higress.ai/hiclaw/install.sh)
# 交互配置：Provider 选 openai-compat，Base URL 填 https://api.deepseek.com/v1，
# Model 填 deepseek-chat，按提示填入 DeepSeek Key 与 GitHub PAT

2. 应用本仓库配置

cd xiaoming-coding-team
bash scripts/apply-configs.sh   # agents/ 与 team.yaml 同步到 ~/agentteams-manager/

3. 创建 Worker（Element Web · http://127.0.0.1:18088 · DM Manager）

Create a Worker named sentinel for issue intake, dedup, root cause and impact analysis (read-only)
Create a Worker named forge for fix planning, coding, tests and pull requests
Create a Worker named guardian with copaw runtime for independent verification, release check and evidence collection

验证：list sentinel's skills 应返回 issue-intake, requirement-dedup, code-rootcause, impact-analysis。

4. 运行入口：启动 alert-bot

pip install -r alert-bot/requirements.txt
export MATRIX_HOMESERVER=http://127.0.0.1:18080
export MATRIX_TOKEN=<bot-token>
export MATRIX_USER_ID=@alertbot:matrix-local.hiclaw.io:18080
python alert-bot/main.py        # 监听 5000 端口，POST /alerthook

Windows PowerShell：

$env:MATRIX_HOMESERVER = "http://127.0.0.1:18080"
$env:MATRIX_TOKEN = "<bot-token>"
$env:MATRIX_USER_ID = "@alertbot:matrix-local.hiclaw.io:18080"
python alert-bot\main.py

配置文件

文件 说明
team.yaml 声明式团队编排（Worker / skills / mcp / policies / 资源配额），对应 AgentTeams Team CRD
agents/manager/AGENTS.md Manager 调度 SOP、L0–L3 风险矩阵、审批话术、熔断规则
agents/manager/HEARTBEAT.md 心跳巡检例程（7 项巡检）
agents/{sentinel,forge,guardian}/SOUL.md Worker 身份定义与铁律
agents/*/skills/*/SKILL.md 12 个核心 Skill，按九要素定义（用途/输入输出/调用条件/依赖工具/失败处理/安全边界/复用价值/协同关系）
config/mcp-servers.yaml 8 个 MCP Server 注册与 allowedConsumers（真实凭证经 K8s Secret 注入网关）
config/higress-consumers.yaml Worker 级 GatewayKey 与权限矩阵，支持秒级熔断
config/docker-compose.observability.yaml OTel Collector + Prometheus + Grafana + PolarDB 可观测栈
config/rag-pipeline.sql PolarDB pgvector 表结构（RAG 向量 + 审计日志）
schemas/*.schema meta.json / evidence/INDEX.md 的 JSON Schema 数据契约
.env.example 环境变量模板（复制为 .env 后填真实值，切勿提交）

样例输入输出

输入：告警 webhook

curl -X POST http://127.0.0.1:5000/alerthook \
  -H "Content-Type: application/json" \
  -d '{
    "source_type": "github-issue",
    "severity": "P3",
    "service": "readme-docs",
    "summary": "README installation command outdated",
    "issue_url": "https://github.com/org/test-repo/issues/1",
    "date": "20260808",
    "seq": "01"
  }'

输出：接口响应

{"ok": true, "room_id": "!kAYnepJ7...:matrix-local.hiclaw.io:18080", "alias": "incident-20260808-01"}

输出：端到端任务产物（shared/examples/issue-20260808-01/）

issue-20260808-01/
├── meta.json          # 状态机 / approvals[] / retry_count
├── spec.md            # sentinel：任务规格（severity=P3，验收标准）
├── diagnosis.md       # sentinel：根因 + ≥2 条证据链 + 影响面
├── plan.md            # forge：修复方案 + 回滚预案
├── result.md          # forge：PR 链接 + CI 结果
├── verify-report.md   # guardian：逐项验收 pass/fail
└── evidence/INDEX.md  # guardian：证据归档（脱敏）

Matrix 房间协同消息流（节选）：

[Manager]  @sentinel 请 intake issue-20260808-01
[sentinel] ✅ intake 完成：README 安装命令过时（P3） spec: shared/tasks/.../spec.md
[Manager]  风险等级 L1，@forge 请生成修复方案并提 PR
[forge]    ✅ plan + PR #42 已创建，CI 通过
[guardian] ✅ verify-report.md：pass；evidence 已归档（脱敏）
[Manager]  ✅ issue-20260808-01 closed

运行证据

演示站点（demo/，纯静态，双击 demo/index.html 即可打开）

页面 内容
demo/leaderboard.html CodingRD-Bench 评测榜：7 维加权评分、能力雷达、与单 Agent 基线对比
demo/cases.html 任务回放对比：P1 告警闭环 / 多源去重 / 审批熔断 / 回滚复盘
demo/build-cases.html 实战演示：现场造应用，产物可直接交互（复刻微信、2048 小游戏）

评测打榜

任务回放对比

实战产物：Agent 协作生成的可运行应用

产物 说明
demo/artifacts/wechat-lite.html 微信风格 IM 界面：会话列表 / 聊天窗口 / 发消息与自动回复 / 四 Tab，单文件零依赖
demo/artifacts/game-2048.html 2048 小游戏：键盘 + 触屏双支持，计分 / 最高分 / 胜负判定
demo/artifacts/data-dashboard.html 研发效能数据大屏：KPI / 折线 / 柱状 / 环图 / 实时任务流，纯 SVG 手绘零依赖

录屏演示的逐镜头解说脚本见 submission/演示录制脚本.md。

实战演示

PoC 验证用例（操作手册见 hiclaw-coding-poc-runbook.md）

用例 场景 预期结果
T1 Issue → 修复 → PR 产出 PR 及全套任务产物
T2 L2 审批拦截 forge 不自合入，人工审批后放行
T3 权限熔断 回收 github-mcp 后写操作 403，转 needs-human
T4 验证失败返工 retry_count > 3 升级人工
T5 灰度发布确认 指标恶化触发 rollback-pending
T6 复盘 Skill 沉淀 postmortem.md + 新 SKILL.md（draft）

项目结构

├── agents/            # Manager + sentinel/forge/guardian 身份与 12 个 Skill
├── team.yaml          # 声明式团队编排
├── alert-bot/         # 告警/Issue webhook → Matrix 房间（运行入口）
├── config/            # MCP/网关治理、可观测栈、RAG 数据层
├── schemas/           # meta.json / evidence-index JSON Schema
├── scripts/           # apply-configs.sh 配置同步
├── shared/examples/   # 端到端样例任务产物
├── demo/              # 演示站点（评测打榜 / 任务回放 / 实战演示 + 产物）
├── submission/        # 项目方案材料（作品简介、方案 PPT、生成脚本）
└── docs/ + *.md       # 需求文档 / 方案设计 / 技术文档 / PoC Runbook

文档索引

文档 说明
hiclaw-coding-requirements.md 需求文档：功能/非功能需求、技术要求映射、验收标准
hiclaw-coding-multiagent-design.md 方案设计：角色编排/任务拆解/上下文传递 → AgentTeams 能力映射
TECHNICAL_DOCUMENT.md 技术文档：模块细节、测试记录、部署说明
hiclaw-coding-poc-runbook.md PoC 分步操作手册（T1–T6 可验证用例）
AGENT_IDENTITY.md Agent Identity 清单

License

Apache-2.0

About

面向企业软件研发场景的深度研究项目：以多 Agent 协同、角色权限治理、可观测审计、Skill 复盘沉淀为核心的 AI 算法与工程实现（基于 AgentTeams / HiClaw 构建）

Topics

agent-infraagentteamsai-codingdeep-researchhiclawmulti-agentpostmortemsoftware-rd

Resources

Readme
Apache-2.0 license
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages