mirror of
https://gitee.com/ulthon/ulthon_admin.git
synced 2026-07-07 18:42: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:
@@ -1,20 +0,0 @@
|
||||
# 项目使用者补充规则(业务侧)
|
||||
|
||||
本文件用于记录“使用框架的开发者(做业务)”在开发过程中补充的项目规则、团队偏好与临时约束。
|
||||
|
||||
## 定位与优先级
|
||||
|
||||
- 根目录 [AGENTS.md](../AGENTS.md) 的「项目级规则」为唯一权威;本文件不得覆盖或弱化其内容。
|
||||
- 本文件只记录**业务侧/项目侧**的增量约束(例如:交付格式、验证方式、代码生成偏好、团队约定等)。
|
||||
- 如发现需要变更框架基础规则,应由框架作者将规则整理并合并到根目录 `AGENTS.md` 的「项目级规则」或其他对应规则文件中。
|
||||
|
||||
## 维护方式(必须遵守)
|
||||
|
||||
- 智能体以“使用框架的开发者”身份执行任务时,如发现需要记录或调整的项目约束,应更新到本文件,并可按开发者要求随时调整。
|
||||
- 智能体以“框架作者”身份开发时,如需调整本文件内容,必须先与开发者确认记录位置与写法,并按确认结果执行。
|
||||
- 规则应可执行、可复现、可验证;避免空泛口号。
|
||||
|
||||
## 记录模板(按条新增)
|
||||
|
||||
| 日期 | 场景/触发 | 规则内容(可执行) | 影响范围 | 来源(文件/路径/命令) | 状态(临时/已合并) |
|
||||
|---|---|---|---|---|---|
|
||||
30
.agents/PROJECT.md
Normal file
30
.agents/PROJECT.md
Normal file
@@ -0,0 +1,30 @@
|
||||
# 项目业务总览(PROJECT)
|
||||
|
||||
> 本文件记录项目的业务上下文,帮助智能体快速理解"这个项目在做什么"。
|
||||
> 框架使用规则见根目录 `AGENTS.md`。
|
||||
|
||||
## 项目定位
|
||||
|
||||
(待填写。用一两句话描述项目是做什么的。)
|
||||
|
||||
## 核心业务模块
|
||||
|
||||
(待填写。列出主要业务模块及其对应目录。)
|
||||
|
||||
## 业务约束
|
||||
|
||||
(待填写。框架不涉及但业务必须遵守的规则。)
|
||||
|
||||
## 技术选型与外部依赖
|
||||
|
||||
(待填写。项目中使用的特殊技术或外部服务。)
|
||||
|
||||
## 开发偏好
|
||||
|
||||
(待填写。团队或开发者的个性化偏好。)
|
||||
|
||||
## 增量规则记录
|
||||
|
||||
开发过程中补充的业务规则、团队偏好与临时约束,按条新增。规则应可执行、可复现、可验证。
|
||||
|
||||
(待填写。)
|
||||
Reference in New Issue
Block a user