AI Agent 通用协作总览图
角色分工 · 通用流程 · Prompt 骨架 · CLI 语义 · 验收清单（点击页签切换）
协调者总控
- 拆解需求、写验收标准
- 派活、汇总、最终验收
- 维护交接单与记忆
实现者Builder
- 写代码/改文件/搭页面
- 单一写入边界
- 分阶段小步提交
验证者Verifier
- 对抗测试、边界探测
- 回归、定位真实缺陷
- 独立于实现者
研究者Researcher
- 查资料、读文档、核事实
- 来源溯源、区分事实/推断
多模态浏览器/桌面/视觉
- 浏览器自动化、桌面操作
- 读图/生成图、音视频
- Office/PDF/可视化
黄金规则：先读交接单 → 单写入者 → 实现≠验收 → 证据 E1 起 → 部署/发布需人工批准。
① 定义目标 + 给谁用 + 成功标准
→
② 调研先读现状/文档/竞品，禁止上来就写
→
③ 契约范围 + 边界 + 验收标准，让 Agent 复述
→
④ 最小一版骨架 + 一个代表模块
→
⑤ 独立核验验证者挑毛病
→
⑥ 扩展+全量验收桌面/移动/无障碍/安全
防翻车关键：不要一次让 Agent 做完整系统；先做最小可验证一版，通过后再扩展。
任务 6 要素
- 目标（一句话）
- 背景/上下文（路径+资料）
- 范围与边界（只改这些）
- 验收标准（可检查清单）
- 约束（规范/禁止项）
- 输出格式（DONE+证据）
约束模板
只修改：<列表>
不读取无关内容
UTF-8 无乱码
console 0 错误 / 0 404
回复 DONE + 证据清单
调研防幻觉
区分：已核实/推断/观点
每个数字追溯原始来源
找不到就说"未核实"
禁止把营销文案当结论
执行与续接
agent # TUI
agent exec "任务"
agent resume --last # 续接
agent fork # 派生分支
质量与审查
agent review --uncommitted
agent apply # 应用 diff
agent exec -m 模型 -s read-only
环境与工具
agent models
agent mcp add/list
agent doctor
agent login
拿到新 CLI 第一步：agent --help && agent exec --help，再把通用语义映射到真实命令名。
验收检查单
构建/测试退出码 0
逐条对照验收标准
边界与回归
移动端/小屏
键盘可达 + reduced-motion
console 0 错 / 0 404
无示例文字/占位图
安全扫描通过
证据分级：E1 可复现（命令/退出码/截图/URL）＞ E2 同体系互检 ＞ E3 自证（无效）＞ E4 待验证。验收最低 = E1。