docs(workflow): complete H-414 cross-agent gates

2026-07-31 15:37:10 +08:00
parent adfe4e3d69
commit f4664266cc
7 changed files with 77 additions and 6 deletions
@@ -40,7 +40,22 @@ npm run dev
 npm test
 ```

-## 四、依赖纪律
+## 四、验证矩阵与构建产物
+
+项目必须把验证分层写清，任务文件再按改动范围引用对应层级。不要让 agent 自行猜测“相关测试”或“完整验证”分别包含什么。
+
+| 层级 | 触发条件 | 命令 / 操作 | 通过证据 |
+| --- | --- | --- | --- |
+| 任务相关验证 | 每个任务必跑 | `【受影响模块的测试 / 静态检查 / 构建命令】` | 【退出码、测试数或关键断言】 |
+| 完整门禁 | 发布前；修改共享契约、依赖、构建配置或跨模块基础设施时；或任务明确要求时 | `【全量测试 / 全量 lint / 发布构建命令】` | 【退出码、测试数、构建产物】 |
+| 人工 / 设备验收 | 自动化无法替代的真机、硬件、外部账号、主观体验或受控环境验收 | `【操作步骤、执行角色、设备 / 环境】` | 【人工结论、截图 / 日志 / 记录位置】 |
+
+- 任务相关验证不能省略；是否触发完整门禁，必须依据上表和任务验收要点判断，不要求所有小改动无差别跑全量。
+- 必需的人工 / 设备验收未完成时，任务保持 `DOING` 或标为 `BLOCKED` 并写明等待事项，不得标记 `DONE`。
+- 若构建产物需要部署、交接或比较新旧版本，记录产物路径、生成命令和项目选定的指纹（例如 SHA-256）；版本号不能单独证明部署的是本次构建。
+- 标准启动 / 验证入口仍以根目录 `init.sh` 或 `init.ps1` 为准；本表负责说明不同验证层级何时触发。
+
+## 五、依赖纪律

 - 新增第三方依赖前，先说明用途、替代方案和维护成本。
 - 不确定的技术选型先更新本文，再进入代码。