中台目录 / 组织管理 / Agent 团队建设与中台管理系统 · 技术方案细则 V1.2

Agent 团队建设与开发中台管理系统 · 技术方案细则 V1.2(10 Agent 定稿版)

一、老板历史需求 → 当前落点(需求台账)

#你的需求当前落点状态
1组织架构定稿、岗位有 Agent组织架构 V6.9;10/10 岗有 Agent✅ 定稿
2岗位职责、权限、交付通道岗位体系 V3.3;N-034 交付通道(_staging→PJM 搬→BOSS/deliver→md5→ack)✅ 定稿
3授权可验证、不可伪造授权机制 V1.1(Ed25519 + nonce + 原子 usedBy + 7 天 legacy)🟡 设计完成,待上线
4需求编号与日期失真A 方案:保留分档号 + createdAt + 来源消息 id + 原话指针(N-053)✅ 已拍板
5唤醒顺序shift-start 三看 → 收件箱/任务/交流区 → 开工 → ack + 四块汇报🟡 规范有,上岗包待写入
6岗位饱和度、是否加人统计报告:在办 6、856 张"已替换";结论=先不加人,先清存量/压返工✅ 已出
7Agent 自动化开发体系诊断与最简方案 + 全球实践研究 + 本 V1.1✅ 本稿
8让 DeerFlow 去搜索Gateway 已起(8001),本地 SearXNG 未运行、DB 只读 → 检索失败⏳ 待修 SearXNG
9叫醒/运行时叫醒落地清单:7/10 岗无定时器;N-081 要求"运行时证据"🟡 待补
10Agent 沟通MWN 三件套(收件箱+任务库+交流区+抄送 PJM);sync3.py;pending 115 条重复🟡 工具在,去重未清
11代码治理路线:先功能 → git 止血 → 重构;server.js 10,716 行、0 测试、1,429 个 .bak🟡 待执行
12交付/发布/回滚deliver-watch + md5 + 自动回滚 + 内容级校验要求✅ 机制在,需常态化
13权限/审批/越权七步变更、白名单、A0–A4、授权令牌🟡 待落 A0–A4
14平台系统chat-svc、任务库、交流区、收件箱、deliver-watch、shift-start、check-4tables、check-ack-timeout、gen-roles、sync3、onboard-ack、page-lock、authz、svc-exec、system-smoke✅ 有,缺统一中台
15风险事件冒签误判、授权过期、假上线、P0 卡住、Agent 离线✅ 已暴露,需登记册

二、现有系统盘点(有什么、缺什么)

层已有资产状态
组织10 岗 + S1–S3;主数据 10 行;名册 10 岗/22 条;任职台账 10 行有,但角色偏多
规范55 条 N-001~N-055;岗位体系 V3.3;组织架构 V6.9;端到端流程 V1;沟通机制 V1;代码治理;叫醒机制;授权 V1.1;需求编号 A有,偏多/多版
任务任务库 1,036 张;在办 6;"已替换" 856(83%);需求池 131 条(6 天零新增,43 条"今天"是编号假象)数据有,质量差
沟通交流区(总群已并入);收件箱;sync3/MWN;onboard-acks;pre-report有,pending 115
执行shift-start 三看;check-ack-timeout;check-4tables;gen-roles;deliver-watch;event-publish;svc-exec;system-smoke 21 项有,缺定时器/统一 runner
安全authz.jsonl(自由文本签发,V1.1 设计中);secrets 明文目录;page-lock 文件弱
观测事件日志(部分);无统一 run 记录;无 DORA 看板;facts-snapshot 未建缺
代码server.js 10,716 行、484 if、52 重复路径、0 自动测试、1,429 .bak;前端无构建弱

三、诊断(7 个真差距)

  1. 纸面—运行时断层:7/10 岗无定时器;规范/上岗包 ≠ 运行时条目;N-081 自认。
  2. 角色偏多(已定保留 10 个,靠机制压协调):10 个 Agent 服务 6 张在办卡;PJM 24h 127 条消息协调过载;FE 历史 421 张、405 张被替换。
  3. 需求入口不稳:131 条池 6 天零新增;IA 三件套未出;自动派单曾把运维回执派 8 个子节点(零新增卡)。
  4. 工程底座薄:单体 10.7k 行、0 测试、1,429 备份、52 重复路由 → 返工放大器。
  5. 事实源分散:多版文档、856 替换卡、68% 聊天消息无数字 id、pending 115。
  6. 安全可伪造:secrets 明文;authz 自由文本;同机同用户可读密钥。
  7. 指标缺失:无 DORA/Agent 指标,无法判断"加人/扩量"是否有效。

四、目标架构(5 层 + 10 个 Agent + 3 条铁律)

```

L0 入口:1 个 Backlog(需求/任务卡) ← 老板只说需求

L1 编排:Orchestrator(PJM) ← 拆解/派工/WIP/催办/日报

L2 执行:10 岗 Agent(FE/UI-ENG/BE/PD 各自 1 个) ← 隔离 worktree + sandbox

L3 验证:QA/Reviewer + CI ← 测试/评审/门禁

L4 发布:Platform/SRE + CI/CD ← 发布/回滚/观测/成本

横切:MCP(工具)、A2A(可选)、Vault(密钥)、Event Log(事件)

```

三条铁律

  1. 单一入口:老板只对 PJM 说需求;PJM 只对任务库建卡;其他岗位不接口头派单。
  2. 单一事实源:需求库/任务库/事件日志/发布台账各 1 份;文档自动生成,不手写多版。
  3. 运行时优先:任何 Agent 必须同时有"定时器 + 收件箱 + 门禁 + 证据";无定时器 = 未上岗。

五、岗位职责与规范(整合版)

5.0 组织架构(现行:10 岗 + 3 系统角色)

编号岗位代号agentNo上报状态
01项目经理岗·PJMPJMAG-01-0001老板在岗
02后端岗·BEBEAG-02-0001老板在岗
03前端实现岗·FEFEAG-03-0001老板在岗
04前端页面岗·UI-ENGUI-ENGAG-04-0001老板在岗
05设计岗·PDPDAG-05-0001老板在岗
06测试·评测岗·QAQAAG-06-0001老板在岗
07调研·知识岗·RARAAG-07-0001老板在岗
08产品岗·PMPMAG-08-0001老板在岗
09架构岗·ARCARCAG-09-000101在岗
10平台岗·SRESREAG-10-000101在岗
S1–S3执行体 / 值班总管 / 红队系统—老板启用

5.0b 岗位职责(现行 10 岗,原文保留)

岗位使命(一条主线)交付物不做什么(边界)
PJM平台/裁判:派单、门禁、发布、裁决、播报、应急任务卡、发布记录、裁决单、日报不写业务页、不改业务接口
BE接口/数据/联调/契约接口 + curl 证据 + 契约不写页面视觉、不发布页面
FE页面实现/自测/接口对接可过门禁的单文件页 + 自测不改后端逻辑、不改设计规范
UI-ENG页面骨架/正式页落地/布局交互正式页(过 P1–P9)+ assets不改后端接口、不改他人页面
PD视觉规范/高保真稿/组件库/预览位设计稿 + 规范不写正式页、不写接口
QA独立验收/评测/回归PASS/FAIL + 证据 + 评测报告不修实现、不改设计
RA调研取证/规范草案/知识库调研报告、规范草案、决策记录不出页面、不写接口、不派单
PM需求入口:原话→定稿→归类→拆分→DoD定稿需求、子需求列表、DoD不写代码、不派单、不改归属
ARC架构/ADR/契约/技术否决ADR、契约(版本+哈希)、评审单不写实现、不改流水线、不判验收
SRE流水线/发布门禁/观测/成本平台变更单、SLO 报告、回滚方案不写实现、不定架构、不判验收

5.0c 组织架构与 10 Agent 编制的关系(定稿)

  1. 单一入口:老板只对 PJM 说需求,其他 Agent 不接口头派单;
  2. WIP 上限:每岗 ≤3 张在办(PJM/RA ≤3,PD/ARC/SRE/PM ≤5,QA ≤6,FE/UI-ENG/BE ≤3);
  3. 小批量:一卡一 PR,单 PR ≤400 行,减少跨岗等待;
  4. 值班调度 S1:帮 PJM 做催办/巡检/播报,避免 PJM 24h 127 条消息的过载;
  5. 页面锁 page-lock:FE 与 UI-ENG 同页必须分时/分域,改 owner 走迁移单;
  6. 每日摘要:PJM 出一条"在办/红灯/待批",其他 Agent 只读摘要,不刷群。

5.1 Agent 团队编制(10 个,一岗一 Agent)

#Agent(岗)使命关键产物边界权限WIP定时器
01PJM唯一入口、拆解、派工、门禁、发布、裁决、日报任务卡、切片、发布记录、日报不写业务页/接口A1 + 发布执行(需授权)≤3每 2h
02BE接口/数据/联调/契约小 PR + curl 证据 + 契约不写页面视觉/不发布页面A2≤3每 2h
03FE页面实现/自测/接口对接小 PR + 截图/自测证据不改后端逻辑/设计规范A2≤3每 2h
04UI-ENG骨架/正式页/布局交互正式页(P1–P9)+ assets不改后端接口/不改他人页A2≤3每 2h
05PD视觉规范/高保真/组件库/预览位设计稿 + 规范 + 组件库不写正式页/不写接口A1≤5每日 09:00
06QA独立验收/评测/回归PASS/FAIL + 证据 + 评测报告不修实现/不改设计A1(可否决)≤6每 2h
07RA调研取证/规范草案/决策记录/评测报告、规范、评测集不出页面/不写接口/不派单A0/A1≤3每日 09:00
08PM原话→定稿→IA→DoD定稿需求、IA 三件套、DoD不写代码/不派单/不改归属A1≤5每 2h
09ARC架构/ADR/契约/技术否决ADR、契约(版本+哈希)、评审单不写实现/不改流水线/不判验收A1≤5每日 09:00
10SRE流水线/发布门禁/观测/成本/回滚平台变更单、SLO、回滚方案不写业务/不定架构/不判验收A3(发布需人签)≤5每 2h
硬规则:10 个 Agent 每个都必须在运行时配定时器/心跳(上表"定时器"列);无定时器 = 未上岗。协调成本用 §5.0c 的 6 条机制压住。

5.2 12 条"必须"规范(把 55 条瘦身,其余作引用)

#规范对应旧规范
R1单一 Backlog,群聊/口头不算需求N-053/N-062
R2任务卡四要素:原话指针/目标/验收/期限N-059/N-064
R3缺 spec/IA/DoD 不开工N-064
R4一卡一 PR,单 PR ≤400 行,超了拆新
R5确定性门禁由系统跑:format/lint/type/unit/coverage/secretN-067/N-069
R6作者不自批,评审人与作者分离(Agent 同)新
R7发布授权=具名审批人 + 令牌,发起者不得自批授权 V1.1
R8发布后内容级校验(标题+指纹+运行时标记),不看 200新
R9每次发布带回滚点 + 一键停机开关新
R10全链路事件日志:建卡/领卡/门禁/评审/发布/回滚N-042/N-046
R11最小权限 + 密钥 Vault/ACL,Agent 不可读授权 V1.1/OWASP
R12指标周看:DORA 5 + Agent 4,只改瓶颈新
55 条规范保留为"引用库",不再逐条扩写;新规则只进这 12 条,避免规范膨胀。

5.3 RACI(关键节点)

下表 "Builder" 指实现类三岗合计(02 BE / 03 FE / 04 UI-ENG);具体到某张卡,按页面/接口归属定唯一实现人(page-lock),不由三岗同时做。
节点PJMPMARCBuilder(BE/FE/UI-ENG)QASRE老板
需求登记RCIIIIA
规格/IACRCICIA
架构/契约CCRICII
切片/派工RCCIIII
实现IICRIII
验证ICCCRII
发布授权RICICCA
发布/回滚CIIICRI
观测/回写RCCCCCI

六、各节点协作自动化落地方案(N1–N12)

每个节点:触发 → 执行 → 自动化手段 → 产物 → 门禁 → 人工点 → 失败处理 → SLA。
#节点触发执行自动化手段产物门禁人工点失败处理SLA
N1需求登记老板原话/群 @PJMsync3 建卡 + 来源 id + 需求库任务卡四要素齐老板确认范围缺原话退回10 min
N2规格/IA任务卡Specspec 模板 + IA 三件套 + DoDspec.md/IADoD 可判老板/PM 审退回重写4h
N3架构/契约specArchitectADR + 契约 + linter 规则ADR/契约状态枚举唯一ARC 签退回4h
N4切片/派工spec 批准PJM切片模板 + WIP 队列切片卡≤400 行/不跨模块无拆大卡1h
N5实现切片卡Builderworktree + sandbox + 分支代码/页面lint/type/unit 绿无回滚/重试1–2 天
N6自验实现完成Builder测试/截图/日志/内容校验证据全绿无自修1h
N7独立验证PR 打开QA/Reviewer独立上下文 + spec 对照PASS/FAIL + 证据逐条验收高风险人审打回2h
N8评审/合并验证 PASSQA + 人作者不自批 + 风险分级评审记录无自批高风险人拒合并4h
N9发布授权合并后老板/发布经理授权令牌 + 具名审批授权记录指纹+回滚点老板批拒绝发布30 min
N10发布/灰度授权通过Platformdeliver-watch + canary + md5发布记录线上 md5=交付 md5无自动回滚10 min
N11观测/回滚发布后Platform日志/指标/trace + 健康检查SLO/告警5xx/延迟阈值值班回滚 + 事故单5 min
N12回写/知识关闭PJM + RA事件日志 + ADR + 复盘复盘/知识无无补录1 天

跨节点自动化(必须已有/补齐)

七、开发中台管理系统技术方案

7.1 模块(12 个)

模块作用现状
需求库 REQ原话/来源/状态/优先级131 条,需 A 方案回填
任务库 TASK卡/owner/状态/验收/依赖有,856 替换需清
运行记录 RUN每次 Agent 运行的输入/工具/成本/结果缺
事件日志 EVENT建卡/领卡/门禁/评审/发布/回滚部分有
发布台账 RELEASE产物指纹/审批/回滚点/校验部分有
授权 AUTHZcode/scope/签发/过期/使用V1.1 待上线
身份权限 IAMAgent 身份/A0–A4/工具白名单缺
密钥 VAULT密钥/ACL/轮换弱(明文)
观测 METRICDORA 5 + Agent 4 + SLO缺
评测 EVAL20 条真实任务 + LLM judge缺
知识 KBAGENTS.md/ADR/规范/复盘有,多版
看板 BOARD在办/WIP/红灯/指标缺

7.2 数据模型(最小字段)

```json

TASK: {taskId, reqId, title, owner, status, priority, specId, sliceNo,

branch, worktree, acceptance[], gates[], artifacts[], ackAt, deadline, parent}

RUN: {runId, taskId, agent, model, start, end, tokens, tools[], result,

diffHash, traceId, approveBy}

EVENT:{eventId, ts, type, actor, taskId, payload, evidence}

AUTHZ:{code, action, scope, issuedBy, messageId, nonce, sig, keyId,

ttlMin, expireAt, status, usedBy[]}

RELEASE:{releaseId, taskId, artifactMd5, target, approver, tokenCode,

verify, rollbackPoint, rolledBack}

```

7.3 接口(现有/待建)

接口状态
/api/data/tasks CRUD、/api/zt/task/ack✅ 有
交流区 sends/read、收件箱 MWN✅ 有
shift-start、check-4tables、check-ack-timeout、gen-roles✅ 有
deliver-watch 发布/回滚、page-lock✅ 有(需常态化)
authz request/issue/verify/revoke🟡 V1.1 待建
run 记录、eval、board、facts-snapshot❌ 待建

7.4 运行时

7.5 非功能

八、风险把控与措施

8.1 风险登记册(21 项)

#风险早期信号预防检测响应owner
1质量返工替换率>30%小 PR/门禁/测试周指标停扩量、回规格QA
2评审瓶颈PR 周期变长切片≤400 行/Agent 互审PR 周期分层评审PJM
3Agent 自审自批作者=评审角色分离/权限审计拒合并+记违规QA
4假上线200 但内容错内容级校验发布校验回滚SRE
5授权伪造无签名/自由文本Ed25519+ACL+nonce签名校验拒绝+吊销SRE
6授权过期停摆到期未续到期告警+备份审批人令牌状态重签PJM
7密钥泄漏secrets 被读Vault/ACL/最小权限访问审计轮换+停权SRE
8注入越权仓库/网页含指令工具输出不可信/策略层越权日志阻断+复盘ARC/红队
9Agent 离线/幽灵超时无响应定时器+心跳离线告警唤醒/换实例PJM
10需求歧义返工/追问多四要素+DoD澄清轮次退回重写PM
11大 PRdiff>400切片门禁CI拆 PRFE/UI-ENG/BE
12上下文过期文档久未更新自动生成/每日刷新新鲜度重生成RA
13文档多版同名多版本单一事实源版本校验归档旧版PJM
14任务卡膨胀856 替换归档/去重/停建周清理批量归档PJM
15平台单点server.js 故障模块拆分/回滚健康检查回滚/重启SRE
16成本失控token 超预算预算/模型路由成本看板降级/停任务SRE
17供应链风险依赖漏洞锁版本/扫描依赖扫描升级/隔离SRE
18合规/数据出境敏感数据外发分级/出网白名单DLP阻断老板/安全
19单点审批只有 1 人能批备份审批人审批覆盖率授权代理老板
20指标自嗨只报生成行数双账本指标审计改口径RA
2110 Agent 协调过载跨岗等待变长、交接次数上升单一入口 + WIP + 每日摘要 + S1 值班跨岗交接次数/等待时长拆卡/减少交接/加摘要PJM

8.2 五类控制

  1. 门禁控制:确定性门禁 + 内容级校验 + 回滚点;
  2. 权限控制:A0–A4 + 工具白名单 + 任务级令牌 + Agent 不可读密钥;
  3. 人控点:只保 3 个门(范围/发布/风险)+ 备份审批人;
  4. 停损线:接受率<40% 两周 / 失败率恶化>50% / 单 PR 成本>1.5× 人工 / 替换率>30% → 停扩量;
  5. 应急:一键停机、回滚演练(每月)、红队抽审、事故复盘。

九、落地路线(Phase -1 → 3)

Phase -1(第 0–4 周)补工程底座(不写业务 Agent)

任务验收
git 止血(提交历史/分支保护)可回滚任意版本
CI 四件套(format/lint/type/unit)一条命令本地复现
system-smoke 21 项升 CI 必过21/21
模块拆分(每次 10 条路由)routes 模块 + 全绿
清 1,429 .bak / 52 重复路由数量降为 0/个位数
单事实源(需求/任务/事件/发布)4 个库唯一
环境拉起 <60 秒连续 10 次达标

Phase 0(第 1–3 周)团队与中台骨架

Phase 1(第 4–8 周)一条端到端样板

Phase 2(第 9–16 周)并行 2–3 条

Phase 3(第 17 周起)受控自治

30/60/90 天清单

十、指标(先基线,后目标)

指标基线(现在)90 天目标
变更前置时间未测建立基线,下降 30%
部署频率未测≥1 次/天
失败恢复时间未测≤30 分钟
变更失败率未测≤15% 且不恶化
部署返工率未测≤10%
替换/返工率83%≤30%
Agent 一次通过率未测≥50% → 70%
人工介入/需求高≤3 次
跨岗交接次数未测逐季下降(10 Agent 协调成本核心指标)
单 PR 成本未测低于人工 1.5×

十一、附录

A. 模板包

B. 10 岗 → 10 Agent(一一对应,不合并)

岗Agent岗Agent
01 PJMPJM06 QAQA
02 BEBE07 RARA
03 FEFE08 PMPM
04 UI-ENGUI-ENG09 ARCARC
05 PDPD10 SRESRE

C. 与母版(Trae 31KB)差异

D. 来源

整合稿·待老板拍板 | 未改任何生产配置
生成 2026-11-01 17:05|中台目录 · 组织管理|原件:{原件路径}