Agent-Intent/AGENTS.md

# 项目工作入口

本项目采纳的通用规则：[核心规则](deps/development-guidelines/core/baseline.md)。
采纳范围、生效状态及项目差异：[采纳记录](policy/guidelines-adoption.md)。
项目事实、测试和环境入口：[PROJECT.md](PROJECT.md)。

- 启动：阅读以上短入口；只加载本次任务触发的专题。
- 普通交付：[交付流程](deps/development-guidelines/workflows/delivery.md)。
- 并行开发/正式测试/审核/合入：[共同基线与同步节点](deps/development-guidelines/standards/collaboration.md)，必须确认并实际同步最新权威目标。
- Bug/异常：[系统性排障](deps/development-guidelines/workflows/debugging.md)。
- 会话结束/换机器/换客户端/换执行者：[会话、执行者与机器交接](deps/development-guidelines/workflows/handoff.md)，状态写入任务主记录，不依赖本地会话历史。
- 测试与验收：[验证标准](deps/development-guidelines/standards/verification.md)。
- 模块/接口：[模块契约](deps/development-guidelines/standards/module-contracts.md)。
- 功能设计/跨模块变更：[设计与验证](deps/development-guidelines/workflows/design-verification.md)，按增量明确验收、独立测试及故障范围。
- 错误与过程事件：[可观测性](deps/development-guidelines/standards/observability.md)。
- 配置来源与生效：[配置规范](deps/development-guidelines/standards/configuration.md)，spec/overlay 合并、快照 revision 与诊断工具须遵守。
- 拆仓与 submodule：[多仓库与固定版本组合](deps/development-guidelines/standards/multi-repo.md)。
- 其他专题：按 [任务索引](deps/development-guidelines/README.md) 选择。

项目补充硬边界：

- 本仓只做意图识别机制（定义、合并、识别、槽位、诊断），不内置任何业务意图内容；意图词表与正则一律由宿主注册或配置。
- 依赖方向：仅可选接入 error-code-system 与 logging-system；禁止导入 agent-native、agent-squad、agent-system 或任何宿主类型。LLM 分类器、挂起预期、分句等扩展点只定义接口，实现留在宿主。
- 配置/spec 校验失败 fail-closed：拒绝生成新快照并保留上一生效快照。「无匹配」（fallback）是正常识别结果，不是错误。
- 错误码常量与 Error-Code-System 的 `intent.*` / `sys.*` 规范码对齐，`catalogcheck` 防止双权威；未知码不静默当成功。
- 核心识别路径纯内存、无 I/O、确定性：同输入 + 同快照 → 同结果，不含时间与随机因素。
- 依赖仓版本以本仓 gitlink 为准，不执行 `submodule update --remote`；除两个生态子模块外零第三方依赖。

任务权威：Gitea 仓库 `weichen/Agent-Intent` 的 Issue 与 Pull Request。
规范性文档目录与过程记录位置：`policy/` 放项目规则；`docs/records/` 为过程记录豁免目录（方案、验证、交接）。项目规范与过程记录不进通用规范库。
默认集成基线和提交身份：`main`；提交身份沿用本机 git 作者，不在文档中写死密钥或个人 fork URL。
共享环境/发布入口及授权：无共享运行环境。权威远端 `ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Intent.git`。