coding.mjs/add-req: 审计简化收敛——bestEffortAction、RESUME 去双写、单次 scan

- bestEffortAction(prompt, {label, phase, okMsg, failTag, errTag})：收敛 recordResume / ensureLedgerBaseline 逐行同构的 try/catch 包裹（失败/异常只 log 绝不阻断主流程； ≠ runAction：不经 adjudicate、绝不 halt）。日志文案与重构前逐字一致（errTag 区分失败/异常两条前缀），返回布尔供水位线判断。 - decisionDigestMd helper 消除决策摘要模板的字节级双份拷贝；flushedCount 水位线（仅 per-module flush 成功才推进）使 loop-end 条目只补「未被逐模块条目覆盖的增量」 ——N 模块全绿不再每条决策在 RESUME.md 写两遍；flush 失败时 loop-end 兜底补记保留。 - add-req 步骤 0/1 合并为单次 scan（scan 输出本就同时含 ledgerExists 与 new/changed/removed，重复扫描纯冗余）；删步骤 6 无操作性说明尾句。

coding.mjs/add-req: 审计简化收敛——bestEffortAction、RESUME 去双写、单次 scan
- bestEffortAction(prompt, {label, phase, okMsg, failTag, errTag})：收敛 recordResume / ensureLedgerBaseline 逐行同构的 try/catch 包裹（失败/异常只 log 绝不阻断主流程； ≠ runAction：不经 adjudicate、绝不 halt）。日志文案与重构前逐字一致（errTag 区分失败/异常两条前缀），返回布尔供水位线判断。 - decisionDigestMd helper 消除决策摘要模板的字节级双份拷贝；flushedCount 水位线（仅 per-module flush 成功才推进）使 loop-end 条目只补「未被逐模块条目覆盖的增量」 ——N 模块全绿不再每条决策在 RESUME.md 写两遍；flush 失败时 loop-end 兜底补记保留。 - add-req 步骤 0/1 合并为单次 scan（scan 输出本就同时含 ledgerExists 与 new/changed/removed，重复扫描纯冗余）；删步骤 6 无操作性说明尾句。
zichun
1 parent 0956071b
Showing 2 changed files with 30 additions and 28 deletions
skills/plan/add-req/SKILL.md
workflows/coding.mjs
@@ -47,15 +47,11 @@ node ${CLAUDE_PLUGIN_ROOT}/lib/req-ledger.mjs scan &lt;root&gt;
   [ERP-HALT] 基线已建立，等待人工追加需求。
   ```
   （理由：首跑若把存量全当新增，会重复生成已有的 docs/03/05 工件并误重跑整仓。基线建立后，后续改动才能被准确 diff。）
-- `true` → 进入步骤 1。
+- `true` → 直接用本次 scan 的输出进入步骤 1 解析（不再重跑 scan）。
 ## 步骤 1：检测增量
-```
-node ${CLAUDE_PLUGIN_ROOT}/lib/req-ledger.mjs scan <root>
-```
-
-解析 `new[]` / `changed[]` / `removed[]`（每项 `{id, kind}`，kind = `req` 后端卡片 / `fe` 前端功能行）。
+用步骤 0 已得到的 scan 输出解析 `new[]` / `changed[]` / `removed[]`（每项 `{id, kind}`，kind = `req` 后端卡片 / `fe` 前端功能行）。
 - `new` 与 `changed` 均为空 → 打印 `[add-req] 无新增 / 变更需求，无需处理。[ERP-HALT]` **停下**（不提交台账）。
 - `removed` 非空 → **仅提示、不自动删**：打印 `检测到台账登记但 docs 已移除的单元：<列出>。下线需求请人工同步 docs/02/03/05 并删除对应 tag，本 skill 不自动执行删除。` 然后继续处理 new/changed（removed 不写回台账，留待人工，下次仍会提示）。
@@ -126,7 +122,7 @@ node ${CLAUDE_PLUGIN_ROOT}/lib/req-ledger.mjs scan &lt;root&gt;
    git -C <root> commit -m "plan(add-req): 增量需求 <新增/变更 id 摘要>（docs/03+05+02+08 delta + V_n + 台账）"
    ```
    - 覆盖范围 = 步骤 2~5 实际改动的全部文件：人工新写的 REQ 卡（docs/01）、新增 migration（sql/migrations/V_n）、同步的 docs/03、补的 docs/05/02 端点与顺序、docs/08 模块行/FE 行与复位的里程碑字段、`.req-ledger.json`。
-   - 步骤 5 的 `git tag -d`（删 req-done/milestone）是对 ref 的操作，不产生工作树文件，不需进本 commit；但删 tag 应在本次 commit **之前或之后**都可（与文件提交独立）。
+   - 步骤 5 的 `git tag -d`（删 req-done/milestone）是对 ref 的操作，不产生工作树文件，不需进本 commit。
    - commit 后用 `git -C <root> status --porcelain` 复核工作树**干净**（无残留）；若仍有未跟踪/未提交项，排查后补提交，确保交给 coding-start 时是干净树。
 3. 然后打印横幅并**停下**（不自动进编码，与「Plan 完不自动进 B」一致）：
@@ -924,6 +924,9 @@ const adjGuidance = (g) =&gt; g ? `\n\n## 隞脰迤誘嚗甈⊿
 // 瘚銝餃蝑敹tage 蝻箏潭銝恕/閫粉嚗霈啣甇歹犖撌乩恣
 const autonomousDecisions = []
+const decisionDigestMd = (list, emptyText) => list.length
+  ? list.map(d => `  - [\`${d.site}\`] ${d.question || '?'}  ${d.choice || '?'}嚗${d.confidence || '?'}嚗).join('\n')
+  : `  - ${emptyText}`
 function recordDecisions(site, decisions) {
   if (!Array.isArray(decisions)) return
   for (const d of decisions) {
@@ -1036,6 +1039,18 @@ async function runAction(makePrompt, { site, grp, label, allowContinue = false }
   throw new Error(`HALT ${site}-adjudication-exhausted: ${ADJUDICATE_MAX} 頧桐輔鋆閫`)
 }
+// best-effort 敺格郊撉斤ㄨ嚗仃韐/撘虜 log 蝏銝餅偌雿瑪餈嚗//  runAction嚗 helper 銝 adjudicate halt
+async function bestEffortAction(prompt, { label, phase: ph, okMsg, failTag, errTag = failTag }) {
+  try {
+    const r = await agent(prompt, { label, phase: ph, schema: ACTION_RESULT_SCHEMA })
+    if (r && r.success) { log(okMsg); return true }
+    log(`${failTag}憭梯揖嚗嚗${(r && r.error) || ''}`)
+  } catch (e) {
+    log(`${errTag}撘虜嚗嚗${String(e?.message || e)}`)
+  }
+  return false
+}
+
 //  蝏剛 handoff嚗ESUME.md嚗alt / 摰餈賢頝刻扇敶 
 // 餈漲潔 git tag嚗ilestone/req-done嚗+ 撌 commit  module-reports / specs 撌乩辣
 // 餈歇霈拍′銝剜 Router 甇＆蝏剛er-feature 蝑撌乩辣ESUME.md 銵亦
@@ -1064,11 +1079,8 @@ function resumeJournalPromptM(sectionMd) {
 }
 async function recordResume(sectionMd) {
   // best-effort嚗賒頝敹仃韐亦銝餅蛹 resume 嚗砲 halt嚗
-  try {
-    const r = await agent(resumeJournalPromptM(sectionMd), { label:'resume-journal', phase:'Milestone', schema: ACTION_RESULT_SCHEMA })
-    if (r && r.success) log('resume-journal 撌脰蕭 RESUME.md')
-    else log(`resume-journal 憭梯揖嚗嚗${(r && r.error) || ''}`)
-  } catch (e) { log(`resume-journal 撘虜嚗嚗${String(e?.message || e)}`) }
+  return bestEffortAction(resumeJournalPromptM(sectionMd),
+    { label: 'resume-journal', phase: 'Milestone', okMsg: 'resume-journal 撌脰蕭 RESUME.md', failTag: 'resume-journal ', errTag: 'resume-journal ' })
 }
 //  瘙韐血蝥選1#3嚗oding 擐 .req-ledger.json 蝻箏仃嚗撱箇僎漱 
@@ -1091,11 +1103,8 @@ function ledgerBaselinePromptM() {
 }
 async function ensureLedgerBaseline() {
   if (!PLUGIN) { log('req-ledger 蝥輯歲餈 pluginRoot嚗 /add-req 擐'); return }
-  try {
-    const r = await agent(ledgerBaselinePromptM(), { label:'req-ledger-baseline', phase:'Router', schema: ACTION_RESULT_SCHEMA })
-    if (r && r.success) log('req-ledger 蝥踹停蝏')
-    else log(`req-ledger 蝥踹仃韐伐嚗${(r && r.error) || ''}`)
-  } catch (e) { log(`req-ledger 蝥踹虜嚗嚗${String(e?.message || e)}`) }
+  return bestEffortAction(ledgerBaselinePromptM(),
+    { label: 'req-ledger-baseline', phase: 'Router', okMsg: 'req-ledger 蝥踹停蝏', failTag: 'req-ledger 蝥' })
 }
 function preflightPromptM() {
   return [
@@ -2141,6 +2150,7 @@ if (todo.length) {
 const results = []
 let haltedAtIdx = -1
+let flushedCount = 0
 for (const [idx, module] of todo.entries()) {
   const decStart = autonomousDecisions.length   // 璅∪銝餃蝑偌雿瑪嚗1#1 憓 flush 嚗
   try {
@@ -2187,16 +2197,14 @@ for (const [idx, module] of todo.entries()) {
     // P1#1 憓 flush嚗葵璅∪摰餈賢 RESUME.md嚗蝙**蝖砌葉**嚗◤嚗銝蜓敺芰撠橘
     // 銋憭歇摰芋鈭銝餃挽 loop-end est-effort嚗
     {
-      const md = autonomousDecisions.slice(decStart)
-      const digest = md.length
-        ? md.map(d => `  - [\`${d.site}\`] ${d.question || '?'}  ${d.choice || '?'}嚗${d.confidence || '?'}嚗).join('\n')
-        : '  - 嚗璅∪銝駁恕霈啣'
-      await recordResume([
+      const moduleDecisions = autonomousDecisions.slice(decStart)
+      const ok = await recordResume([
         '##  璅∪ `' + module.id + '`  milestone/' + module.id + '嚗<ts>嚗',
         '',
         '- **璅∪銝駁恕蝑**嚗撩潭圾霂鳴秤挽嚗',
-        digest,
+        decisionDigestMd(moduleDecisions, '嚗璅∪銝駁恕霈啣'),
       ].join('\n'))
+      if (ok) flushedCount = autonomousDecisions.length   // 隞餈偌雿瑪嚗lush 憭梯揖 loop-end ‘霈
     }
   } catch (e) {
     const reason = String(e.message || e)
@@ -2221,16 +2229,14 @@ const pending = haltedAtIdx &gt;= 0
 // 雿蹂活 coding-start 憭活銝箔 halt / 鈭銝餃挽 / 餈鈭芋
 // 蝖砌葉嚗◤嚗銝銝蝘 halt 霈堆 tag+撌乩辣撌脣 Router 蝏剛
 const halted = results.find(r => r.status === 'halted')
-const decDigest = autonomousDecisions.length
-  ? autonomousDecisions.map(d => `  - [\`${d.site}\`] ${d.question || '?'}  ${d.choice || '?'}嚗${d.confidence || '?'}嚗).join('\n')
-  : '  - 嚗甈∟銝駁恕霈啣'
+const decDigest = decisionDigestMd(autonomousDecisions.slice(flushedCount), '嚗霈啣銝駁恕嚗歇摰芋蝑芋嚗')
 if (halted) {
   const pend = pending.length ? pending.map(p => `\`${p.module}\``).join('') : ''
   await recordResume([
     '##  HALT  璅∪ `' + halted.module + '`嚗<ts>嚗',
     '',
     `- **halt **嚗${halted.reason || '(蝛)'}`,
-    '- **甈∟銝駁恕蝑**嚗撩潭圾霂鳴秤挽嚗窈憭嚗',
+    '- **甈∟銝駁恕蝑**嚗鋡恍芋閬歇摰芋蝑芋嚗窈憭嚗',
     decDigest,
     `- **halt 頝芋**嚗${pend}`,
     '- **銝甇**嚗犖撌乩耨憭憛 `/erp-workflow:coding-start`嚗outer  git tag 蝏剛歇摰芋頝唾',
@@ -2241,7 +2247,7 @@ if (halted) {
     '##  摰<ts>嚗',
     '',
     `- **甈∪芋**嚗${doneList}`,
-    '- **甈∟銝駁恕蝑**嚗',
+    '- **甈∟銝駁恕蝑**嚗鋡恍芋閬',
     decDigest,
   ].join('\n'))
 }