From 292b398ed7e32712273f8e04469ba6c6d4befa21 Mon Sep 17 00:00:00 2001 From: que01 Date: Sun, 20 Sep 2026 23:18:40 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=9B=BA=E5=8C=96=E5=88=86=E9=98=B6?= =?UTF-8?q?=E6=AE=B5=E4=BA=A4=E4=BB=98=E4=B8=8E=E8=AF=84=E5=AE=A1=E6=B5=81?= =?UTF-8?q?=E7=A8=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- agent.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) 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,再开始下一项相关开发。 + +只有五个阶段都完成,且没有未解释的高风险项,才允许提交该里程碑。