| name | ai-collaboration-discipline |
| description | Execute non-trivial AI-assisted engineering work with focused scope, bounded tool calls, dense batch operations, proportional verification, explicit evidence, and recoverable handoffs. Use for coding, diagnosis, architecture, deployment, evaluation, real-device testing, document or slide editing, and multi-agent work—especially when efficiency scores are low, a task is becoming long-running, tool calls or retries are accumulating, commands or reads are repeated, the target is vague, or acceptance criteria are implicit. |
AI 协作节奏与效率守门
把复杂任务组织成边界明确、调用高密度、证据充分的短闭环。优化重复探索和过度验证，不通过省略必要证据来追求低调用数。
先锁定执行合同
首次调用工具前，从请求与现有上下文中确定：
现状：当前事实、失败或已有产物
目标：唯一交付物
位置：分支、文件、任务 ID、日志、服务或设备
边界：允许和禁止的动作
验收：证明完成所需的最小证据
预算：本任务的工具调用档位
- 能可靠推断时直接补齐；只有缺失信息会改变结果或授权边界时才提问。
- 解析“这个”“按上面做”等指代并点名确切产物后再行动。
- 区分回答、诊断、评审和实施；没有实施授权时不修改状态。
- 每次只保留一个活动目标；把顺手优化和下一里程碑列为非目标。
选择工具预算
预算是重新收敛的阈值，不是牺牲正确性或安全性的硬上限。
| 任务 | 建议调用预算 |
|---|
| 只读回答、单点确认 | 0–2 |
| 单文件小改、低风险文案 | 2–5 |
| 常规开发、文档或 PPT 修改 | 6–12 |
| 架构改造、线上诊断、真机任务 | 12–25 |
| 全仓审计、历史扫描 | 按阶段单独设预算 |
接近预算时暂停一次并判断：剩余不确定性是什么、哪次调用最可能消除它、是否已经满足验收。超出预算只能因为新证据、阻塞或强制门禁，不能因为重复确认。
执行 Efficiency 契约
- 先明确交付物和完成条件，再调用工具。
- 按任务风险设置工具预算；超出前先证明额外调用的必要性。
- 搜索、文件读取和只读检查尽量批量或并行执行。
- 不重复读取已经确认且底层状态未变化的信息。
- 一次性整理修改清单，然后批量实现，避免逐句修改和反复生成。
- 先做影响范围内的定向验证；仅在风险或仓库门禁要求时做最终全量检查。
- 满足验收条件后立即停止，不进行非必要延伸优化。
- 优先复用现有脚本、产物、会话结论和未过期的运行状态。
- 不创建不必要的 Subagent、计划更新、中间文件或展示性工具调用。
- 最终说明交付物、验证证据、未验证边界和未触碰范围。
提高单次调用的信息密度
每次调用必须至少产生一种价值：新事实、有效改动、完成证据或解除阻塞。否则不调用。
- 定位：优先一次
rg 找齐相关文件、符号、调用点和测试。
- 取证：合并读取关键区间、提交历史、日志和配置；避免从仓库入口重复发现结构。
- 实现：先形成完整改动清单，再集中修改相互关联的文件。
- 验证：先跑最小定向检查；通过后只补必需的最终门禁。
- 可视化产物：一次扫描全稿，一次批量修改，只渲染变化页面，最后做一次完整性检查。
- 外部状态：复用仍有效的进程、任务、截图和响应；状态未改变时不轮询式重复确认。
推荐默认链路：
一次批量定位
→ 一次集中取证
→ 一次批量实现
→ 一次定向验证
→ 必要时一次最终门禁
两败即诊断
- 第一次失败后记录动作、退出码、首个稳定错误和当前假设。
- 只有瞬态条件或前置状态已经改变时，才原样重试一次。
- 第二次等价失败后检查进程、端口、依赖、fixture、权限、环境或设备状态，或者切换方法；禁止第三次原样重试。
- 无法继续时报告阻塞证据和解除阻塞所需的最小外部动作，不用更多调用掩盖停滞。
按风险验证
| 改动 | 最小证据 |
|---|
| 结论或报告 | 区分已验证事实、合理推断和未知项 |
| 代码改动 | 受影响模块的定向测试 + 仓库规定的必跑门禁 |
| 文案或单页修改 | 目标内容检查 |
| PPT / UI 结构修改 | 变化页面渲染 + 文件或交互完整性 |
| 真机任务 | 任务 ID、最终截图、关键 trace 和成功判据 |
| 部署改动 | 实际端点、版本、配置与健康状态 |
用户要求提速或跳过检查时，明确列出省略的验证，不静默降低证明标准。
控制长上下文与 Subagent
- 阶段完成时压缩为：结论、改动、验证、风险、下一步；之后只携带摘要和仍有效证据。
- 不重新搬运完整历史，不重复解释已经冻结的决策。
- 仅在独立并行工作能节省净调用成本且权限允许时使用 Subagent。
- 给每个 Subagent 一个有边界的交付物；等待并合并结果，处理冲突，主任务结束前结束其生命周期。
停止条件
满足以下条件即结束：
- 唯一交付物已经生成或问题已回答。
- 约定的验收证据已经通过。
- 没有未处理的高风险错误或授权问题。
- 剩余工作只属于锦上添花或下一里程碑。
完成前检查：是否重复搜索或渲染、是否存在第三次等价重试、是否有无产出的工具调用、是否仍有未回收的 Subagent。发现任一问题时先收敛流程，再继续执行。
