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
@@ -82,7 +82,7 @@ Get-ChildItem -Recurse -File
 | H-411 | 返修 H-410：恢复验收契约并重写填写示例 | H-410 | ① 恢复本文件中 H-410 验收要点为落任务时原文（见 ecd75de），状态保持 DONE；「使用规则」新增"验收要点一经领取不得改写，完成时只更新状态并另记证据；确需重新定义任务时先经用户确认"条款；② `docs/07-user-stories.md`、`docs/08-interaction-checklist.md` 的「填写示例」改写为具体但通用的示例（列表检索、删除确认等通用场景，业务对象统一用【条目】占位），每个字段给出真实可读的填法，不再逐字复读模板占位符；③ 08 示例以破坏性 P0 交互演示完整 10 行状态与异常清单和无障碍要求，低风险交互演示"只留总表条目"的用法；④ 验证：`python3 scripts/validate_agent_context.py` 通过、全仓 `.md` 相对链接无断链、示例未混入真实业务事实（无具体接口路径 / 真实产品名） | DONE |
 | H-412 | 增加 HTML 原型输入约定 `docs/design/` | H-411 | ① 新增 `docs/design/README.md` 约定文档：原型定位（生成 07 用户故事 / 08 交互清单的一次性输入物，低保真优先）；形态（一页面一个单文件 `.html`，CSS / JS 内联、零构建依赖、双击可开，按路由命名如 `items-list.html`）；假数据要求（页面顶部固定 "PROTOTYPE" 横幅标注仅供枚举交互）；权威性边界（行为权威是 08 清单，原型与清单冲突时以清单+需求为准；禁止把原型代码直接复制进生产实现，实现按 `04-architecture.md` 组件边界重写）；工作流（需求描述 → AI 生成原型 → 人工调整认可 → 据原型产出 IX 总表草稿全标【待确认】→ 人工确认行为决策）；SVG / Excalidraw 作为快速草图的替代形态一并说明（文字须保留为真文本）；② `docs/08-interaction-checklist.md` 交互详情模板与填写示例增加可选字段「关联原型」（无原型时写不适用）；③ 登记导航：`README.md`、`docs/README.md`；`docs/00-ai-start-here.md` 的"做页面 / UI"分支提及原型可作输入；④ 验证：`python3 scripts/validate_agent_context.py` 通过、全仓 `.md` 相对链接无断链、约定保持通用占位符不绑业务；不预置示例原型文件，不改 07 / 08 文件名 | DONE |
 | H-413 | 原型生命周期规则：开工门槛 + 触发式重新生成 | H-412 | ① `docs/design/README.md`：「定位与边界」或「维护规则」补三条——P0 的 UI 模块首次实现前应有原型，没有就先生成再拆任务（开工门槛，一次性）；新需求显著改变页面布局或控件集合时，把"重新生成该页原型 → 更新 IX 草稿"作为该任务第一步，判断标准为"agent 是否需要重新看图才能枚举交互"，小改动（文案、加字段）只改 IX 条目不碰原型；页面实现后原型即视为过期，不承担与实现同步的义务，实现后的视觉事实由任务文件执行记录中的真实截图承担；② `docs/tasks/README.md`：UI 任务规则处加一句——P0 UI 任务动手前确认 `docs/design/` 有对应原型，无则先生成；显著改版任务在任务文件方案中写明第一步重新生成原型；③ 不引入"每模块常备原型库"和"变更必同步原型"的义务，措辞明确原型是一次性输入物；④ 验证：`python3 scripts/validate_agent_context.py` 通过、全仓 `.md` 相对链接无断链、新旧措辞无冲突（`rg` 检查"持续同步 / 必备"相关表述一致） | DONE |
-| H-414 | 提炼跨 Agent 工作模式、独立复核与验收门禁 | H-409 | ① `docs/00-ai-start-here.md` 增加跨 Claude Code、Codex 及其他 coding agent 通用的工作模式：默认单任务、单责任 Agent、单写入者；复杂任务先规划并把确认后的方案写入当前任务文件；范围明确时直接执行，范围不清或跨目录探索收益明显时才按平台能力做只读探索；任务内委派仅在项目显式启用时使用，不绑定厂商、模型或代理类型；② `docs/tasks/README.md` 与 `_template.md` 要求任务在编码前落盘方案、不可变约束（阈值 / 判定式 / 安全边界 / 既有契约）、`write_paths`、分层验证和必需人工验收，委派执行者继承全部边界且仍保持唯一写入者；③ `docs/05-coding-rules.md` 与 `docs/clean-state-checklist.md` 增加任务所有者独立复核：检查 `git status` / `git diff` 是否越界、按项目规则检查意外行尾变化、独立重跑验证，不以执行者自报判定完成；必需的人工 / 设备验收未完成不得标记 `DONE`；④ `docs/03-tech-stack.md` 增加任务相关验证、完整门禁、人工 / 设备验收三层矩阵及触发条件；构建产物可按项目需要记录 SHA-256 等指纹，不强制所有任务无差别跑全量；⑤ 保持根 `CLAUDE.md` 为薄入口，不新增厂商专属流程、不新增文档；运行上下文校验、单元测试、治理校验、相对链接和 `git diff --check` | TODO |
+| H-414 | 提炼跨 Agent 工作模式、独立复核与验收门禁 | H-409 | ① `docs/00-ai-start-here.md` 增加跨 Claude Code、Codex 及其他 coding agent 通用的工作模式：默认单任务、单责任 Agent、单写入者；复杂任务先规划并把确认后的方案写入当前任务文件；范围明确时直接执行，范围不清或跨目录探索收益明显时才按平台能力做只读探索；任务内委派仅在项目显式启用时使用，不绑定厂商、模型或代理类型；② `docs/tasks/README.md` 与 `_template.md` 要求任务在编码前落盘方案、不可变约束（阈值 / 判定式 / 安全边界 / 既有契约）、`write_paths`、分层验证和必需人工验收，委派执行者继承全部边界且仍保持唯一写入者；③ `docs/05-coding-rules.md` 与 `docs/clean-state-checklist.md` 增加任务所有者独立复核：检查 `git status` / `git diff` 是否越界、按项目规则检查意外行尾变化、独立重跑验证，不以执行者自报判定完成；必需的人工 / 设备验收未完成不得标记 `DONE`；④ `docs/03-tech-stack.md` 增加任务相关验证、完整门禁、人工 / 设备验收三层矩阵及触发条件；构建产物可按项目需要记录 SHA-256 等指纹，不强制所有任务无差别跑全量；⑤ 保持根 `CLAUDE.md` 为薄入口，不新增厂商专属流程、不新增文档；运行上下文校验、单元测试、治理校验、相对链接和 `git diff --check` | DONE |

 ## Phase 5 · Harness 评审与健康度层（Tier 2）