From a68fa13fc2baf831da1476cdb39449284c9f8a70 Mon Sep 17 00:00:00 2001 From: zichun Date: Mon, 1 Jun 2026 10:59:55 +0800 Subject: [PATCH] coding-start: move git-readiness gate into coding.mjs runtime, slim entry to Plan-check + projectRoot --- skills/coding/coding-start/SKILL.md | 34 ++++++++++++++-------------------- 1 file changed, 14 insertions(+), 20 deletions(-) diff --git a/skills/coding/coding-start/SKILL.md b/skills/coding/coding-start/SKILL.md index 4736c2f..96868c9 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 完成态与 git 就绪（docs/08 §一 A0~A5 全勾、在本地默认分支或自动切回 halt 残留功能分支、工作树干净）后，读取 docs/08 §二/§三 概述模块/前端进度，然后调用 workflows/coding.mjs Workflow 全自动、静默地跑完整个编码阶段（后端+前端功能循环、测试闸、里程碑 tag），跑完或 halt 时返回最终状态。本入口不写任何文件、不做编码决策。 +description: B 阶段（Coding）瘦入口。校验 Plan 完成态（docs/08 §一 A0~A5 全勾）并取得 projectRoot 绝对路径后，读取 docs/08 §二/§三 概述模块/前端进度，然后调用 workflows/coding.mjs Workflow 全自动、静默地跑完整个编码阶段（后端+前端功能循环、测试闸、里程碑 tag）；git 就绪（默认分支/工作树干净/功能分支创建与合并）由 coding.mjs runBranchSetup 在运行时把守。跑完或 halt 时返回最终状态。本入口不写任何文件、不做编码决策。 user-invocable: true -allowed-tools: Read Glob Workflow Bash(git rev-parse *) Bash(git status *) Bash(git branch *) Bash(git checkout *) Bash(git tag *) +allowed-tools: Read Glob Workflow Bash(git rev-parse *) Bash(git tag *) --- **所有输出必须使用中文。** @@ -35,28 +35,21 @@ allowed-tools: Read Glob Workflow Bash(git rev-parse *) Bash(git status *) Bash( 用 `Glob` 检查 `docs/08-模块任务管理.md`。 - 不存在 → 输出「⚠️ 项目尚未初始化，请先运行 `/erp-workflow:plan-start`」并**停下**，不启动 Workflow。 -### 步骤 2：Plan 完成态 + git 就绪校验（HARD GATE） +### 步骤 2：Plan 完成态校验 + 取 projectRoot（HARD GATE） -`Read` `docs/08-模块任务管理.md`，逐项校验，任一不满足即**拦截、不启动 Workflow**。 +`Read` `docs/08-模块任务管理.md` 校验 Plan 完成态，并取得 `projectRoot`；任一不满足即**拦截、不启动 Workflow**。 -> 注：REQ 真实数据 / config 全锁 / docs/04 命令齐 / docs/05+02 已评审等**内容闸**由 `plan-start` 终结硬闸把守；本步只校验「Plan 完成态（checkbox）+ git 就绪」，不重复内容校验。 +> 注：REQ 真实数据 / config 全锁 / docs/04 命令齐 / docs/05+02 已评审等**内容闸**由 `plan-start` 终结硬闸把守；本步只校验「Plan 完成态（checkbox）」，不重复内容校验。 +> +> 注：git 就绪（在默认分支 / 工作树干净 / 功能分支创建与合并）由 coding.mjs `runBranchSetup` 在运行时把守——分支已存在则 checkout、不存在则从默认分支新建（与当前所停分支无关），工作树不干净会立即 HALT；续跑点由 Router 从 `milestone/*` tag + docs/08 字段重算，与所在分支无关。故本入口不再做 git 就绪预检，只取 `projectRoot` 供步骤 4。 1. **docs/08 § 一 A0~A5 全部勾选** - 读 § 一 进度表，确认 A0/A1/A2/A3/A4/A5（含各自子项）均为 `[x]`。 - 任一未勾 → 缺口：`Plan 未完成（<未勾项>）→ 先运行 /erp-workflow:plan-start`。 -2. **当前在本地默认分支（main / master）；停在 halt 残留功能分支则自动切回** - - 用 `Bash(git rev-parse --show-toplevel)` 确认当前目录在 git 仓库中，并记录 stdout 作为 `projectRoot`。 - - 用 `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)` 检查（步骤 2 自动切回后应仍干净），stdout 非空即缺口：`工作树不干净（列出前 20 行 dirty 路径）`。 +2. **取得 projectRoot 绝对路径（取参数，非 gate）** + - 用 `Bash(git rev-parse --show-toplevel)` 取仓库根，记录 stdout 作为 `projectRoot`（步骤 4 必须传入；coding.mjs 顶部对相对路径硬 HALT）。 + - 命令失败（当前目录不在 git 仓库内）→ 缺口：`无法取得 projectRoot（当前目录不在 git 仓库内）`。 任一缺口 → 输出拦截横幅，逐条列出缺口与回填位置，**停下**，不启动 Workflow： @@ -102,13 +95,14 @@ Workflow({ 进度概述：<步骤 3 概述，如「待跑 3 模块 + 前端阶段」> 已程序化校验： - ✓ 当前在本地默认分支（main / master；如停在 halt 残留功能分支已自动切回） - ✓ 工作树干净，Plan 产物（docs/* + skeleton + DDL）已 commit + ✓ Plan 完成态：docs/08 §一 A0~A5 全勾 + ✓ 已取得 projectRoot（仓库根绝对路径），传入 Workflow Workflow 将按模块顺序全自动、静默推进，跑完所有模块或在某模块 halt（测试闸持续 RED / review 5 轮未过 / 缺值阻塞等）时返回最终状态。 halt 后请按诊断修复，再重新运行 /erp-workflow:coding-start 续跑 - （残留功能分支会自动切回默认分支，无需手动 checkout；但工作树须先清理干净）。 + （git 分支由 coding.mjs 自行处理：残留功能分支直接续用、新模块从默认分支建， + 无需手动 checkout；但工作树不干净会在运行时 HALT，故重跑前请先清理工作树）。 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` -- libgit2 0.22.2