diff --git a/agent.md b/agent.md index 424f81b..cf30556 100644 --- a/agent.md +++ b/agent.md @@ -158,3 +158,55 @@ docs/ - 相关验证已执行,或明确说明无法执行的原因。 - 变更符合第一版范围和数据/API 约束。 - 用户能根据结果继续下一步工作。 + +## Trellis 风格交付流程 + +后续功能按固定阶段推进。阶段之间必须有可检查的产物,不能把“代码能运行”直接当作需求完成。 + +### 1. 任务定义 + +- 用一句话写清用户问题、目标用户和期望结果; +- 写明本次包含内容和明确不包含内容; +- 确认是否属于个人品牌核心、配置包,或未来功能插件; +- 检查 PRD、ADR、数据模型和当前状态,记录冲突和假设。 + +产物:任务说明、范围边界、验收场景。 + +### 2. 方案边界 + +- 先定义领域对象、状态转换、权限边界和 API 契约; +- 涉及模板时,先定义声明、版本、安装快照、升级和回滚语义; +- 涉及数据时,先确定迁移兼容、旧数据默认值和恢复策略; +- 明确失败路径、空状态、重复提交和用户可见文案。 + +产物:必要时新增 ADR;否则在任务记录中写出数据、接口和 UI 方案。 + +### 3. 实现 + +- 先完成一个端到端的最小闭环; +- Controller、Service、DTO、API Client 和页面按既有边界分层; +- 任何新增 endpoint 必须同时新增授权测试和成功测试; +- 任何 schema 变更必须同时更新 migration、seed、运行时代码和测试; +- 不在实现过程中顺手扩大产品范围。 + +产物:可运行的代码、迁移和契约变更。 + +### 4. 验证 + +- API:未授权、错误角色、成功、业务校验失败和数据隔离; +- 数据:迁移可执行,旧数据可读,重复执行行为明确; +- UI:loading、empty、error、retry、success、mutation failure 和重复点击; +- 契约:API Client、DTO、响应 envelope 和页面调用一致; +- 运行匹配的 typecheck、integration tests、production build、format check。 + +产物:测试结果和剩余风险记录。 + +### 5. Code Review 收口 + +- 按用户场景重新走一遍,而不是只看 diff; +- 检查是否存在“已实现但未测试”的操作; +- 检查接口名称、产品文案和实际行为是否一致; +- 检查回滚、删除、升级等破坏性语义是否明确; +- 发现重复问题时,先更新本文件或 ADR,再开始下一项相关开发。 + +只有五个阶段都完成,且没有未解释的高风险项,才允许提交该里程碑。