diff --git a/AGENTS.md b/AGENTS.md index 67238a5..2776944 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,32 +1,19 @@ -# 项目工作入口 +# Agent 工作说明(Agent-Intent) -本项目采纳的通用规则:[核心规则](deps/development-guidelines/core/baseline.md)。 -采纳范围、生效状态及项目差异:[采纳记录](policy/guidelines-adoption.md)。 -项目事实、测试和环境入口:[PROJECT.md](PROJECT.md)。 +本仓开发遵循 Development-Guidelines(Dev 仓 `deps/development-guidelines`,gitlink 固定版本): +核心规则见其 `core/`,按任务触发阅读 `standards/` 专题;日常交付走 `workflows/delivery.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) 选择。 +## 任务启动门禁 -项目补充硬边界: +- 任务启动或恢复后,第一次写操作前在 Dev 仓运行 `make precheck` 并附完整输出(本仓作为子仓随父仓编排); + 本仓独立开发时核对工作树 clean、与权威 origin/main 同步,并按任务触发读对应专题。 +- 从权威 origin/main 固定共同起点 R0,建 feature|fix|hotfix/ 分支(Dev 仓 `make task-start` 自动化); + 任务中途不重复 precheck。 +- 验收、请求审核、合入前各同步一次最新目标分支并附证据;合入后回收任务工作区与已合入分支。 +- 提交主题行:英文祈使句一行(≤100 列,不以句点结尾);body 写 `Why: / Evidence: / Impact: / Refs:`。 -- 本仓只做意图识别机制(定义、合并、识别、槽位、诊断),不内置任何业务意图内容;意图词表与正则一律由宿主注册或配置。 -- 依赖方向:仅可选接入 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`。 +- 模块边界、公开契约与隔离档位见 `policy/modules/`(如有)与 PROJECT.md。 +- 跨仓 gitlink 变更须经组合验证后在 Dev 仓推进;受保护分支经 PR 合入。 +- 验证命令见 PROJECT.md「验证」节;完成声明须附实际命令输出证据。