docs: 通用规则收口径到 .agents/roles

This commit is contained in:
cat-shark
2026-10-10 14:38:43 +08:00
parent d3e7f713d8
commit 5da4192bed
3 changed files with 40 additions and 5 deletions
+4 -5
View File
@@ -73,10 +73,9 @@ clone 完成后,进入或修改某个子项目前,先读取该子项目根
## 工作区规则
- **默认并行**:不同子项目之间、或同一项目内互不依赖的任务,必须同时推进,不要逐个串行。
- 可并行的工作优先用 `subagent` 派到对应子项目执行;同一仓库/工作目录同时只允许一个写入者(第二个写入者要么等,要么用 worktree 隔离)。
- 只有存在真实依赖(后一步要用前一步的产出)时才串行,并在派发说明里写明依赖点;不要凭「感觉」串行。
- 派发子任务时把已确认口径、涉及文件、验收命令、提交信息写清楚;`OPTIMIZATION_BACKLOG.md` 只由主代理更新,子代理不要改(避免 meta 仓库并发写)。
> 「什么时候并行、什么时候串行、怎么派活」属于通用规则,见 `.agents/roles/parallel-and-delegation.md`,此处不再重复。
- 可并行的工作优先用 `subagent` 派到对应子项目执行。
- 本 meta 仓库只维护 `AGENTS.md`、`.gitignore`、`.agents/`(代理技能与通用规则)和 `docs/diagrams/`(图表评审产物),不要在本仓库根目录创建业务代码或系统文档。
- `.gitignore` 忽略所有子项目目录,只放行上述根级条目,避免把独立 Git 仓库提交进本 meta 仓库。
- 不要删除子项目内的 `.git`,也不要对子项目执行跨仓库的 `git add .`。
@@ -93,7 +92,7 @@ clone 完成后,进入或修改某个子项目前,先读取该子项目根
- **项目专属规则** 留在各仓库自己的 `AGENTS.md`(后端迁移写法、前端测试隔离之类)。
- 新增通用规则时,记得在 `AGENTS.md` 里挂上入口:`.agents/roles/` **不是自动加载目录**,
只有 `AGENTS.md`(与按描述触发的 skills)会被读到,不引用等于不生效。
- 现行通用规则:`todo-discipline.md`(提交后收口 / 轮末对账 / 压缩后对账)。
- 现行通用规则:`todo-discipline.md`(提交后收口 / 轮末对账 / 压缩后对账)、`parallel-and-delegation.md`(默认并行 / 单写入者 / 派发说明)。
### 技能