From 5da4192bede7dae0e537f8ee29e7cd9fda80ac6e Mon Sep 17 00:00:00 2001 From: cat-shark Date: Sat, 10 Oct 2026 14:38:43 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E9=80=9A=E7=94=A8=E8=A7=84=E5=88=99?= =?UTF-8?q?=E6=94=B6=E5=8F=A3=E5=BE=84=E5=88=B0=20.agents/roles?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/roles/README.md | 1 + .agents/roles/parallel-and-delegation.md | 35 ++++++++++++++++++++++++ AGENTS.md | 9 +++--- 3 files changed, 40 insertions(+), 5 deletions(-) create mode 100644 .agents/roles/parallel-and-delegation.md diff --git a/.agents/roles/README.md b/.agents/roles/README.md index f03f2e8..8d41147 100644 --- a/.agents/roles/README.md +++ b/.agents/roles/README.md @@ -28,3 +28,4 @@ | 规则 | 文件 | 触发点 | |------|------|--------| | todo 收口纪律 | `todo-discipline.md` | 提交后 / 轮末 / 会话压缩后 | +| 并行与委派 | `parallel-and-delegation.md` | 开工排期、派发子任务时 | diff --git a/.agents/roles/parallel-and-delegation.md b/.agents/roles/parallel-and-delegation.md new file mode 100644 index 0000000..d50457d --- /dev/null +++ b/.agents/roles/parallel-and-delegation.md @@ -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 仓库并发写); +完成情况由主代理统一记录。 diff --git a/AGENTS.md b/AGENTS.md index 713ed80..6c636a9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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`(默认并行 / 单写入者 / 派发说明)。 ### 技能