mirror of
https://gitee.com/ulthon/ulthon_admin.git
synced 2026-08-30 12:45:32 +08:00
docs: 更新 agent 规则并新增项目约束文档
This commit is contained in:
18
AGENTS.md
18
AGENTS.md
@@ -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)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user