Agent-Intent/PROJECT.md

Agent-Intent 项目事实

工作规则见 AGENTS.md。此文件维护本项目事实，不复制通用规范。

仓库与操作

• 目标/产品边界：通用意图识别基础库。提供意图定义（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 包公开类型为准。
• 权威远端、集成基线、受保护分支：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/（项目内豁免，理由见 采纳记录）。
• 交接记录位置：随任务主记录；需要落盘的交接放入 docs/records/。
• 凭证查找入口及所需字段：无凭证。本仓不保存密钥字段的值。

依赖组合

逻辑 ID	路径	角色
development-guidelines	deps/development-guidelines	development-only，规范文本
error-code-system	deps/error-code-system	build-required，规范码目录（catalogcheck 对齐 + intent.* 常量值）
logging-system	deps/logging-system	build-required，可选日志器

克隆：

git clone --recurse-submodules ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Intent.git
# 已克隆时：git submodule update --init --recursive

构建、审核和发布固定父仓 gitlink，不执行 submodule update --remote。

消费方（Agent-Squad / Agent-Native）接入本仓时须自带全部 replace：依赖模块内部的 replace 在上层构建中不生效。

验证命令

影响	工作目录与真实命令/CI	前提与不覆盖范围
文档	人工核对 AGENTS.md、PROJECT.md、policy/ 相对链接	不证明运行时行为
模块/接口	仓库根：GOWORK=off go vet ./... && GOWORK=off go test -count=1 ./...	需要 Go 1.27
并发/快照隔离	仓库根：GOWORK=off go test -count=1 -race ./...	覆盖 Reload 与识别并发
依赖纪律	仓库根：GOWORK=off go list -m all 仅标准库 + 两个生态模块	不证明宿主接入正确性
宿主行为验收	消费方仓内跑 conformance.Run	本命令不覆盖真实宿主配置

环境与数据

环境/实例 ID	只读查询入口	授权写入入口	DB/存储归属	恢复入口
本地开发	本机工作区与 go test	本机 git 提交	无数据库；配置由宿主注入	重新 clone 父仓并 submodule update --init --recursive

共享项及 ACL：无。部署、迁移、发布的审批依据与负责角色：当前库不独立部署；合并进 main 由仓库所有者批准。 实际制品/配置/schema 的查询方法：阅读当前 main 的 intent 包与 go.mod，不以历史 README 快照代替。