docs(workflow): complete H-414 cross-agent gates
Harness governance / validate (push) Has been cancelled
Harness governance / validate (push) Has been cancelled
This commit is contained in:
@@ -39,6 +39,7 @@ write_paths: # 允许修改的仓库相对路径
|
||||
## 问题 / 背景
|
||||
## 关联需求与交互(如适用)
|
||||
## 方案
|
||||
## 不可变约束
|
||||
## 验收要点
|
||||
## 边界(不改什么)
|
||||
## 协作约束
|
||||
@@ -49,7 +50,10 @@ write_paths: # 允许修改的仓库相对路径
|
||||
|
||||
- 状态:`TODO` · `DOING` · `DONE` · `BLOCKED`。每个 agent 同时最多一个活跃任务;项目可以并行多个写路径互不重叠的任务。
|
||||
- 每个 agent 一次只领一个 `status: TODO` 且依赖全 `DONE` 的任务,取编号最靠前的;若本目录暂无可领任务,先按路线图把下一个建议任务落成任务文件,再领取。
|
||||
- 默认一个任务只有一个责任 Agent 和一个写入者。复杂任务在编码前把确认后的方案写进 `## 方案`;范围明确时直接执行,任务内委派只在项目规则显式允许时启用。
|
||||
- `## 不可变约束` 逐项写清不能由执行者自行改变的阈值、判定式、安全边界和既有契约字段;没有时明确写“无”,不要留空让执行者猜测。
|
||||
- `write_paths` 必须在动手前写清。两个活跃任务路径相同,或一条是另一条的目录前缀,均视为冲突,不能并行。
|
||||
- `## 验收要点` 按 [`../03-tech-stack.md`](../03-tech-stack.md) 区分任务相关验证、命中条件才执行的完整门禁,以及必需的人工 / 设备验收;人工门禁未完成时不得改为 `DONE`。
|
||||
- UI 任务在动手前写清关联的 US / IX 编号;无用户界面时,在任务文件中标记交互清单不适用。
|
||||
- P0 的 UI 任务动手前确认 `docs/design/` 有对应页面原型,没有就先生成(约定见 [`../design/README.md`](../design/README.md));显著改版页面的任务在 `## 方案` 中写明第一步为重新生成原型并更新 IX 草稿。
|
||||
- 做完自测、按「passing 需证据」把验证命令与结果写清、改 `status: DONE`。
|
||||
@@ -58,6 +62,15 @@ write_paths: # 允许修改的仓库相对路径
|
||||
|
||||
未启用 Gitea 时,在独立分支 / worktree 中把任务文件从 `TODO` 改为 `DOING` 即可。启用 Gitea 时,必须先按 [`../gitea-collaboration.md`](../gitea-collaboration.md) 由 dispatcher 串行分配并创建 `claims/T-<编号>` 防御性标记;assignee、标签、读回和普通 create-branch API 都不能单独提供并发互斥。
|
||||
|
||||
## 任务内委派(可选)
|
||||
|
||||
任务内委派默认关闭;跨 Agent 并行优先拆成 `write_paths` 互不重叠的不同任务。项目显式允许任务内委派时:
|
||||
|
||||
- 只读探索者不得修改或提交仓库;探索结论先由任务所有者核实并写回任务文件。
|
||||
- 同一时刻只有一个写入者。任务所有者若把实现交给执行者,自己不与执行者并行修改相同任务路径。
|
||||
- 派发内容必须逐项包含任务文件、不可变约束、允许的 `write_paths`、明确不改什么,以及任务相关 / 完整 / 人工三层验证要求;执行者不得自行放宽。
|
||||
- 任务所有者保留最终责任,必须独立检查 `git status`、审阅未暂存与已暂存 diff、检查意外行尾变化并重跑已触发的验证;不能仅凭执行者自报把任务标记为 `DONE`。
|
||||
|
||||
## 与 Gitea Issue / PR 的映射(可选)
|
||||
|
||||
- 一个任务文件对应一个主 Issue;Issue 负责实时领取、阻塞和评审状态,任务文件负责版本化规格和长期证据。
|
||||
|
||||
+18
-3
@@ -26,11 +26,21 @@ write_paths:
|
||||
|
||||
## 方案
|
||||
|
||||
(怎么改,落到"改哪个文件、改成什么")
|
||||
(怎么改,落到“改哪个文件、改成什么”。复杂任务把确认后的规划结论写在这里,不只保留在对话中。)
|
||||
|
||||
## 不可变约束
|
||||
|
||||
- 阈值 / 数值边界:【具体值;无则写“无”】
|
||||
- 判定式 / 状态转换:【必须保持的规则;无则写“无”】
|
||||
- 安全边界:【不可绕过、不可自动执行的动作;无则写“无”】
|
||||
- 既有契约:【字段、接口、兼容性要求;无则写“无”】
|
||||
|
||||
## 验收要点
|
||||
|
||||
(可验证的完成标准;按「passing 需证据」写清跑哪个验证命令,不写"应该能用")
|
||||
- 任务相关验证:【每次必跑的命令与预期证据】
|
||||
- 完整门禁:【触发条件、命令与预期证据;不触发时写明理由】
|
||||
- 人工 / 设备验收:【是否必需、执行角色、步骤与证据;不适用时明确写“不适用”】
|
||||
- 构建产物:【需要交接 / 部署时填写路径、生成命令和指纹;不适用时明确说明】
|
||||
|
||||
## 边界(不改什么)
|
||||
|
||||
@@ -38,7 +48,12 @@ write_paths:
|
||||
|
||||
## 协作约束
|
||||
|
||||
(启用 Gitea 时填写对应 Issue、领取时的 `context_ref`、claim / 工作分支;任何新增写路径先检查与其他活跃任务是否重叠。)
|
||||
- 责任 Agent:【Agent 标识】
|
||||
- 唯一写入者:【默认同责任 Agent;项目显式启用委派时填写执行者】
|
||||
- 委派:【默认不启用;启用时写清只读探索者 / 执行者,并声明其继承本任务全部不可变约束、`write_paths` 和验证要求】
|
||||
- Gitea:【启用时填写对应 Issue、领取时的 `context_ref`、claim / 工作分支】
|
||||
|
||||
任何新增写路径先检查与其他活跃任务是否重叠;同一时刻只有一个 Agent 修改本任务的 `write_paths`。
|
||||
|
||||
## 执行记录
|
||||
|
||||
|
||||
Reference in New Issue
Block a user