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
+1
View File
@@ -28,3 +28,4 @@
| 规则 | 文件 | 触发点 |
|------|------|--------|
| todo 收口纪律 | `todo-discipline.md` | 提交后 / 轮末 / 会话压缩后 |
| 并行与委派 | `parallel-and-delegation.md` | 开工排期、派发子任务时 |
+35
View File
@@ -0,0 +1,35 @@
# 并行与委派
## 为什么有这条规则
本工作区是多仓库结构(meta + 5 个子项目),可并行的活儿很多,但同一目录只允许一个写入者。
串行推进浪费最大,盲目并行会互相覆盖。这条规则把「什么时候并行、什么时候串行、怎么派活」固定下来。
2026-10-10 之前,这条规则被复制到了 meta、lpt-be、lpt-fe 三个 `AGENTS.md`,
措辞还不一致,`lpt-ai` / `lpt-docs` 又没有同步——同一套约束在 5 个仓库里各不相同。
现在统一到本文件,各仓库不再重复。
## 规则
### 默认并行
不同子项目之间、或同一项目内互不依赖的任务,**必须同时推进**,不要逐个串行。
不要凭「感觉」判定可以串行。
### 只有真实依赖才串行
存在真实依赖(后一步要用前一步的产出)时才串行,并在派发说明里写明依赖点。
### 同一目录单写入者
同一仓库 / 工作目录同时只允许一个写入者。第二个写入者要么等,要么用 worktree 隔离。
### 派发说明要写全
派发子任务时把**已确认口径、涉及文件、验收命令、提交信息**写清楚。
信息不全的子任务会退回,不要用「你看着办」代替。
### meta 仓库只由主代理写
`OPTIMIZATION_BACKLOG.md` 只由主代理更新,子代理不要改(避免 meta 仓库并发写);
完成情况由主代理统一记录。
+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`(默认并行 / 单写入者 / 派发说明)。
### 技能