docs: 更新 agent 规则并新增项目约束文档

This commit is contained in:
augushong
2026-07-18 23:35:04 +08:00
parent 51d0ed7331
commit ce8a0c795b
6 changed files with 134 additions and 27 deletions

View File

@@ -2,11 +2,25 @@
- `AGENTS.md`(本文件):协作规则入口与导航
- `.agents/`工作流skills、零散规则rules与补充文档
- `.agents/PROJECT.md`:项目业务总览(定位、核心模块、业务约束),由开发者按项目实际情况编写,智能体首次接触项目时应主动读取
- `.agents/PROJECT.md`:项目业务总览(项目概述 + 业务规则索引),由开发者按项目实际情况编写;本文件管"怎么用框架"PROJECT.md 管"这个项目在做什么业务、怎么跑、怎么部署"
- `.agents/rules/`:模块级/场景级零散规则,按文件独立存放(详见「零散规则」章节)
- `.agents/skills/`:按场景调用的工作流技能,统一以 `*/SKILL.md` 为准(详见「工作流」章节)
- 标准开发流程:见「标准开发流程」表格,操作细节见对应技能文件
## 规则导航
本项目规则分两层,智能体进入项目时应先了解全局:
- **框架规则**`ulthon-` 前缀):本文件 + `.agents/rules/ulthon-*`,管"怎么用框架"
- **项目规则**`project-` 前缀):`.agents/PROJECT.md` + `.agents/rules/project-*`,管"这个项目在做什么业务、怎么开发/运行/部署"
两层规则缺一不可。本文件提供框架通用约束,但具体项目的业务语境、实际采用的技术栈与部署模式,都以 PROJECT.md 及其索引的业务规则为准。涉及业务逻辑或环境操作前,应先查阅 PROJECT.md。
完整索引位置:
- 框架内置规则索引:见本文件「零散规则」章节
- 项目业务规则索引:见 `.agents/PROJECT.md` 的「规则索引」章节
涉及具体模块/场景前,先查阅对应索引,确认是否有专属规则。
## 项目级规则(最高优先级 / 唯一权威)
@@ -67,7 +81,7 @@
## 规则维护机制
- **框架基础规则**`AGENTS.md`(本文件)+ `.agents/rules/ulthon-*` 为唯一权威;默认不随任务动态增长
- **使用者补充规则**`.agents/PROJECT.md` + `.agents/rules/project-*`,由开发者维护
- **使用者补充规则**`.agents/PROJECT.md`(项目概述 + 规则索引)+ `.agents/rules/project-*`(具体业务规则),由开发者维护
- **维护约束**:框架作者新增/调整规则前须与开发者确认;使用者身份发现需记录的约束时,优先记录到对应位置
- **管理技能**[ulthon-rules-manager](./.agents/skills/ulthon-rules-manager/SKILL.md)