diff --git a/README.md b/README.md index 16d43b8..331316b 100644 --- a/README.md +++ b/README.md @@ -81,7 +81,7 @@ Claude Code 插件：ERP / 后端管理系统全流程开发框架。 ``` erp-workflow-plugin/ ├── .claude-plugin/ -│ └── plugin.json # 插件清单，显式列出 9 个 skill 路径 +│ └── plugin.json # 插件清单，显式列出 8 个 skill 路径 ├── README.md # 本文档 ├── workflows/ │ └── coding.mjs # 阶段 B：整个编码阶段编排为单个静默 Workflow @@ -105,14 +105,14 @@ erp-workflow-plugin/ └── coding-start/ # 启动 workflows/coding.mjs ``` -## Skill 清单（9 个） +## Skill 清单（8 个） ### 入口（2 个） | Skill | 作用 | 谁调用 | |---|---|---| | `plan-start` | **A 阶段入口 + Plan 终结硬闸**。读 docs/08 § 一 找第一个未勾 A 子项 → 派发对应 A skill；A 全部完成时校验 4 项前移闸门（REQ 真实数据、`config-vars.yaml` 全部配置（含 DB 凭据 / 密钥）全锁、docs/04 § 零 命令齐、docs/05+02 已评审），全过才提示运行 `/erp-workflow:coding-start`，否则指出缺口不放行 | **用户手动** `/erp-workflow:plan-start` | -| `coding-start` | **B 阶段瘦入口**（`allowed-tools: Read Glob Workflow Bash(git ...) Bash(pwd)`）。校验 Plan 终结闸（docs/08 § 一 全勾、git 在默认分支、工作树干净）→ 读 docs/08 § 二/§ 三 + `git tag -l 'milestone/*'` 概述阶段进度（Workflow Router 再用 `req-done/*` 判定功能级 resume）→ 调用 `Workflow({scriptPath:"${CLAUDE_PLUGIN_ROOT}/workflows/coding.mjs", args:{projectRoot}})` 启动整个编码阶段 → 告知"已在后台启动" | **用户手动** `/erp-workflow:coding-start` | +| `coding-start` | **B 阶段瘦入口**（`allowed-tools: Read Glob Workflow Bash(git ...)`）。校验 Plan 完成态 + git 就绪（docs/08 § 一 全勾、git 在默认分支或自动切回 halt 残留功能分支、工作树干净）→ 读 docs/08 § 二/§ 三 + `git tag -l 'milestone/*'` 概述阶段进度（Workflow Router 再用 `req-done/*` 判定功能级 resume）→ 调用 `Workflow({scriptPath:"${CLAUDE_PLUGIN_ROOT}/workflows/coding.mjs", args:{projectRoot}})` 启动整个编码阶段 → 告知"已在后台启动" | **用户手动** `/erp-workflow:coding-start` | ### Plan 阶段 A skill（A0~A5，共 6 个） diff --git a/skills/coding/coding-start/SKILL.md b/skills/coding/coding-start/SKILL.md index 3e0b00b..4736c2f 100644 --- a/skills/coding/coding-start/SKILL.md +++ b/skills/coding/coding-start/SKILL.md @@ -1,8 +1,8 @@ --- name: coding-start -description: B 阶段（Coding）瘦入口。校验 Plan 终结闸（docs/08 §一 A0~A5 全勾、已在本地默认分支、工作树干净）后，读取 docs/08 §二/§三 概述模块/前端进度，然后调用 workflows/coding.mjs Workflow 全自动、静默地跑完整个编码阶段（后端+前端功能循环、测试闸、里程碑 tag），跑完或 halt 时返回最终状态。本入口不写任何文件、不做编码决策。 +description: B 阶段（Coding）瘦入口。校验 Plan 完成态与 git 就绪（docs/08 §一 A0~A5 全勾、在本地默认分支或自动切回 halt 残留功能分支、工作树干净）后，读取 docs/08 §二/§三 概述模块/前端进度，然后调用 workflows/coding.mjs Workflow 全自动、静默地跑完整个编码阶段（后端+前端功能循环、测试闸、里程碑 tag），跑完或 halt 时返回最终状态。本入口不写任何文件、不做编码决策。 user-invocable: true -allowed-tools: Read Glob Workflow Bash(pwd) Bash(git rev-parse *) Bash(git status *) Bash(git branch *) Bash(git tag *) +allowed-tools: Read Glob Workflow Bash(git rev-parse *) Bash(git status *) Bash(git branch *) Bash(git checkout *) Bash(git tag *) --- **所有输出必须使用中文。** @@ -35,22 +35,28 @@ allowed-tools: Read Glob Workflow Bash(pwd) Bash(git rev-parse *) Bash(git statu 用 `Glob` 检查 `docs/08-模块任务管理.md`。 - 不存在 → 输出「⚠️ 项目尚未初始化，请先运行 `/erp-workflow:plan-start`」并**停下**，不启动 Workflow。 -### 步骤 2：Plan 终结闸校验（HARD GATE） +### 步骤 2：Plan 完成态 + git 就绪校验（HARD GATE） -`Read` `docs/08-模块任务管理.md`，逐项校验，任一不满足即**拦截、不启动 Workflow**： +`Read` `docs/08-模块任务管理.md`，逐项校验，任一不满足即**拦截、不启动 Workflow**。 + +> 注：REQ 真实数据 / config 全锁 / docs/04 命令齐 / docs/05+02 已评审等**内容闸**由 `plan-start` 终结硬闸把守；本步只校验「Plan 完成态（checkbox）+ git 就绪」，不重复内容校验。 1. **docs/08 § 一 A0~A5 全部勾选** - 读 § 一 进度表，确认 A0/A1/A2/A3/A4/A5（含各自子项）均为 `[x]`。 - 任一未勾 → 缺口：`Plan 未完成（<未勾项>）→ 先运行 /erp-workflow:plan-start`。 -2. **当前在本地默认分支（main / master）** +2. **当前在本地默认分支（main / master）；停在 halt 残留功能分支则自动切回** - 用 `Bash(git rev-parse --show-toplevel)` 确认当前目录在 git 仓库中，并记录 stdout 作为 `projectRoot`。 - - 用 `Bash(git branch --show-current)` 读取当前分支。 - - 用 `Bash(git rev-parse --verify refs/heads/main)` / `refs/heads/master` 依次检测本地默认分支，取第一个存在者；两者都不存在则缺口：`找不到本地默认分支 main/master`。 - - 当前分支不等于默认分支 → 缺口：`当前分支 不是默认分支 `。 + - 用 `Bash(git rev-parse --verify refs/heads/main)` / `refs/heads/master` 依次检测本地默认分支，取第一个存在者作为 ``；两者都不存在则缺口：`找不到本地默认分支 main/master`。 + - 用 `Bash(git branch --show-current)` 读取当前分支 ``，按下列三种情况处理： + - `` == `` → 通过。 + - `` 形如 `module-*` 或等于 `frontend-phase`（= 上次 halt 残留的功能分支；coding.mjs 在模块中途 halt 时 HEAD 停在功能分支，不会自动切回）：先用 `Bash(git status --porcelain)` 检查工作树—— + - **干净** → 用 `Bash(git checkout )` 切回默认分支（续跑点由 coding.mjs Router 从 `milestone/*` / `req-done/*` tag 重算，与所在分支无关），通过；切换失败则缺口：`无法自动切回默认分支 ：`。 + - **不干净** → 缺口：`停在功能分支 且工作树不干净，无法自动切回——请先提交或清理改动后重跑（dirty 前 20 行：<...>）`。 + - 其它分支 → 缺口：`当前分支 不是默认分支 `。 3. **工作树干净（Plan 产物已 commit）** - - 用 `Bash(git status --porcelain)` 检查，stdout 非空即缺口：`工作树不干净（列出前 20 行 dirty 路径）`。 + - 用 `Bash(git status --porcelain)` 检查（步骤 2 自动切回后应仍干净），stdout 非空即缺口：`工作树不干净（列出前 20 行 dirty 路径）`。 任一缺口 → 输出拦截横幅，逐条列出缺口与回填位置，**停下**，不启动 Workflow： @@ -96,12 +102,13 @@ Workflow({ 进度概述：<步骤 3 概述，如「待跑 3 模块 + 前端阶段」> 已程序化校验： - ✓ 当前在本地默认分支（main / master） + ✓ 当前在本地默认分支（main / master；如停在 halt 残留功能分支已自动切回） ✓ 工作树干净，Plan 产物（docs/* + skeleton + DDL）已 commit Workflow 将按模块顺序全自动、静默推进，跑完所有模块或在某模块 halt（测试闸持续 RED / review 5 轮未过 / 缺值阻塞等）时返回最终状态。 - halt 后请按诊断修复，再重新运行 /erp-workflow:coding-start 续跑。 + halt 后请按诊断修复，再重新运行 /erp-workflow:coding-start 续跑 + （残留功能分支会自动切回默认分支，无需手动 checkout；但工作树须先清理干净）。 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ```