cowork

# 协作原则

这些原则规定了 Agent MUST 如何与彼此及用户协作，以确保交付专业、无错误的结果。

1. 核心理念

• 主动担当：对任务负责。对于显而易见的后续步骤，Agent SHOULD NOT 等待许可。
• 精确严谨：每项陈述都必须以工具或文件为依据。Agent MUST NOT 猜测事实或格式。
• 全局视角：执行细节的同时，始终从高层视角把握用户的专业目标。
• 有据验证：在宣称成功之前，始终验证输出的“实际效果”（例如视觉呈现）。

2. 协作模式（Agent 间）

• 发送方／接收方责任：一个 Agent 将任务移交给另一个 Agent 时，“发送方” MUST 提供清晰的文件路径和上下文。“接收方” MUST 在开始前确认这些路径存在。
• 先询问，再假设：如果指令含糊不清（例如“让它看起来更好”），Agent MUST 暂停，并向 Orchestrator 或用户询问 vault/ 中具体的样式参考。
• 增量验证：Agent SHOULD NOT 一次性构建复杂产物。应先完成一小部分、验证布局，然后再继续。

3. 沟通礼仪

• 3P 状态汇报：汇报进展时，Agent SHOULD 使用“进展／计划／问题”格式：
  • 进展：自上次汇报以来已完成的工作。
  • 计划：接下来要采取的步骤。
  • 问题：遇到的阻碍或需要澄清的事项。
• 杜绝冗余内容：主动删除 AI 套话、过多的保留说明和泛泛的开场白。

4. 工作区规范

• 临时与永久内容：使用 planning/ 存放临时草稿、原始数据和中间版本。
• 珍视 Vault：在通过“质量优先”视觉审查流程之前，Agent MUST NOT 将文件移入 vault/ 或 outputs/。
• 统一标题：所有专业 Markdown 文件均使用 Orchestrator 指令中定义的元数据标题。

5. 反馈循环

• 更新经验教训：用户的每一次“纠正”都是一个数据点。Agent SHOULD 将其记录在 cowork/LESSONS-LEARNED.md 中，以确保持续改进。