Agent-Squad/AGENTS.md

项目工作入口

本项目采纳的通用规则：核心规则。 采纳范围、生效状态及项目差异：采纳记录。 项目事实、测试和环境入口：PROJECT.md。

• 启动：阅读以上短入口；只加载本次任务触发的专题。
• 普通交付：交付流程。
• 并行开发/正式测试/审核/合入：共同基线与同步节点，必须确认并实际同步最新权威目标。
• Bug/异常：系统性排障。
• 会话结束/换机器/换客户端/换执行者：会话、执行者与机器交接，状态写入任务主记录，不依赖本地会话历史。
• 测试与验收：验证标准。
• 模块/接口：模块契约。
• 功能设计/跨模块变更：设计与验证，按增量明确验收、独立测试及故障范围。
• 错误与过程事件：可观测性。
• 拆仓与 submodule：多仓库与固定版本组合。
• 其他专题：按 任务索引 选择。

项目补充硬边界：

• 本库只做编排与任务拆解，不实现 Agent。智能体执行只来自 Agent-Native 或调用方注册的后端。
• 未知 backend fail-closed，禁止静默回落 stub。
• 意图闸门与能力目录为可选能力：唯 squadintent 与组合根（cli 接线）可 import agent-intent；squad/server/store 核心不感知意图（目录以 squad.IntentCatalog 数据视图注入）。未配置意图（无闸门或零意图）时引擎行为与原实现一致；闸门错误、守卫拒绝与系统功能步的目录/校验/handler 缺失均 fail-closed（squad.intent_refused / 明确步骤错误）。
• 磁盘上的运行状态是恢复权威；HTTP 错误使用稳定规范码和 X-Trace-Id，不以自由文本作为唯一错误合同。
• 依赖仓版本以本仓 gitlink 为准。构建时只认本仓 go.mod 的 replace；嵌套子模块里的 replace 不参与本仓编译。

任务权威：Gitea 仓库 weichen/Agent-Squad 的 Issue 与 Pull Request。 规范性文档目录与过程记录位置：policy/ 放项目规则；docs/records/ 为过程记录豁免目录。项目规范与过程记录不进通用规范库。 默认集成基线和提交身份：main；测试命令带 GOWORK=off。提交身份沿用本机 git 作者。 共享环境/发布入口及授权：无共享运行环境。权威远端 ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Squad.git。HTTP 开发入口默认 :8090，不含密钥。