Agent-Squad/policy/guidelines-adoption.md

通用规范采纳记录

• 项目/负责人：Agent-Squad / 仓库所有者 weichen
• 状态：active
• 规范位置：deps/development-guidelines
• 规范性文档目录：policy/
• 过程文档位置：docs/records/（项目内固定目录豁免。个人维护的编排库，任务主记录仍在 Gitea Issue/PR。过程记录不进规范库，也不写成与 Issue 平行的第二状态。）
• 版本权威：父仓 gitlink；可读标签：无（内容版本 0.1.0-draft.6，提交 26b562d2e34fbc560711296a309c91c74ffc55b1）
• 批准/生效依据：本仓接入提交
• 替代范围和迁移说明：本仓此前没有根 AGENTS.md。Agent-Native 子模块已从仓库根迁到 deps/agent-native，迁移说明见 docs/records/2026-09-29-guidelines-and-observability.md。

规范/工作流	适用条件与范围	采纳或不适用理由	执行方式/证据
core/baseline.md	日常工作	编排库对外有失败关闭语义	manual
workflows/delivery.md、debugging.md、handoff.md	交付、排障与交接	跨仓组合需要可交接记录	manual
standards/collaboration.md	并行共同起点与组合升级	父仓 gitlink 锁定 Agent-Native 与基础库	manual
standards/verification.md	验证与结论	GOWORK=off go test	manual；命令见 PROJECT.md
workflows/design-verification.md、standards/testability.md、standards/failure-containment.md	规划、执行、HITL	conformance 覆盖公开 API	manual
standards/module-contracts.md	squad 与 agent-native 边界	依赖方向只允许 squad → agent-native	manual
standards/observability.md	HTTP 信封、trace、事件	接入错误码库与日志库	manual
standards/agent-execution.md	角色绑定的执行后端	本库不实现 Agent	manual
standards/multi-repo.md	多级 submodule	本仓 replace 是编译时的唯一依赖解析	manual
standards/data-reliability.md	运行目录、HITL 恢复、幂等回应	磁盘为权威	manual
standards/security.md	bash 权限挂起、脱敏	事件落盘沿用现有脱敏；凭证走环境变量	manual
standards/configuration.md	HITL 模式、规划器、日志配置	环境变量与 CLI 标志	manual
standards/documentation.md	三层文档	policy/ 与 docs/records/	manual
standards/release-operations.md	独立发布流水线	当前无制品仓库	不适用
workflows/automation.md	serve 内 15s wakeup sweep	有界、可手动触发；不另建定时系统	manual

项目差异

原规则/章节	项目采用方式	原因与风险	负责人/复查条件
documentation.md 过程仓默认独立仓库	过程记录放 docs/records/	同 Agent-Native：避免个人项目再维护一个过程仓。风险是证据与代码同库	多人协作或对外发布时复查
multi-repo.md 组件说明不手写第二套 SHA	PROJECT.md 只写路径与角色，SHA 以 git submodule status 为准	手抄 SHA 会与 gitlink 漂移	每次依赖升级核对脚本

本次升级或首次接入验证

• deps/development-guidelines 固定 26b562d2e34fbc560711296a309c91c74ffc55b1。
• 执行方式为 manual。
• 回退该规范挂载时，同时确认 Agent-Native 子模块路径是否已迁移；只还原规范 gitlink 不会把 deps/agent-native 移回根目录。

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

• 新增 deps/agent-intent（固定 55780ae2cce4ae98d8b0557b8234af8833a7c522）；deps/error-code-system 前进到 dbeed2f1b67eb417ce089e7033a228578fbbeb03（squad.intent_refused，追加式）；deps/agent-native 前进到 c659dc17d5086a8128999011994fc2dbe73419d3（其仓内新增 intentgate 装饰器）。
• 依赖边界新增：唯 squadintent 与 cli 组合根可 import agent-intent；squad/server/store 不感知意图；未配置意图时引擎行为与原实现一致。
• 接入与验证记录见 docs/records/2026-09-29-intent-gate-adoption.md；跨仓测试报告见 Agent-Intent 仓 docs/records。
• 回退：删 squadintent/ 与 cli 接线、go.mod 两行、submodule 与 .gitmodules 条目、一致性脚本对应段；可将 agent-native 回退到 cc8a6a7（其 intentgate 为可选包，不回退亦可编译）。

2026-09-29 追加（二）：目录驱动的编排

• deps/agent-intent 前进到 3674dc4bfd0b49191d21f0afab4002381e41a429（槽位约束与能力目录，E2/E4）；deps/agent-native 前进到 292142ac1a8b125488794e9374faee2cb1c8c579（pin 同步）。
• 新增能力目录（squad.IntentCatalog 数据视图）与系统功能步（StepSpec.IntentID + IntentRunner）；核心包仍零 import agent-intent。
• 接入与验证记录见 docs/records/2026-09-29-catalog-driven-orchestration.md。