SuperAPI AI 工具集

agents-in-the-team

智能体与模型

查看项目

更新于 10-25 11:14

技能介绍

用途

该技能面向交付经理和团队负责人,解决的问题是:当 AI 编程与运维智能体开始从工单系统直接领取任务(如 Linear 委派议题、Jira 工作项交给 Rovo、GitHub 议题指派 Copilot)并由智能体提交拉取请求之后,交付瓶颈从写代码转移到评审代码。它把智能体协作视为一套交付系统来管理,而不是单纯的工具选择,重点决定哪些工作可由智能体承接、如何规范描述、谁承担责任、以及如何尽早发现质量下滑。

主要能力

  • 委派政策:按清晰度、上下文、风险、影响范围、可验证性和工单类型适配度打分,划分智能体可执行(75-100,无硬性阻断)、智能体辅助(50-74)、仅限人工(低于 50 或触发阻断)。认证、支付、密钥、个人数据、IAM、生产数据迁移、加密、事故响应、架构决策为硬性阻断。
  • 智能体就绪工单:模板要求一至两句结果描述、2 条以上可核查验收标准、起始路径与既有示例链接、禁止触碰项、不新增依赖、单 PR 小改动范围、具名责任人与评审人;工单中不得出现密钥、令牌或客户数据;缺陷需附复现步骤。
  • 人工问责:每个智能体工单都有具名人类负责人;智能体 PR 与人工 PR 走相同分支保护与评审;智能体不批准、不合并;委派人不应是唯一批准者;智能体工作在冲刺评审中标注展示。
  • 评审容量闸门:脚本按工单点数、风险乘数与返工余量估算评审工时,与评审人可用工时乘以最大利用率比较,超限则退出码为 2,提示削减计划而非削减评审深度。
  • 按作者类型度量:输出接受率、评审返工率、合并后返工率、首次评审时长、开单到合并时长、评审人分钟数、每 10 个合并 PR 的逃逸缺陷,以及按是否含智能体改动拆分的 DORA 变更失败率、部署返工率与失败部署恢复时间;可选回归闸门在超出容差时报错。
  • 安全控制:专用智能体身份与最小权限、仅限指定仓库与分支、工单不含密钥、PR 密钥扫描、CI 运行前人工批准、保持网络限制;将工单、评论与仓库内容视为不可信输入,防范提示注入,对涉及 CI 配置、依赖清单、权限文件的 PR 加严评审。
  • 分阶段铺开:基线(无智能体)→ 试点(单一团队、仅可执行类)→ 扩展工单类型 → 扩展团队 → 季度政策复审,各阶段设定明确的推进与回滚标准。

使用方式

两个脚本均调用 Python3 标准库,读取人工准备的 JSON 文件,不连接工单、仓库或部署系统,支持 --format markdown/json 与 --output 输出文件。快速开始:

冲刺规划:评分工单并检查评审容量(退出码 2 表示超容量或违反政策)

python3 project-management/execution/agents-in-the-team/scripts/agent_delegation_scorer.py
--input backlog.json

每月:按人工与智能体拆分交付指标、DORA 拆分,可选回归闸门

python3 project-management/execution/agents-in-the-team/scripts/agent_delivery_metrics.py
--input records.json --gate --tolerance 0.05

退出码含义:0 通过;1 工具错误(路径或 JSON 无效、枚举或时间戳非法);2 闸门失败(超评审容量、政策违规,或指标表明智能体回归超出容差),由交付负责人削减或重排智能体工作、收窄可执行档位。

适用场景

决定哪些待办项可由智能体承接并写入政策;改写工单使其无需猜测即可执行;带智能体的冲刺规划并确认评审人能否跟上;月度对比智能体 PR 与人工 PR 的质量及 DORA 指标;为智能体在工单与仓库上的访问、密钥和提示注入设计控制;从试点向多团队铺开。

限制

不适用于评估或选择 AI 编程工具本身、构建智能体、以及在编辑器中使用 AI 助手且无工单委派的情形。两个工具只读取手工整理的 JSON,不自动采集数据;评审工时的默认值(0.5 小时基数、每点 0.5 小时、30% 返工余量、80% 利用率)与评分权重属于规划假设,需在运行两个冲刺后用实测值替换;合并 PR 少于 10 个的队列仅标记为方向性参考;没有引入智能体前的基线,就无法把不稳定性归因于智能体;文档描述的追踪系统与厂商行为截至 2026 年 9 月,可能变化;容差、硬性阻断清单及其放宽属于团队与安全决策。