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 仓库并发写);
完成情况由主代理统一记录。