32 lines
1.5 KiB
Markdown
32 lines
1.5 KiB
Markdown
# 通用规则(`.agents/roles/`)
|
||
|
||
存放**跨仓库通用的代理行为规则**。
|
||
|
||
目录名叫 `roles`,但里面不放「角色扮演」式定义(没有「你是某某角色、你的职责是……」),
|
||
**只记录规则本身**:什么情况下必须做什么、怎么核对。
|
||
|
||
## 放什么,不放什么
|
||
|
||
判断标准只有一句:**这条规则换到另一个仓库还成立吗?**
|
||
|
||
| 内容 | 位置 | 例子 |
|
||
|------|------|------|
|
||
| 通用规则(不限仓库) | 本目录,meta 统一管理 | 提交后收口 todo、轮末对账 |
|
||
| 项目专属规则 | 各仓库自己的 `AGENTS.md` | 后端的迁移写法、前端的测试隔离 |
|
||
| 项目知识与架构约定 | 各仓库 `AGENTS.md` | 端口、调用关系、命名约定 |
|
||
| 跨仓库待办与验收标准 | `OPTIMIZATION_BACKLOG.md` | 优化条目 |
|
||
| 按任务触发的专业指令 | `.agents/skills/` | 绘图评审流程 |
|
||
|
||
## 生效方式(重要)
|
||
|
||
**`.agents/roles/` 不是自动加载入口。** 规则要真正约束行为,必须在 `AGENTS.md` 里被引用——
|
||
`AGENTS.md` 是每次会话自动加载的项目指令入口,只有它(和按描述触发的 skills)会被读到。
|
||
所以:新增规则时,务必同时在 `AGENTS.md` 对应章节挂上入口。
|
||
|
||
## 规则清单
|
||
|
||
| 规则 | 文件 | 触发点 |
|
||
|------|------|--------|
|
||
| todo 收口纪律 | `todo-discipline.md` | 提交后 / 轮末 / 会话压缩后 |
|
||
| 并行与委派 | `parallel-and-delegation.md` | 开工排期、派发子任务时 |
|