mirror of
https://gitee.com/ulthon/ulthon_admin.git
synced 2026-07-08 02:52:49 +08:00
docs: 重构智能体规范文档并新增项目业务总览模板
- 将业务侧增量规则记录从 `.agents/AGENTS.md` 迁移至 `.agents/PROJECT.md` 的「增量规则记录」章节 - 新增 `.agents/PROJECT.md` 作为项目业务总览模板,包含项目定位、核心模块等结构化章节 - 更新根目录 `AGENTS.md` 中的引用与说明,明确 `.agents/PROJECT.md` 的用途 - 为技能文件添加命名约定说明(ulthon- 与 project- 前缀)
This commit is contained in:
10
AGENTS.md
10
AGENTS.md
@@ -1,9 +1,11 @@
|
||||
# 智能体协作规范(Ulthon Admin)
|
||||
|
||||
- `AGENTS.md`(本文件):协作规则入口与导航
|
||||
- `.agents/`:工作流(skills)与补充文档(含业务侧规则:`.agents/AGENTS.md`)
|
||||
- `.agents/`:工作流(skills)与补充文档(含项目业务总览:`.agents/PROJECT.md`)
|
||||
- `.agents/PROJECT.md`:项目业务总览(定位、核心模块、业务约束),由开发者按项目实际情况编写,智能体首次接触项目时应主动读取
|
||||
- 标准开发流程:见「标准开发流程」表格,操作细节见对应技能文件
|
||||
|
||||
|
||||
## 项目级规则(最高优先级 / 唯一权威)
|
||||
|
||||
与其他文档、聊天内容、或智能体建议冲突时,一律以本节为准。
|
||||
@@ -68,17 +70,19 @@
|
||||
本仓库的规则分两类:
|
||||
|
||||
- **框架基础规则(稳定)**:根目录 `AGENTS.md`(本文件)中的「项目级规则」为唯一权威;默认不随任务动态增长。
|
||||
- **使用者补充规则(业务侧)**:开发中用户/开发者补充的“项目规则/团队偏好/临时约束”,统一记录到 [.agents/AGENTS.md](./.agents/AGENTS.md)。
|
||||
- **使用者补充规则(业务侧)**:开发中用户/开发者补充的“项目规则/团队偏好/临时约束”,统一记录到 [.agents/PROJECT.md](./.agents/PROJECT.md)。
|
||||
|
||||
维护约束(必须遵守):
|
||||
|
||||
- 智能体以“框架作者”身份开发时,如需新增/调整规则,必须先与开发者确认是否记录、记录位置与具体写法,并按确认结果落到对应规则文件。
|
||||
- 智能体以“使用框架的开发者”身份执行任务时,如发现需要记录或调整的项目约束,应更新到对应规则文件(业务侧约束优先记录到 `.agents/AGENTS.md`),并可按开发者要求随时调整。
|
||||
- 智能体以“使用框架的开发者”身份执行任务时,如发现需要记录或调整的项目约束,应更新到对应规则文件(业务侧约束优先记录到 `.agents/PROJECT.md` 的「增量规则记录」章节),并可按开发者要求随时调整。
|
||||
|
||||
## 工作流(Skills)
|
||||
|
||||
Skills 是“按场景调用的工作流说明”,统一以 `.agents/skills/*/SKILL.md` 为准。
|
||||
|
||||
|
||||
- 技能命名约定:`ulthon-` 前缀为框架内置技能,`project-` 前缀为项目业务技能。新增业务技能时使用 `project-` 前缀。
|
||||
- Base/App 架构与扩展指南(含身份分章节):[ulthon-base-app-architecture](./.agents/skills/ulthon-base-app-architecture/SKILL.md)
|
||||
- Scheme + CURD 工作流:[ulthon-scheme-curd-workflow](./.agents/skills/ulthon-scheme-curd-workflow/SKILL.md)
|
||||
- Scheme 定义指南:[ulthon-scheme-definition](./.agents/skills/ulthon-scheme-definition/SKILL.md)
|
||||
|
||||
Reference in New Issue
Block a user