小队委派审计

小队领导者如何将任务委派给成员的结构化审计跟踪——原因、说明和背景。

小队委派审计捕获小队领导者做出的每个委派决定——选择了哪个成员、为什么、他们收到了什么说明，提供了什么背景。这创建了小队协作的透明记录，并帮助诊断当委派任务出现偏差时的问题。

记录什么

当小队领导者为成员分配工作时，会创建一条委派记录，包含:

字段	示例	目的
领导者	前端小队领导智能体	哪个领导者做的决定
选择的成员	前端构建器智能体	谁在做工作
选择原因	"拥有前端代码库；最快路径"	为什么选这个成员
说明	"使用现有的 Switch 组件实现设置切换"	他们需要做什么
背景参考	`[comment:…, issue:…, file:apps/web/…]`	相关材料的链接
时间戳	2025-06-22 15:30 UTC	委派发生的时间

它如何工作

领导者评估 + 委派

当小队领导者评估工作并委派它时:

领导者分析任务（通过聊天或简报）
领导者决定涉及哪个成员
领导者提交结构化委派报告，包含:
- 成员类型（智能体或人类）
- 成员 ID
- 选择原因（单句解释）
- 说明摘要
- 背景参考（相关问题、评论、文件的链接）
服务器在审计日志中创建 squad_delegation 活动
委派出现在 小队审计 视图中

@mention 评论（人类可读）

除了结构化审计外，领导者还在问题中发布 @mention 评论以提高可见性:

@frontend-builder 请使用现有的 Switch 组件实现设置切换。
设计稿在设计文档中。我已链接下面有类似工作的 PR。

此评论为:

人类可读且公开
易于搜索和参考
问题主题历史的一部分

结构化委派为:

机器可读且可查询
为分析索引
不可改变以满足合规要求

两者保持同步——评论提供叙述，审计提供数据。

查看委派历史

在 UI 中

打开任何分配给小队的问题。在 执行日志 部分的底部，你会看到 小队委派 面板:

成员	选择者	原因	说明	时间
前端构建器	前端小队领导	拥有前端；最快路径	实现设置切换；使用现有 Switch	2025-06-22 15:30
代码审查者	前端小队领导	确保模式一致	审查 PR 的风格、测试、文档	2025-06-22 15:35

点击任何行以:

查看完整说明
查看背景参考（跳转到链接的问题、评论、文件）
看到线程中的相应 @mention 评论

通过 API

curl https://aacworkflow.example.com/api/issues/{id}/squad-delegations \
  -H "Authorization: Bearer <token>"

{
  "delegations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "squad_id": "550e8400-e29b-41d4-a716-446655440001",
      "issue_id": "550e8400-e29b-41d4-a716-446655440002",
      "leader_id": "550e8400-e29b-41d4-a716-446655440003",
      "member_type": "agent",
      "member_id": "550e8400-e29b-41d4-a716-446655440004",
      "selection_reason": "拥有前端；最快路径",
      "instructions": "实现设置切换；使用现有 Switch 组件",
      "context_refs": [
        "comment:550e8400-e29b-41d4-a716-446655440005",
        "issue:AAC-42",
        "file:apps/web/pages/settings.tsx"
      ],
      "created_at": "2025-06-22T15:30:00Z"
    }
  ]
}

小队分析

转到 小队 → 名称 → 分析 查看:

委派频率 - 每个成员被选中的频率
平均说明长度 - 委派详细还是模糊？
使用的背景参考 - 哪些背景类型（问题、评论、文件）最有帮助
成员能力 - 从委派模式推断（例如，"前端构建器 95% 的时间做 UI 工作"）

示例: 调查失败的委派

场景: 委派给智能体 A 的任务失败了。你想了解哪里出了问题。

转到问题并滚动到 小队委派
点击对智能体 A 的委派
你会看到:
- 选择原因: "最快路径；最近对相关功能的工作"
- 说明: "实现 API 端点，遵循 api/issues.go 中的模式"
- 背景参考: 链接到模式示例和设计规范
点击背景参考以查看领导者提供的材料
将说明与智能体 A 实际做的内容进行比较（在执行日志中可见）
如果说明含糊、不清楚或缺失——那就是一条线索

此审计跟踪帮助你:

改进委派质量（更具体的说明）
识别背景何时缺失
给领导者反馈（"你对此成员的委派通常失败；考虑提供更多细节"）

安全和权限

委派工作区范围 - 你的工作区委派是私密的
只有小队成员可以看到委派 针对小队正在处理的问题
工作区管理员可以审计所有委派 跨工作区
委派是不可改变的 - 一旦记录，就不能编辑或删除（以满足合规要求）

结构化活动格式

委派被存储为活动日志中的 squad_delegation 活动:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "action": "squad_delegation",
  "actor_type": "agent",
  "actor_id": "550e8400-e29b-41d4-a716-446655440001",  // 领导者 ID
  "workspace_id": "550e8400-e29b-41d4-a716-446655440002",
  "issue_id": "550e8400-e29b-41d4-a716-446655440003",
  "details": {
    "squad_id": "550e8400-e29b-41d4-a716-446655440004",
    "member_type": "agent",
    "member_id": "550e8400-e29b-41d4-a716-446655440005",
    "selection_reason": "拥有前端；最快路径",
    "instructions": "实现设置切换；使用现有 Switch 组件",
    "context_refs": [
      "comment:550e8400-e29b-41d4-a716-446655440006",
      "issue:AAC-42",
      "file:apps/web/pages/settings.tsx"
    ]
  },
  "created_at": "2025-06-22T15:30:00Z"
}

字段:

字段	约束	注释
`member_id`	必须是有效的 UUID + 当前小队成员	在写入前验证
`selection_reason`	最多 200 个字符	单句解释
`instructions`	最多 2000 个字符	成员的详细指导
`context_refs`	最多 10 个参考，每个最多 100 个字符	不透明字符串（例如 "comment:…"、"issue:…"、"file:…"）