From ffde6e45b51ff4658b244e20f1bf55d70ad472da Mon Sep 17 00:00:00 2001 From: agent-exec-transport Date: Fri, 16 Oct 2026 08:41:43 +0000 Subject: [PATCH] agent-exec transport a58dda9249cc43c9b97c54cb2b2f204b/b1839aadcc04 --- AGENTS.md | 3 ++- policy/delivery.md | 19 ++++++++++++++++++- 2 files changed, 20 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 00ac747b..2ea3bcbb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -38,7 +38,7 @@ policy/delivery.md。 ## 实施执行路由（强制） -- 实施、修复、测试与审阅调度**必读根目录 [AGENT-EXECUTION.md](AGENT-EXECUTION.md)**（唯一项目执行路由配置）。 +- 实施、修复、测试与审阅调度**必读根目录 [AGENT-EXECUTION.md](AGENT-EXECUTION.md)**（唯一项目执行路由配置）。通用工程 Agent 契约（agent-per-unit 隔离执行、会话独立、JSON 终态收据、无 host 隐式代写、受控 transport/admission 准入）遵循 Development-Guidelines [core/baseline.md（硬边界 8）](deps/development-guidelines/core/baseline.md) 与 [standards/agent-execution.md](deps/development-guidelines/standards/agent-execution.md)；项目根目录配置仅声明角色候选顺序与适配器参数。 - 产生仓库变更的实施按可独立实施的单元拆分；任务卡记 `实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）`。 - 外部 Agent 在新进程/隔离工作区执行一个有界单元；host 负责计划、拆解、范围审阅、权威验证、规范提交、 PR/CI/合入、证据与任务元数据及安全清理。Worker 不得提交、推送、开或合 PR、部署、改路由或派遣同伴。 @@ -88,6 +88,7 @@ policy/delivery.md。 ## 任务启动门禁（强制） +- **新需求分流检查**：每次接到新需求，在创建分支前先运行 `make task-triage` 检查目标仓库中是否有接纳中的大任务集成分支（`branch_kind=initiative` 且 `accepting_requirements=true`）。三态分流：`JOIN`（建立对应大任务的子任务 `make task-start KIND=child INITIATIVE=feature/ NAME=feature/-`）、`NEW`（建立普通任务或新的大任务 `make task-start [KIND=initiative] NAME=feature/`）、`DECISION_REQUIRED`（存在多个候选或改变范围/优先级，由人工决策）。 - 任务启动或恢复后，**第一次项目写操作前**通过 `RECEIPT=/tmp/<本次唯一名称>.json CMD="make precheck" make evidence` 运行一次启动检查并保存 完整脱敏收据（不要求已有任务卡）；按输出完成必读。`SHARED_WORKSPACE_BUSY / SYNC_REQUIRED / diff --git a/policy/delivery.md b/policy/delivery.md index e921b171..d60589e1 100644 --- a/policy/delivery.md +++ b/policy/delivery.md @@ -68,7 +68,7 @@ ## Agent 实施单元与主模型职责 -产生仓库变更的实施工作拆成可独立实施的单元。任务卡默认记 +产生仓库变更的实施工作拆成可独立实施的单元。通用规则遵循上游 [Development-Guidelines 核心硬边界 8 与 agent-execution 标准](../deps/development-guidelines/standards/agent-execution.md)（agent-per-unit、会话隔离、JSON 终态收据、无 host 隐式代写、受控 transport/admission 准入）。任务卡默认记 `实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）`。执行路由以根目录 [AGENT-EXECUTION.md](../AGENT-EXECUTION.md) 为唯一权威；按角色声明的候选顺序在新进程与 隔离工作区中尝试外部 Agent。不得跨单元复用同一外部进程，也不得 resume 同一次尝试。 @@ -149,6 +149,23 @@ host 可以直接编写并提交的豁免只有 `.task/**`、`docs/superpowers/s - 会话隔离不要求为简单任务增加新平台或复杂编排。平凡文档/配置任务仍按最小闭环执行；需要独立 Review 时只额外启动一个最小、一次性的评审 session，不复用实施 session，也不扩展任务范围。 +### 两级分支交付模型与分流检查 + +本仓采用两级业务交付模型： +- **`main`**：稳定基线，仅接纳已完成并通过最终组合准入的结果。 +- **大任务集成分支（initiative）**：从最新 `origin/main` 建立，根目标与即时目标均为 `main`。负责跨单元目标的阶段集成、组合验证与最终交付。合入主干后关闭、归档与回收，不作为长期存在的 develop 分支。 +- **子任务分支（child）**：从所属大任务分支固定 HEAD 建立，即时目标为大任务分支。负责一个有界单元的实施、独立 Review 与局部验证，通过 PR 合入大任务分支。 +- **普通任务分支（standalone）**：无需阶段集成的小需求或独立修复，直接从最新 `origin/main` 建立并向 `main` 交付。 + +每次接到新需求，创建分支前必须执行分流检查（`make task-triage`），扫描仓库中进行中且允许接纳需求（`accepting_requirements=true`）的大任务分支： +- `JOIN`：加入唯一匹配的大任务，从大任务分支创建子任务分支交付； +- `NEW`：无接纳中的大任务，建立普通任务或新的大任务； +- `DECISION_REQUIRED`：存在多个候选大任务或加入将改变交付边界/优先级，交由人工决策。 + +两级合入与验证： +1. **子任务合入大任务**：子任务完成时，通过 `make task-sync` 合并大任务分支最新状态，解决文本与语义冲突，完成直接相关测试与独立 Review 后通过 PR 合入大任务分支； +2. **大任务合入主干**：所有必需子任务合入后，关闭需求接纳（`accepting_requirements=false`），同步最新 `origin/main`，执行完整组合验证、独立 Review 与必需 CI，然后合入 `main`。 + ## 目标优先、范围控制与问题分流 执行顺序为：