agent-exec transport ef41add06bee63d92fdd10ad80710aee/4bce0a1e4ce8

This commit is contained in:
agent-exec-transport
2026-10-18 16:47:21 +00:00
parent d3223f5ec1
commit 98447e269c
+9 -8
View File
@@ -160,7 +160,7 @@ host 可以直接编写并提交的豁免只有 `.task/**`、`docs/superpowers/s
- **`main`**:稳定基线,仅接纳已完成并通过最终组合准入的结果。
- **大任务集成分支(initiative)**:从最新 `origin/main` 建立,根目标与即时目标均为 `main`。负责跨单元目标的阶段集成、组合验证与最终交付。合入主干后关闭、归档与回收,不作为长期存在的 develop 分支。
- **子任务分支(child)**:从远端所属大任务分支的当前头建立(须等于分流收据核验的 head,`make task-start` 校验),即时目标为大任务分支。负责一个有界单元的实施、独立 Review 与局部验证,通过 PR 合入大任务分支。
- **普通任务分支(standalone)**:无需阶段集成的小需求或独立修复,直接从最新 `origin/main` 建立并向 `main` 交付。
- **普通任务分支(standalone)**:可独立验收、无需阶段集成与组合验证的工作(含修复、完善与新能力),直接从最新 `origin/main` 建立并向 `main` 交付。
每个任务卡记录 `root_target` 与 `immediate_target`(子任务为所属大任务分支,其余为 `main`)。`make task-resume`、`make task-sync` 与 `make task-finish` 以 `immediate_target` 为准;任务卡默认在合入前以 `make task-close SELF=1` 闭合并随本 PR 合入(归档后上述命令仍从 `.task/archive/` 读取合入前闭合的卡);遗留卡的 `make task-close` 仅在 `FOLD=--fold` 时以其为闭合 PR base。
@@ -190,12 +190,13 @@ L1 章程与运行:
- 子任务可继承 L1 章程中的全部或部分领域规则,并在子任务卡注明继承范围。
- L1 不追 `main`,只在最终窗口、需要 `main` 上某修复、或长周期 L1 的里程碑/每周一次时运行 `make task-sync`。
任务通道按 修复/完善/扩展/新增 分类:
- **修复**:`fix/`(P0 生产事故用 `hotfix/`),standalone 直达 `main`,在合入队列中优先;hotfix 可在 #518 写明原因后插队。
- **完善**:进入所在领域的“完善列车” L1,按周或按批合入 `main`。
- **扩展**:优先 JOIN 同主题在途 L1,没有时新建。
- **新增**:建立 L1 并写章程。
- 治理与规范调整集中到一个治理 L1。
任务通道分两步判定,类别与拓扑互不替代:
- **类别只决定优先级**:修复用 `fix/`(P0 生产事故用 `hotfix/`),在合入队列中优先;hotfix 可在 #518 写明原因后插队。完善、扩展、新增不设额外优先级。
- **拓扑只按集成与验收需要决定**,不因工作被称为新增、完善或规模大而建 L1:
- **standalone**:工作有自己的验收、没有依赖单元、不共享集成契约、也不需要协同发布验证时,从 `main` 切出并直达 `main`;小完善与新能力同样适用。可独立验收的修复默认为 standalone。
- **L1**:多个相互依赖的单元、跨单元集成或一个共同最终验收需要阶段集成与组合验证时,建立 L1 并写章程。
- **child**:工作(含修复)属于某在途 L1 的共同范围、依赖链或验收时,作为其子任务。只有该 L1 已记录的目标与验收确实覆盖此工作、且加入不会悄然改变其已约定范围时才 `JOIN`;否则按上两条判定 `NEW`。远端发现不可核验时不得得出 `NEW`、不建分支。
- 治理与规范调整同样按上述拓扑判定;需要 L1 时集中到一个治理 L1。
- 只改记录(任务卡、报告)的变更不单独推进 `main`,随所属任务 PR 合入。
- 组件 pin 跟随用到它的 L1/任务一起推进,不单独开 pin PR(紧急修复除外)。
@@ -206,7 +207,7 @@ L1 章程与运行:
| 单元→L2 | worker 自检 + host 最小直接检查(`make test-affected`) | host 审阅实际 diff | 无 | 无 | 无 |
| L2→L1 | `make task-sync` 同步 L1 头 + `make test-affected` | 一次全新会话独立 Review | 轻量 CI(PR base 非 `main` 时只跑 `test` 作业,`test-pg`/`svc-realcombo` 跳过)作为 GATE | 不排 #518 窗口、不需分流收据(已登记子任务)、不要求三段证据;任务卡合入前 `make task-close SELF=1` | 无 |
| L1 的 WIP PR | — | — | 完整 CI,作为非阻塞预警 | — | — |
| L1 或修复→main | 最终窗口内 `make task-sync` + 完整组合验证 | 整体独立 Review | 完整 CI(`test`、`test-pg`、`svc-realcombo`) | #518 窗口、三段证据、合入前折叠闭合 | L1 最终一次用户专属验收(如有) |
| L1 或 standalone→main | 最终窗口内 `make task-sync` + 完整组合验证 | 整体独立 Review | 完整 CI(`test`、`test-pg`、`svc-realcombo`) | #518 窗口、三段证据、合入前折叠闭合 | L1 最终一次用户专属验收(如有) |
人工审批只保留 L1 章程确认、L1 最终用户专属验收与高后果双钥匙操作;等待 CI 一律 `make ci-wait SHA=<完整 SHA>`。