# Agent-Intent 项目事实

工作规则见 [AGENTS.md](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/`；过程记录：任务卡与交付证据在 `.task/`，其他过程记录在 `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/`。
- 过程文档仓/目录：任务卡与交付证据在 `.task/`；其他过程记录在 `docs/records/`（项目内豁免，理由见 [采纳记录](policy/guidelines-adoption.md)）。
- 交接记录位置：随任务主记录；需要落盘的交接放入 `docs/records/`；任务卡与交付证据在 `.task/`。
- 凭证查找入口及所需字段：无凭证。本仓不保存密钥字段的值。

## 依赖组合

| 逻辑 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，可选日志器 |
| development-manager | `deps/development-manager` | development-only，共享 Agent 执行器与治理脚手架（`scripts/dm`、`scripts/agent-exec` 的钉住来源） |

克隆：

```bash
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` | 本命令不覆盖真实宿主配置 |
| 治理与 Agent 执行配置 | 仓库根：`scripts/agent-exec validate --repo .` 与 `scripts/dm governance check --repo .` | 只校验 `AGENT-EXECUTION.md` 与治理 gitlink/文件，不证明执行器真实运行 |

## 环境与数据

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

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