From 095364cd7a15a5978144474d55f93fb3a65d1237 Mon Sep 17 00:00:00 2001
From: yanghl <mar105@126.com>
Date: Thu, 11 Jun 2026 13:14:10 +0800
Subject: [PATCH] fix(hooks): 恢复 Stop 钩子自动续跑编码流程（Workflow 重写时被误删）

---
 .gitattributes                       |  4 ++++
 hooks/hooks.json                     | 19 +++++++++++++++++++
 hooks/scripts/auto-continue.sh       | 72 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 hooks/scripts/reset-stall-counter.sh | 16 ++++++++++++++++
 skills/coding/coding-start/SKILL.md  |  4 ++++
 5 files changed, 115 insertions(+), 0 deletions(-)
 create mode 100644 .gitattributes
 create mode 100644 hooks/hooks.json
 create mode 100755 hooks/scripts/auto-continue.sh
 create mode 100755 hooks/scripts/reset-stall-counter.sh

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..322dfa9
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,4 @@
+# Shell hook scripts must keep LF endings — CRLF breaks the `#!/usr/bin/env bash`
+# shebang and `\r` leaks into the JSON the Stop hook prints. Force LF in the working tree.
+*.sh text eol=lf
+hooks/hooks.json text eol=lf
diff --git a/hooks/hooks.json b/hooks/hooks.json
new file mode 100644
index 0000000..ef4c4a2
--- /dev/null
+++ b/hooks/hooks.json
@@ -0,0 +1,19 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "",
+        "hooks": [
+          { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT}\"/hooks/scripts/reset-stall-counter.sh" }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT}\"/hooks/scripts/auto-continue.sh" }
+        ]
+      }
+    ]
+  }
+}
diff --git a/hooks/scripts/auto-continue.sh b/hooks/scripts/auto-continue.sh
new file mode 100755
index 0000000..9f173bf
--- /dev/null
+++ b/hooks/scripts/auto-continue.sh
@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+# Stop 钩子：让 ERP workflow 在回合中途结束时自动续跑，除非命中「终止标记」或「防循环上限」。
+#
+# 背景：编码阶段（逐 REQ：spec→plan→tdd→verify→review→docs/08，或 coding.mjs Workflow 之外的
+# 手动推进）做完一段会退回 Claude 默认行为——报告、停下、等用户敲 continue。本钩子在 Stop 事件
+# 拦下这次停止并自动喂「继续推进」，使各子任务一口气跑完，用户无需手敲 continue。
+#
+# 设计：
+#   1. 终止标记 [ERP-HALT] —— 终止/硬护栏点（全部完成、test-gate 持续红、路径护栏、
+#      Workflow 已启动转后台、缺值阻塞等）打印它。出现即放行停下。
+#   2. 防循环 —— 连续「无工具调用」的空转停止累加计数；达到上限放行停下。
+#      正常推进时由 PostToolUse 的 reset-stall-counter.sh 清零（或本钩子自检 transcript 增长清零），
+#      故真流程不受限。
+#   3. 否则 —— block 并喂一句「继续推进」指令。
+set -u
+
+INPUT="$(cat)"
+
+SENTINEL='[ERP-HALT]'
+MAX_STALL=8
+
+# —— 从 stdin JSON 取字段（不依赖 jq）——
+get_str() {
+  printf '%s' "$INPUT" \
+    | sed -n "s/.*\"$1\"[[:space:]]*:[[:space:]]*\"\([^\"]*\)\".*/\1/p" \
+    | head -n1
+}
+TRANSCRIPT="$(get_str transcript_path)"
+# 反转义 Windows 路径里的 \\ 与 \/
+TRANSCRIPT="${TRANSCRIPT//\\\\//}"
+TRANSCRIPT="${TRANSCRIPT//\\//}"
+
+# 计数器文件（按会话 transcript 路径派生 key，避免多会话互相干扰）
+KEY="$(printf '%s' "$TRANSCRIPT" | tr -cd 'A-Za-z0-9' | tail -c 40)"
+[ -z "$KEY" ] && KEY="default"
+CNT_FILE="${TMPDIR:-/tmp}/erp-autocont-$KEY"
+SIZE_FILE="${TMPDIR:-/tmp}/erp-autosize-$KEY"
+
+allow_stop() { rm -f "$CNT_FILE" "$SIZE_FILE" 2>/dev/null; exit 0; }
+
+# 1) 终止标记出现在最近的 transcript 尾部 → 放行停下
+if [ -n "$TRANSCRIPT" ] && [ -f "$TRANSCRIPT" ]; then
+  if tail -c 16000 "$TRANSCRIPT" 2>/dev/null | grep -qF "$SENTINEL"; then
+    allow_stop
+  fi
+fi
+
+# 2) 进展自复位（自包含，不依赖 PostToolUse）：transcript 自上次停止以来显著增长
+#    → 说明这一轮做了实质工作（工具调用 + 结果），清零空转计数。
+CUR_SIZE=0
+[ -n "$TRANSCRIPT" ] && [ -f "$TRANSCRIPT" ] && CUR_SIZE="$(wc -c < "$TRANSCRIPT" 2>/dev/null | tr -d ' ')"
+case "$CUR_SIZE" in (''|*[!0-9]*) CUR_SIZE=0 ;; esac
+LAST_SIZE=0
+[ -f "$SIZE_FILE" ] && LAST_SIZE="$(cat "$SIZE_FILE" 2>/dev/null || echo 0)"
+case "$LAST_SIZE" in (''|*[!0-9]*) LAST_SIZE=0 ;; esac
+echo "$CUR_SIZE" > "$SIZE_FILE"
+if [ $((CUR_SIZE - LAST_SIZE)) -gt 4000 ]; then
+  rm -f "$CNT_FILE" 2>/dev/null
+fi
+
+# 3) 防循环：连续空转停止达到上限 → 放行停下
+CNT=0
+[ -f "$CNT_FILE" ] && CNT="$(cat "$CNT_FILE" 2>/dev/null || echo 0)"
+case "$CNT" in (''|*[!0-9]*) CNT=0 ;; esac
+if [ "$CNT" -ge "$MAX_STALL" ]; then
+  allow_stop
+fi
+echo $((CNT + 1)) > "$CNT_FILE"
+
+# 拦下停止 → 续跑
+printf '%s' '{"decision":"block","reason":"继续推进 ERP 编码流程：直接执行下一步——若上一个 REQ/任务已完成且 docs/08 已勾，立即开始下一个未完成 REQ 的完整生命周期（spec→plan→TDD→verify→review→docs/08）；若当前 skill 刚结束，用 Skill 工具调用链中的下一个 skill 或对应派发器。不要输出收尾叙述、不要停下问用户是否继续。只有打印了 [ERP-HALT] 的终止/硬护栏点（全部完成、测试闸持续红、缺值阻塞、Workflow 已转后台）才应停下。"}'
+exit 0
diff --git a/hooks/scripts/reset-stall-counter.sh b/hooks/scripts/reset-stall-counter.sh
new file mode 100755
index 0000000..a58e028
--- /dev/null
+++ b/hooks/scripts/reset-stall-counter.sh
@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# PostToolUse 钩子：任何工具调用都视为「有进展」，清零 auto-continue.sh 的空转计数。
+# 这样真正在推进的流程可无限续跑，只有「连续多次纯文字、零工具」的空转才会触发防循环上限。
+set -u
+
+INPUT="$(cat)"
+TRANSCRIPT="$(printf '%s' "$INPUT" \
+  | sed -n 's/.*"transcript_path"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' \
+  | head -n1)"
+TRANSCRIPT="${TRANSCRIPT//\\\\//}"
+TRANSCRIPT="${TRANSCRIPT//\\//}"
+
+KEY="$(printf '%s' "$TRANSCRIPT" | tr -cd 'A-Za-z0-9' | tail -c 40)"
+[ -z "$KEY" ] && KEY="default"
+rm -f "${TMPDIR:-/tmp}/erp-autocont-$KEY" 2>/dev/null
+exit 0
diff --git a/skills/coding/coding-start/SKILL.md b/skills/coding/coding-start/SKILL.md
index a502235..ff598a5 100644
--- a/skills/coding/coding-start/SKILL.md
+++ b/skills/coding/coding-start/SKILL.md
@@ -122,9 +122,13 @@ Workflow({
  halt 后请按诊断修复，再重新运行 /erp-workflow:coding-start 续跑
  （git 分支由 coding.mjs 自行处理：残留功能分支直接续用、新模块从默认分支建，
   无需手动 checkout；但工作树不干净会在运行时 HALT，故重跑前请先清理工作树）。
+
+ [ERP-HALT] Workflow 已转入后台自治，主循环就此停下等待其完成通知。
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
+> `[ERP-HALT]` 标记供 Stop 钩子（`hooks/scripts/auto-continue.sh`）识别：Workflow 一旦转后台，主循环应停下等通知，**不**被自动续跑机制误推去重启 coding-start。逐 REQ 手动推进的会话则无此标记，由 Stop 钩子自动续跑，直到打印 `[ERP-HALT]`（全部完成 / 硬护栏）才停。
+
 本 skill 到此结束，**不调用任何下游 skill**。
 
 ## 参考
--
libgit2 0.22.2