treills 交付物清单与实现流程

本文适用于使用 treills 工作流驱动 AI 编码的场景。你会学到:每个开发任务必须产出的三份交付物,以及从评审到执行的标准流程。

交付物清单

每个任务在进入编码前,必须先产出以下三份文档:

文件内容
prd.md需求与验收标准
design.md技术设计
implement.md执行计划

三份文档按「做什么 → 怎么做 → 按什么顺序做」逐层细化。prd.md 未通过评审前不写 design.md,避免在错误的需求上做设计。

实现流程

标准流程固定为四步,顺序不可跳过:

review 通过 → task.py start → dispatch
  1. review:评审 prd.md / design.md,确认需求与设计。
  2. task.py start:通过任务脚本启动任务,锁定交付物。
  3. dispatch:按 implement.md 的执行计划派发编码。

该流程与 OpenAI Agent 技能(skill)组织方式一致:把规范、清单写进技能文件,让 AI 按文件执行而非凭记忆发挥。参考 OpenAI Agents SDK 文档

验证与自查

  1. 编码开始前检查三份交付物是否齐全,缺失则退回 review 阶段。
  2. implement.md 中的每步完成后,对照 prd.md 的验收标准逐条勾选。
  3. 任务收尾时确认执行顺序为 review → task.py start → dispatch,无跳步。

参考