From 1251c274bb55b2870793471e5eb3463a1e13f703 Mon Sep 17 00:00:00 2001 From: zichun <26684461+reporkey@users.noreply.github.com> Date: Fri, 12 Jun 2026 22:04:47 +0800 Subject: [PATCH] coding-start/README: 并行透传 parallel:{modules:true,maxWidth:3} + 阶段 B 文档同步——features 闸刻意不传（留 Task 14 验收开启），逃生口 modules:false 完全回退串行 --- README.md | 9 ++++++++- skills/coding/coding-start/SKILL.md | 7 +++++-- 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index b2301d4..766f610 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,14 @@ Claude Code 插件：ERP / 后端管理系统全流程开发框架。 coding.mjs Router → 解析 docs/08 § 二/§ 三 + milestone/* / req-done/* git tag，列出待跑模块 │ - ├─ B-后端（按模块循环，每模块一个里程碑 tag；功能链顺序 for-await，单工作树串行 commit） + ├─ B-后端（按依赖波次推进模块，每模块一个里程碑 tag；模块内功能链仍顺序 for-await） + │ · 调度：LLM 只输出模块间依赖边（fk/api/seed/order…，宁串勿并、证据可查）， + │ JS 做确定性拓扑波次（Kahn）；同波次 ≥2 模块才启用并行机器，宽 1 波次走现行主根路径 + │ · lane 隔离：并行模块各占 lane worktree（独立 index，commit 不争锁）+ lane 测试库 + │ （ERP_TEST_DB_SCHEMA 打穿到 Spring）+ 专属 migration 版本段（版本号只保唯一、 + │ 不保连续不保合并序，Flyway 须 out-of-order: true）；milestone/RESUME 与起栈类 stage 全局互斥 + │ · 降级：任何并行机制失败（调度违例/环/lane DB 不支持/worktree 建失败）一律 fail-open + │ 回现行串行路径，绝不因并行机制 halt；args.parallel 缺省或 modules:false 即全串行 │ runBranchSetup(module-) ← JS 编排：detect default → wt clean → exists? → │ checkout/create → confirm HEAD（5 微 agent） │ → featureLoop(后端)：spec → plan → tdd → verify → review（有界 5 轮修复， diff --git a/skills/coding/coding-start/SKILL.md b/skills/coding/coding-start/SKILL.md index 0a123d1..4f2ae7c 100644 --- a/skills/coding/coding-start/SKILL.md +++ b/skills/coding/coding-start/SKILL.md @@ -97,12 +97,15 @@ Workflow({ scriptPath: "${CLAUDE_PLUGIN_ROOT}/workflows/coding.mjs", args: { projectRoot: "", - pluginRoot: "${CLAUDE_PLUGIN_ROOT}" + pluginRoot: "${CLAUDE_PLUGIN_ROOT}", + parallel: { modules: true, maxWidth: 3 } } }) ``` > `pluginRoot` 供 coding.mjs 调用插件 `lib/req-ledger.mjs` 在首跑时自动建立需求台账基线（P1#3，使日后 `/add-req` 能识别增量、免空跑）；缺省则该增强静默跳过。 +> +> `parallel` 是模块级并行总开关：`modules: true` 时 coding.mjs 先跑调度器（LLM 只输出模块间依赖边，JS 做确定性拓扑波次），同波次 ≥2 个后端模块各自在 lane worktree + lane 测试库 + 专属 migration 版本段内并行推进；任何调度/隔离环节失败一律 fail-open 降级串行，绝不因并行机制 halt。**逃生口**：改传 `parallel: { modules: false }`（或整个不传 `parallel`）即完全回退现行串行路径。`features`（feature 级并行）**刻意不传**——维持缺省关闭，待并行化计划 Task 14 收益评估通过后才在此处开启（附录补 1）。 ### 步骤 5：告知用户 Workflow 已启动 @@ -118,7 +121,7 @@ Workflow({ ✓ Plan 完成态：docs/08 §一 A0~A5 全勾 ✓ 已取得 projectRoot（仓库根绝对路径），传入 Workflow - Workflow 将按模块顺序全自动、静默推进，跑完所有模块或在某模块 + Workflow 将按依赖波次全自动、静默推进，跑完所有模块或在某模块 halt（测试闸持续 RED / review 5 轮未过 / 缺值阻塞等）时返回最终状态。 halt 后请按诊断修复，再重新运行 /erp-workflow:coding-start 续跑 （git 分支由 coding.mjs 自行处理：残留功能分支直接续用、新模块从默认分支建， -- libgit2 0.22.2