agent-exec transport 18b6c1a0ed84e5967f252879e75d05d4/5d6475d09de1

PROJECT.md

@@ -5,15 +5,15 @@
 ## 仓库与操作
 
 - 目标/产品边界：通用意图识别基础库。提供意图定义（spec）、注册表与配置合并（registry/loader）、四级漏斗识别器（guard → expectation → rules → adjudicate）、槽位抽取与诊断（conformance/catalogcheck/intentctl）。不做动作执行、不内置 LLM 客户端、不含任何业务意图内容，不依赖 Agent-Native / Agent-Squad / Agent-System。
-- 源码、资产、文档、机器契约位置：Go 源码在仓库根包目录；模块路径 `agent-intent`；人类文档在根 `README.md`、`docs/`、`policy/`；过程记录在 `docs/records/`；机器契约以 `intent` 包公开类型为准。
+- 源码、资产、文档、机器契约位置：Go 源码在仓库根包目录；模块路径 `agent-intent`；人类文档在根 `README.md`、`docs/`、`policy/`；过程记录：任务卡与交付证据在 `.task/`，其他过程记录在 `docs/records/`；机器契约以 `intent` 包公开类型为准。
 - 权威远端、集成基线、受保护分支：`ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Intent.git`，集成基线 `main`。
 - 并行共同基线记录位置、合入通知/主动检查方式：任务主记录在 Gitea Issue/PR；合入前在本仓 `main` 上 `git fetch` 并确认 HEAD。
 - 发布线与批准版本/实际制品查询入口：当前无独立制品仓库。可构建性以本仓 `main` 的 `go test` 为准；依赖子模块版本以 gitlink 为准，不把工作区未提交文件当发布组合。
 - 提交/审核/合并/发布身份与权限：仓库所有者 weichen。本机提交不代替远端合并。
 - 任务唯一来源：Gitea `weichen/Agent-Intent` 的 Issue 与 Pull Request。
 - 规范性文档目录：`policy/`。
-- 过程文档仓/目录：`docs/records/`（项目内豁免，理由见 [采纳记录](policy/guidelines-adoption.md)）。
-- 交接记录位置：随任务主记录；需要落盘的交接放入 `docs/records/`。
+- 过程文档仓/目录：任务卡与交付证据在 `.task/`；其他过程记录在 `docs/records/`（项目内豁免，理由见 [采纳记录](policy/guidelines-adoption.md)）。
+- 交接记录位置：随任务主记录；需要落盘的交接放入 `docs/records/`；任务卡与交付证据在 `.task/`。
 - 凭证查找入口及所需字段：无凭证。本仓不保存密钥字段的值。
 
 ## 依赖组合

policy/guidelines-adoption.md

@@ -4,18 +4,18 @@
 - 状态：active
 - 规范位置：`deps/development-guidelines`
 - 规范性文档目录：`policy/`（项目规则与制度放此处）
-- 过程文档位置：任务卡在 `.task/`（模板 `.task/templates/task-card.md`，本次任务卡 `.task/feature-governance-adoption.md`）；任务主记录在 PR 描述与 Gitea Issue/PR。既有项目内豁免目录 `docs/records/` 保持不变（理由见 PROJECT.md「仓库与操作」节与下方「项目差异」）。
+- 过程文档位置：`.task/` 存放任务卡与交付证据（模板 `.task/templates/task-card.md`，本次任务卡 `.task/feature-governance-adoption.md`）；`docs/records/` 存放其他过程记录，为既有项目内豁免目录，保持不变（理由见 PROJECT.md「仓库与操作」节与下方「项目差异」）；任务主记录在 PR 描述与 Gitea Issue/PR。
 - 版本权威：本仓 gitlink deps/development-guidelines @ 2688fd2be6a5（内容版本 `0.1.0-draft.12`；可读标签：无）
 - 批准/生效依据：feature/governance-adoption PR（Agent-Intent）
 - 替代范围和迁移说明：本次替代此前的 Guidelines gitlink `26b562d2e34f`（内容版本 `0.1.0-draft.6`），固定为 `2688fd2be6a5`。新增 `AGENT-EXECUTION.md` 执行路由、`deps/development-manager` 治理 gitlink（@ `bd3a7de57a3a`）、`scripts/dm`、`scripts/agent-exec`、`scripts/task`、`scripts/hooks/pre-commit`、`.gitea/workflows/governance.yml`。本仓无既往 Agent 执行路由需迁移。
 
 | 规范/工作流 | 适用条件与范围 | 采纳或不适用理由 | 执行方式/证据 |
 |---|---|---|---|
-| core/baseline.md | 日常工作 | 所有改动守硬边界；集成分支不直接提交，经 feature 分支与 PR 合入 | manual；`scripts/hooks/pre-commit` 本地拒绝直提 `main` 与非法分支名（需 `core.hooksPath` 启用，由人执行） |
+| core/baseline.md | 日常工作 | 所有改动守硬边界；集成分支不直接提交，经 feature 分支与 PR 合入 | manual；`scripts/hooks/pre-commit` 本地拒绝直提 `main` 与非法分支名（需 `core.hooksPath` 启用，由人执行）；未验证（尚无直提与非法分支名的负例记录） |
 | workflows/delivery.md、debugging.md、handoff.md | 交付、排障与交接 | 单人维护仍需要可交接的任务记录 | manual；任务卡 `.task/`，主记录在 PR |
 | standards/collaboration.md | 并行共同起点、节点同步与陈旧候选拒绝 | 本仓被 Agent-Squad / Agent-Native 以 gitlink 消费，需固定共同基线 | manual；合入前在 `main` 上 `git fetch` 并确认 HEAD |
 | standards/merge-queue.md | 多个就绪任务的最终同步、CI、Review 与合入调度 | 不适用：当前为单维护者，无多任务同时合入的调度需求；出现并行合入时复查 | 不适用 |
-| standards/agent-execution.md | 工程 Agent CLI 执行路由、会话隔离与受控集成 | 凡 AI 协助实施均经执行路由：配置 `AGENT-EXECUTION.md`，执行器入口 `scripts/agent-exec`（validate / run / apply / admit / cleanup） | enforced：CI `scripts/agent-exec validate --repo .` 与 `scripts/dm governance check --repo .`；证据：governance check + 正负例（.task/feature-governance-adoption.md） |
+| standards/agent-execution.md | 工程 Agent CLI 执行路由、会话隔离与受控集成 | 凡 AI 协助实施均经执行路由：配置 `AGENT-EXECUTION.md`，执行器入口 `scripts/agent-exec`（validate / run / apply / admit / cleanup） | advisory（CI 运行 `scripts/agent-exec validate` 与 `scripts/dm governance check`，分支保护尚未设为必需检查；设为必需检查并有阻断负例后再登记 enforced）；证据：governance check + 正负例（.task/feature-governance-adoption.md） |
 | standards/verification.md | 验证与结论 | 仓库根 `go vet` / `go test`（含 `-race`）为正式验证 | 命令见 PROJECT.md「验证命令」；CI `.gitea/workflows/ci.yml` |
 | workflows/design-verification.md、standards/testability.md、standards/failure-containment.md | 识别漏斗、配置合并与快照切换的设计/验证、模块测试与故障控制 | 识别必须可脱离外部 I/O 独立验证；配置失败保留上一快照 | manual；快照并发测试（`-race`） |
 | standards/module-contracts.md | intent / conformance / catalogcheck / examples 的边界与公开契约 | 公开端口按层拆分；扩展点只留接口 | manual |
@@ -23,17 +23,25 @@
 | standards/configuration.md | spec/overlay 双源合并、快照 revision、生效时机与诊断 | 本仓核心即配置驱动模块；诊断由 `intentctl` 承担 | manual；`intentctl lint` / `explain` |
 | standards/multi-repo.md | submodule 与固定组合 | 规范、执行器与基础库均以 gitlink 锁定；不执行 `submodule update --remote` | manual；`scripts/submodule-consistency.sh`；`scripts/dm governance check` |
 | standards/security.md | 凭证、配置信任边界 | 配置文件属宿主可信输入；本仓不保存凭证 | manual |
-| standards/documentation.md | 三层文档（入口、规范性文档、过程记录） | `policy/` 为规范性文档；过程记录按既有豁免放 `docs/records/` | manual；见下方「项目差异」 |
-| standards/tool-adaptation.md | 新工具/执行器适配 | 不适用：本次不新增工具适配卡；执行器 profile 由 AGENT-EXECUTION.md 登记 | 不适用 |
+| standards/documentation.md | 三层文档（入口、规范性文档、过程记录） | `policy/` 为规范性文档；任务卡与交付证据放 `.task/`，其他过程记录按既有豁免放 `docs/records/` | manual；见下方「项目差异」 |
+| standards/tool-adaptation.md | 新工具/执行器适配 | 适用：仓库配置 Agent CLI profile（AGENT-EXECUTION.md）、pre-commit 钩子与 Gitea CI 任务，逐项登记见下方「工具适配矩阵」 | 适用，见下方矩阵 |
 | standards/data-reliability.md | 本仓自有数据库 | 不适用：无数据库；快照替换的原子性由并发测试覆盖 | 不适用 |
 | standards/release-operations.md | 独立发布流水线 | 不适用：当前无制品仓库与部署入口；可构建性以 `main` 的 `go test` 为准 | 不适用 |
 | workflows/automation.md | 定时与后台任务 | 不适用：本仓无 daemon | 不适用 |
 
+### 工具适配矩阵（standards/tool-adaptation.md）
+
+| 要求 | 级别 | 机制 | 正例证据 | 负例证据 |
+|---|---|---|---|---|
+| (a) 本地 pre-commit 准入 `scripts/agent-exec admit` | advisory（本地钩子，需 `core.hooksPath` 启用，同 OS 用户可绕过，不是门禁） | `scripts/hooks/pre-commit` 调用 `scripts/agent-exec admit` | SELF：adoption cases 的 positive-run-apply 通过（`.task/evidence/governance-adoption/02-20261017T073820Z.log`） | SELF：bad-receipt、out-of-scope-path 被拒绝（同上日志；记录见 `.task/feature-governance-adoption.md`） |
+| (b) governance CI（`.gitea/workflows/governance.yml`：`agent-exec validate` 与 `dm governance check`） | advisory（分支保护设为必需检查前不阻断合并） | Gitea Actions job `governance`，在 PR 与 `main` 推送时运行 | PR 头 SHA 上的 governance CI 运行结果（尚未登记） | 未验证 |
+
 ## 项目差异
 
 | 原规则/章节 | 项目采用方式 | 原因与风险 | 负责人/复查条件 |
 |---|---|---|---|
-| documentation.md 过程仓默认独立仓库 | 过程记录放 `docs/records/`；任务卡放 `.task/` | 个人基础库；风险是记录与代码同 PR 时容易把证据写成第二权威。任务状态仍只认 Gitea Issue/PR | 出现第二名维护者或对外发布流程时复查 |
+| documentation.md 过程仓默认独立仓库 | 其他过程记录放 `docs/records/`（既有豁免） | 个人基础库；风险是记录与代码同 PR 时容易把证据写成第二权威。任务状态仍只认 Gitea Issue/PR | 出现第二名维护者或对外发布流程时复查 |
+| documentation.md 过程仓默认独立仓库 | 任务卡与交付证据放 `.task/`（模板 `.task/templates/task-card.md`） | 个人基础库；任务卡与证据随代码同仓，风险是证据被写成第二个任务状态权威。任务状态仍只认 Gitea Issue/PR | 出现第二名维护者或对外发布流程时复查 |
 
 默认做法差异说明理由；硬边界冲突须有明确有效决策，不能用此表自授权。建议不采用无需登记。