Agent-Native/policy/guidelines-adoption.md

通用规范采纳记录

• 项目/负责人：Agent-Native / weichen
• 状态：active
• 规范位置：deps/development-guidelines
• 规范性文档目录：policy/
• 过程文档位置：任务卡在 .task/（模板 .task/templates/task-card.md）；过程记录在 docs/records/（项目内固定目录豁免。当前为个人维护的基础库，单独过程仓会让每份记录都变成跨仓 gitlink；任务主记录在 PR 描述中。豁免一经登记，过程记录不得再写入 policy/ 或规范库。）
• 版本权威：本仓 gitlink deps/development-guidelines @ 2688fd2be6a5（完整 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb，内容版本 0.1.0-draft.12）；可读标签：无
• 批准/生效依据：feature/governance-adoption PR（Agent-Native）；合入前须在 .task/feature-governance-adoption.md 记录正负例、Review 与 CI 证据
• 替代范围和迁移说明：无替代项。既有 AGENTS.md、PROJECT.md 内容保留，本次只向二者追加内容（「Agent 执行与新项目准入（强制）」段与验证命令）；AGENT-EXECUTION.md 非既有文件，由本次采纳新增（治理引导提交 b1034e1）。新增共享执行器入口 scripts/dm、scripts/agent-exec、scripts/task，scripts/hooks/pre-commit（待 host 启用 core.hooksPath）与 .gitea/workflows/governance.yml。

规范/工作流	适用条件与范围	采纳或不适用理由	执行方式/证据
core/baseline.md	日常工作	所有改动都要守硬边界	manual
workflows/delivery.md、debugging.md、handoff.md	交付、排障与交接	单人维护仍需要可交接的任务记录（.task/ 任务卡 + PR 主记录）	manual
standards/collaboration.md	并行共同起点、节点同步与陈旧候选拒绝	本仓会被 Agent-Squad 以 gitlink 消费	manual
standards/merge-queue.md	多个就绪任务的最终同步、CI、Review 与合入调度	不适用：个人维护的单仓，合入由仓库所有者串行完成，无多任务就绪队列	不适用
standards/verification.md	验证与结论	仓库根 go vet / go test；治理与执行配置命令见 PROJECT.md「验证」节	manual；命令见 PROJECT.md
workflows/design-verification.md、standards/testability.md、standards/failure-containment.md	契约、适配器与故障分类	执行器失败必须可定位且不扩大工具范围	manual
standards/module-contracts.md	contract/exec/runtime/adapters 边界	公开端口已按层拆分	manual
standards/observability.md	错误码、过程事件	与 Error-Code-System / Logging-System 对齐	manual
standards/agent-execution.md	工程 Agent CLI 执行路由、会话隔离与受控集成；模型能力协商与回退	本仓就是执行契约的权威。AI 实施单元只经 AGENT-EXECUTION.md 登记的候选由 scripts/agent-exec run 执行，并经 scripts/agent-exec apply 集成，禁止 host 代写	AGENT-EXECUTION.md + scripts/agent-exec（validate/admit）；证据：governance check + 正负例（.task/feature-governance-adoption.md）
standards/multi-repo.md	submodule 与固定版本组合	规范与基础库以 gitlink 锁定	manual
standards/security.md	路径授权、工具范围、凭证	凭证不入库；路径授权不等于 OS 沙箱	manual
standards/documentation.md	三层文档	policy/ 与 docs/records/ 已分开	manual
standards/data-reliability.md	执行副作用与重放	无本仓数据库；适用副作用分类，不扩展成存储设计	manual
standards/configuration.md	调用方注入的模型与工具配置	本仓不自带多实例部署配置	manual
standards/tool-adaptation.md	为工具创建规则/钩子、接入新客户端	适用于 scripts/hooks/pre-commit（git 钩子，待 host 启用）；本仓不新增工具规则或客户端接入	manual
standards/release-operations.md	独立发布流水线	当前无制品仓库与部署入口	不适用
workflows/automation.md	定时与后台任务	本仓无 daemon	不适用

项目差异

原规则/章节	项目采用方式	原因与风险	负责人/复查条件
documentation.md 过程仓默认独立仓库	过程记录放 docs/records/	个人基础库；风险是记录与代码同 PR 时容易把证据写成第二权威。任务状态仍只认 Gitea Issue/PR	出现第二名维护者或对外发布流程时复查

默认做法差异说明理由；硬边界冲突须有明确有效决策，不能用此表自授权。建议不采用无需登记。

本次升级或首次接入验证

2026-09-29 首次接入（历史记录，版本号为当时值）

• 入口：根 AGENTS.md、PROJECT.md 指向 deps/development-guidelines。
• 子模块：deps/development-guidelines 固定 26b562d2e34fbc560711296a309c91c74ffc55b1。
• .gitmodules 使用批准的上游 SSH URL，不含本机路径或凭证。
• 执行方式保持 manual：挂载 Markdown 不自动改变 CI。
• 回退：恢复本提交之前的 gitlink，并删除根入口与 policy/guidelines-adoption.md 中对应条款；无已生效的 CI 或权限变更需要另恢复。

2026-09-29 追加：agent-intent 可选意图闸门

• 新增 deps/agent-intent（固定 55780ae2cce4ae98d8b0557b8234af8833a7c522），deps/error-code-system 前进到 dbeed2f1b67eb417ce089e7033a228578fbbeb03（追加 squad.intent_refused，兼容性变更无）。
• 依赖边界新增：唯 adapters/intentgate 可 import agent-intent；不使用该包时核心与 agent-intent 无编译关系。
• 接入与验证记录见 docs/records/2026-09-29-intentgate-adoption.md。
• 回退：删除 adapters/intentgate/、go.mod 的 agent-intent require/replace、.gitmodules 对应条目与 submodule，scripts/submodule-consistency.sh 移除该路径。

2026-10-17 治理套件采纳（feature/governance-adoption）

• 入口：根 AGENTS.md、PROJECT.md、AGENT-EXECUTION.md 指向 deps/development-guidelines；相对链接须可解析。
• 固定版本：deps/development-guidelines 由 26b562d2 前进到 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb；deps/development-manager 固定 bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c（.gitmodules 条目与 gitlink 由执行器记录）。
• 共享执行器：scripts/dm（读取 deps/development-manager 钉住提交）、scripts/agent-exec、scripts/task 为薄入口；.task/templates/task-card.md 为任务卡模板。
• CI 门禁：.gitea/workflows/governance.yml 执行 scripts/agent-exec validate --repo . 与 scripts/dm governance check --repo .；除 agent-execution 外的专题保持 manual。
• 检查：本文件无尖括号占位符；暂存副本内 scripts/dm governance check --repo . 与 scripts/agent-exec validate --repo . 的输出，以及正负例、Review 与 CI 证据，合入前在 .task/feature-governance-adoption.md 补齐（当前为 NOT_RUN）。
• 回退：把 deps/development-guidelines 恢复到 26b562d2e34fbc560711296a309c91c74ffc55b1，删除 deps/development-manager 条目，删除 scripts/dm、scripts/agent-exec、scripts/task、scripts/hooks/、.gitea/workflows/governance.yml 与 .task/templates/task-card.md，并从 AGENTS.md 删除「Agent 执行与新项目准入（强制）」段。