weichen
b450b03638
Details (original message): Initialize the repository with pinned submodules, project entry documents, and the design record.
56 lines
3.8 KiB
Markdown
56 lines
3.8 KiB
Markdown
# 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/`；过程记录在 `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/`（项目内豁免，理由见 [采纳记录](policy/guidelines-adoption.md)）。
|
|
- 交接记录位置：随任务主记录；需要落盘的交接放入 `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，可选日志器 |
|
|
|
|
克隆：
|
|
|
|
```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` | 本命令不覆盖真实宿主配置 |
|
|
|
|
## 环境与数据
|
|
|
|
| 环境/实例 ID | 只读查询入口 | 授权写入入口 | DB/存储归属 | 恢复入口 |
|
|
|---|---|---|---|---|
|
|
| 本地开发 | 本机工作区与 `go test` | 本机 git 提交 | 无数据库；配置由宿主注入 | 重新 clone 父仓并 `submodule update --init --recursive` |
|
|
|
|
共享项及 ACL：无。部署、迁移、发布的审批依据与负责角色：当前库不独立部署；合并进 `main` 由仓库所有者批准。
|
|
实际制品/配置/schema 的查询方法：阅读当前 `main` 的 `intent` 包与 `go.mod`，不以历史 README 快照代替。
|