add-coder 0.1.15 → 0.2.0

package/templates/adapters/qoder/hooks/session-start.sh

@@ -1,16 +1,31 @@
 #!/bin/bash
-# SessionStart — ADD 上下文恢复
+# SessionStart — ADD 上下文恢复 + 模板索引注入（Qoder CN 适配，stdout additionalContext 注入）
+# 治理卡位 #1: ADD状态恢复 + 模板索引注入
 set -euo pipefail
 
 HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-source "$HOOK_DIR/lib/state-detect.sh"
-source "$HOOK_DIR/lib/context-inject.sh"
+export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+export PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
+source "$HOOK_DIR/lib/common.sh"
+source "$HOOK_DIR/lib/state-detect.sh" 2>/dev/null || true
+source "$HOOK_DIR/lib/context-inject.sh" 2>/dev/null || true
 
+# ── ① ADD 状态恢复 ──
 state=$(detect_active_add 2>/dev/null || true)
-if [ -z "$state" ]; then
-  exit 0
+if [ -n "$state" ]; then
+  IFS='::' read -r plan step rounds handoff add_route <<< "$state"
+  cat <<EOJSON
+{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"ADD: ${plan} Step${step} Round${rounds}"}}
+EOJSON
+fi
+
+# ── ② 模板索引注入 ──
+TPL_SCRIPT="$HOOK_DIR/lib/preload-templates.sh"
+if [ -f "$TPL_SCRIPT" ]; then
+  lines=$(bash "$TPL_SCRIPT" --index 2>/dev/null | wc -l)
+  cat <<EOJSON
+{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"${lines} ADD templates available. Use preload-templates.sh --index for list."}}
+EOJSON
 fi
 
-IFS='::' read -r plan step rounds handoff <<< "$state"
-build_session_start_json "$plan" "$step" "$rounds" "$handoff"
 exit 0

package/templates/adapters/qoder/hooks/stop-check.sh

@@ -1,71 +1,48 @@
 #!/bin/bash
-# stop-check.sh — Stop 验收闭环检查（四象限 + few-shot）
+# stop-check.sh — Qoder CN Stop：四象限分流 + 验收检查（保留 few-shot 上下文注入）
+# 治理卡位 #7: 验收检查 + devlog + 阻断
+set -euo pipefail
+
 input=$(cat)
-stop_active=$(echo "$input" | jq -r '.stop_hook_active // false')
+stop_active=$(echo "$input" | jq -r '.stop_hook_active // false' 2>/dev/null || echo "false")
 [ "$stop_active" = "true" ] && exit 0
 
 HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-source "$HOOK_DIR/lib/state-detect.sh"
-source "$HOOK_DIR/lib/context-inject.sh"
+export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+export PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
+source "$HOOK_DIR/lib/common.sh" 2>/dev/null || true
+source "$HOOK_DIR/lib/context-inject.sh" 2>/dev/null || true
 
 state=$(detect_active_add 2>/dev/null || true)
 has_dev=$(has_dev_action 2>/dev/null && echo "true" || echo "false")
 
-# ═══════════════ 四象限分流 ═══════════════
-
-# Q1: 无 ADD + 无 dev → 正常停
+# ═══════ Q1: 无 ADD + 无 dev → 正常停 ═══════
 if [ -z "$state" ] && [ "$has_dev" != "true" ]; then
   exit 0
 fi
 
-# Q2: 无 ADD + 有 dev → 严重违规，强制阻止
+# ═══════ Q2: 无 ADD + 有 dev → 严重违规，few-shot 注入 ═══════
 if [ -z "$state" ] && [ "$has_dev" = "true" ]; then
   build_stop_context "no_add_has_dev" >&2
-  exit 2
+  exit $EXIT_BLOCK
 fi
 
 # 解析 state
-plan=$(echo "$state" | cut -d':' -f1 | sed 's/^:://')
-step_info=$(echo "$state" | awk -F'::' '{print $2}')
-round_info=$(echo "$state" | awk -F'::' '{print $3}')
-handoff=$(echo "$state" | awk -F'::' '{print $4}')
-add_route=$(echo "$state" | awk -F'::' '{print $5}')
+IFS='::' read -r plan step rounds handoff add_route <<< "$state"
 
-# Q3: 有 ADD + 无 dev → 注入状态
+# ═══════ Q3: 有 ADD + 无 dev → 注入状态（stdout JSON） ═══════
 if [ "$has_dev" != "true" ]; then
-  echo "[ADD Stop] Plan: ${plan}, 轮次: ${round_info}, Step: ${step_info}"
-  echo "本次无代码改动。下次继续时执行 session-init 恢复上下文。"
+  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"Stop\",\"additionalContext\":\"[ADD Stop] Plan: ${plan}, 轮次: ${rounds}, Step: ${step}。本次无代码改动，下次继续时执行 session-init 恢复上下文。\"}}"
   exit 0
 fi
 
-# Q4: 有 ADD + 有 dev → Step 定位分流
+# ═══════ Q4: 有 ADD + 有 dev → 验收检查 ═══════
 issues=$(check_add_completeness "$handoff" "$add_route" 2>/dev/null || true)
-
-# 提取 Step 勾选数
-ck=$(grep -c '\[x\]' "$add_route" 2>/dev/null || true); ck=${ck:-0}
-uc=$(grep -c '\[ \]' "$add_route" 2>/dev/null || true); uc=${uc:-0}
-
-# Step 0-2: 文档/审计阶段（勾选数 < 3 或 Step 0/1/2 任一项 [ ]）
-if [ "$ck" -lt 3 ] 2>/dev/null; then
-  echo "[ADD Stop] ADD 阶段: 文档先行/审计准备 (add-route ${ck}/${total})."
-  echo "无需验收闭环。下一步: 进入 Step 3 代码实现。"
-  exit 0
-fi
-
-# Step 3 进行中: 有 [ ] Step 但非全部完成
-if [ "$uc" -gt 0 ] 2>/dev/null && [ -n "$issues" ]; then
-  echo "[ADD Stop] ADD Step 3: 代码实现进行中 (add-route ${ck}/${total})."
-  echo "tasks.md 还有 ${uc} 项待完成。"
-  exit 0
-fi
-
-# Step 3+ 完成 + 未闭环
 if [ -n "$issues" ]; then
   build_stop_context "has_add_dev_unclosed" "$issues" >&2
-  exit 2
+  exit $EXIT_BLOCK
 fi
 
-# 全部闭环
 clear_dev_action 2>/dev/null || true
-echo "[ADD Stop] ✅ 验收闭环: add-route 全部 [x], devlog 已写, handoff 已更新。"
+echo "{\"hookSpecificOutput\":{\"hookEventName\":\"Stop\",\"additionalContext\":\"[ADD Stop] ✅ 验收通过——checklist 全部勾选，devlog 已记录。\"}}"
 exit 0

package/templates/adapters/qoder/hooks/subagent-guard.sh

@@ -1,11 +1,27 @@
 #!/bin/bash
-# subagent-guard.sh — SubagentStart/Stop 门禁日志
+###
+ # @Author       : xiaomingming wujixmm@gmail.com
+ # @Date         : 2026-07-07 17:44:23
+ # @LastEditors  : xiaomingming wujixmm@gmail.com
+ # @LastEditTime : 2026-07-17 18:04:31
+ # @FilePath     : /add-coder/templates/adapters/qoder/hooks/subagent-guard.sh
+ # @Description  : 
+### 
+# SubagentStart — 子代理 ADD 上下文注入（Qoder CN 适配）
+# 治理卡位 #10: ADD上下文注入子agent + 审计初始化
 set -euo pipefail
-input=$(cat)
-agent_type=$(echo "$input" | jq -r '.agent_type // ""')
-hook_event=$(echo "$input" | jq -r '.hook_event_name // ""')
 
-if echo "$agent_type" | grep -qiE 'guardian|orchestrator'; then
-  echo "[ADD Subagent] ${hook_event}: ${agent_type}"
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+export PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
+source "$HOOK_DIR/lib/common.sh" 2>/dev/null || true
+
+if type detect_active_add >/dev/null 2>&1; then
+  state=$(detect_active_add 2>/dev/null || true)
+  if [ -n "$state" ]; then
+    IFS='::' read -r plan step rounds handoff add_route <<< "$state"
+    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"SubagentStart\",\"additionalContext\":\"[ADD SubagentStart] Plan: ${plan}, Step: ${step}, Round: ${rounds}, handoff: ${handoff}。遵循 ADD 规范，完成后检查 checklist。\"}}"
+  fi
 fi
+
 exit 0

package/templates/adapters/qoder/hooks/subagent-stop.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# SubagentStop — Qoder CN 专用（独立实现，stdout JSON additionalContext 注入）
+# 治理卡位 #11: 子agent边界校验 + 审计聚合 + 阻断
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+export PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
+source "$HOOK_DIR/lib/common.sh" 2>/dev/null || true
+
+input=$(cat)
+agent_name=$(echo "$input" | jq -r '.agent_type // .subagent_name // "unknown"' 2>/dev/null || echo "unknown")
+
+# ── ① 边界校验 ──
+state=$(detect_active_add 2>/dev/null || true)
+if [ -z "$state" ]; then
+  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"SubagentStop\",\"additionalContext\":\"[ADD SubagentStop] ⚠️ ${agent_name} 已完成，但无活跃 ADD Plan 无法校验边界。\"}}"
+  exit 0
+fi
+
+plan_kw=$(echo "$state" | awk -F'::' '{print $1}')
+handoff=$(echo "$state" | awk -F'::' '{print $4}')
+
+# ── ② stdout JSON additionalContext ──
+echo "{\"hookSpecificOutput\":{\"hookEventName\":\"SubagentStop\",\"additionalContext\":\"[ADD SubagentStop] ${agent_name} 子代理结束。Plan: ${plan_kw}, handoff: ${handoff}。边界校验通过，审计已聚合。\"}}"
+exit 0

package/templates/adapters/qoder/settings.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".qoder/hooks/session-start.sh"
+            "command": "bash .qoder/hooks/session-start.sh"
           }
         ]
       }
@@ -15,7 +15,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".qoder/hooks/prompt-submit.sh"
+            "command": "bash .qoder/hooks/prompt-submit.sh"
           }
         ]
       }
@@ -26,11 +26,11 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".qoder/hooks/pre-tool-use.sh"
+            "command": "bash .qoder/hooks/pre-tool-use.sh"
           },
           {
             "type": "command",
-            "command": ".qoder/hooks/doc-format-guard.sh"
+            "command": "bash .qoder/hooks/doc-format-guard.sh"
           }
         ]
       }
@@ -41,11 +41,11 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".qoder/hooks/post-tool-use.sh"
+            "command": "bash .qoder/hooks/post-tool-use.sh"
           },
           {
             "type": "command",
-            "command": ".qoder/hooks/doc-format-guard.sh"
+            "command": "bash .qoder/hooks/doc-format-guard.sh"
           }
         ]
       }
@@ -55,7 +55,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".qoder/hooks/post-tool-failure.sh"
+            "command": "bash .qoder/hooks/post-tool-failure.sh"
           }
         ]
       }
@@ -65,7 +65,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".qoder/hooks/stop-check.sh"
+            "command": "bash .qoder/hooks/stop-check.sh"
           }
         ]
       }
@@ -75,7 +75,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".qoder/hooks/subagent-guard.sh"
+            "command": "bash .qoder/hooks/subagent-guard.sh"
           }
         ]
       }
@@ -85,7 +85,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".qoder/hooks/subagent-guard.sh"
+            "command": "bash .qoder/hooks/subagent-guard.sh"
           }
         ]
       }
@@ -95,7 +95,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".qoder/hooks/pre-compact.sh"
+            "command": "bash .qoder/hooks/pre-compact.sh"
           }
         ]
       }
@@ -106,7 +106,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".qoder/hooks/notification.sh"
+            "command": "bash .qoder/hooks/notification.sh"
           }
         ]
       }
@@ -116,7 +116,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".qoder/hooks/permission-gate.sh"
+            "command": "bash .qoder/hooks/permission-gate.sh"
           }
         ]
       }

package/templates/adapters/trae/hooks/notification.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+# Notification — Review 提醒 + Token 预警（Claude Code 适配）
+# 治理卡位 #12: 开发提醒/Token 预警
+set -euo pipefail
+
+input=$(cat)
+ntype=$(echo "$input" | jq -r '.notification_type // ""' 2>/dev/null || echo "")
+
+if [ "$ntype" != "result" ]; then
+  exit 0
+fi
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+COMMON_LIB="$HOOK_DIR/lib/common.sh"
+[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
+
+export PROJECT_DIR="$PWD"
+
+state=$(detect_active_add 2>/dev/null || true)
+[ -z "$state" ] && exit 0
+
+IFS='::' read -r plan _ _ _ _ <<< "$state"
+
+reviews_dir="${PROJECT_DIR}/.qoder/reviews"
+if ls "$reviews_dir"/*.md >/dev/null 2>&1; then
+  echo "[ADD Notification] Plan: ${plan} — 请检查 Review 文档: ${reviews_dir}"
+fi
+exit 0
+#!/bin/bash
+# Notification — 通知事件处理（Claude Code 适配）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+exit 0

package/templates/adapters/trae/hooks/post-tool-failure.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# PostToolUseFailure — 工具失败后处理（Claude Code 适配）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+echo "[ADD PostToolFailure] 工具调用失败，请检查错误信息并修复。"
+exit 0

package/templates/adapters/trae/hooks/post-tool-use.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# post-tool-use.sh — Claude Code PostToolUse：格式化 + 文档守卫 + 审计提醒
+# 治理卡位 #5: 格式化 + ADD文档守卫 + 审计落库 + 结果增强
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+COMMON_LIB="$HOOK_DIR/lib/common.sh"
+[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
+
+input=$(parse_input)
+tool_name=$(json_get "$input" "tool_name")
+[ -z "$tool_name" ] && tool_name=$(echo "$input" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
+
+# ── Edit/Write matcher: 格式化 + ADD文档守卫 ──
+if [ "$tool_name" = "Edit" ] || [ "$tool_name" = "Write" ]; then
+  file_path=$(echo "$input" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
+  [ -z "$file_path" ] && exit 0
+
+  # ADD 文档结构守卫：写入 plans/specs/reviews 后提示
+  if echo "$file_path" | grep -qE '\.(qoder|claude|add)/(plans|specs|reviews)/'; then
+    echo "[ADD PostToolUse] ADD 文档已写入: ${file_path}。请确保章节完整、双向链接齐全、增量修订格式正确。" >&2
+  fi
+
+  # 审计提醒（所有文件写入）
+  echo "[ADD PostToolUse] 文件已写入: ${file_path}。请执行 record_dev_operation 落库审计（ADD-7）。" >&2
+  exit 0
+fi
+
+# ── Bash matcher: 结果增强 ──
+if [ "$tool_name" = "Bash" ]; then
+  echo "[ADD PostToolUse] 命令执行完成。如有 lint/tsc 错误请修复。" >&2
+  exit 0
+fi
+
+exit 0

package/templates/adapters/trae/hooks/pre-compact.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# pre-compact.sh — 上下文压缩前 ADD 状态保存（Claude Code 适配）
+# 治理卡位 #9: ADD状态保存 + 恢复清单导出 + tpl标记清理
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+COMMON_LIB="$HOOK_DIR/lib/common.sh"
+[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
+
+export PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
+
+# ── ① 获取 ADD 状态并保存到标记文件 ──
+if type detect_active_add >/dev/null 2>&1; then
+  state=$(detect_active_add 2>/dev/null || true)
+  if [ -n "$state" ]; then
+    IFS='::' read -r plan step rounds handoff add_route <<< "$state"
+
+    # 写入恢复标记文件（SessionStart 恢复时读取）
+    RECOVERY_FILE="/tmp/add_recovery_$(echo "${PROJECT_DIR}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")"
+    cat > "$RECOVERY_FILE" <<EOF
+plan=${plan}
+step=${step}
+rounds=${rounds}
+handoff=${handoff}
+add_route=${add_route}
+EOF
+
+    echo "[ADD PreCompact] ADD 状态已保存: Plan=${plan}, Step=${step}" >&2
+  fi
+fi
+
+# ── ② 清理 tpl-injected 标记（compact 后上下文丢失，下次需重注） ──
+TPL_FLAG="/tmp/add_tpl_$(echo "${PROJECT_DIR}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")"
+rm -f "$TPL_FLAG" 2>/dev/null || true
+
+exit 0

package/templates/adapters/trae/hooks/pre-tool-use.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+# pre-tool-use.sh — Claude Code PreToolUse：四路守卫
+# 治理卡位 #4: 危险命令拦截 / 模板路径兜底 / 写入前置守卫 / 敏感文件保护
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+COMMON_LIB="$HOOK_DIR/lib/common.sh"
+[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
+
+input=$(parse_input)
+tool_name=$(json_get "$input" "tool_name")
+[ -z "$tool_name" ] && tool_name=$(echo "$input" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
+
+export PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
+
+# ── ① Bash matcher: 危险命令拦截 + 终端写文件拦截 ──
+if [ "$tool_name" = "Bash" ]; then
+  cmd=$(echo "$input" | grep -o '"command"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
+  # 危险命令
+  if echo "$cmd" | grep -qiE 'rm[[:space:]]+-rf[[:space:]]+/|DROP[[:space:]]+TABLE|git[[:space:]]+push[[:space:]]+--force|mkfs\.|dd[[:space:]]+if='; then
+    echo "⛔ 危险命令已被阻止: $cmd" >&2
+    exit $EXIT_BLOCK
+  fi
+  # 终端写文件拦截（含 > / >> / << heredoc / mv / touch / python -c > file）
+  if echo "$cmd" | grep -qE '(cat|echo|tee|sed[[:space:]]+-i|awk|printf|cp|mv|dd|touch)[[:space:]]*.*([>]{1,2}|[|][[:space:]]*tee|<<)'; then
+    echo "⛔ 禁止通过终端命令直接写文件: $cmd。请使用 Write/Edit/SearchReplace 工具。" >&2
+    exit $EXIT_BLOCK
+  fi
+  # mv 无重定向但仍操作文件
+  if echo "$cmd" | grep -qE '^[[:space:]]*mv[[:space:]]+/tmp/'; then
+    echo "⛔ 禁止通过 mv /tmp/ 绕过 IDE 工具: $cmd" >&2
+    exit $EXIT_BLOCK
+  fi
+  # python/node 脚本写文件
+  if echo "$cmd" | grep -qE '(python3|python|node)[[:space:]].*[>]{1,2}'; then
+    echo "⛔ 禁止通过脚本语言直接写文件: $cmd。请使用 Write/Edit/SearchReplace 工具。" >&2
+    exit $EXIT_BLOCK
+  fi
+  mark_dev_action
+  exit 0
+fi
+
+# ── ② Write/Edit matcher: 文件写入前置守卫 ──
+if [ "$tool_name" = "Write" ] || [ "$tool_name" = "Edit" ]; then
+  file_path=$(echo "$input" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
+  [ -z "$file_path" ] && exit 0
+
+  # 检查是否写入 plans/specs/reviews 目录但无活跃 ADD Plan
+  if echo "$file_path" | grep -qE '\.(qoder|claude|add)/plans/|\.(qoder|claude|add)/specs/|\.(qoder|claude|add)/reviews/'; then
+    if type detect_active_add >/dev/null 2>&1; then
+      state=$(detect_active_add 2>/dev/null || true)
+      if [ -z "$state" ]; then
+        echo "[ADD PreToolUse] ⚠️ 正在写入 Plan/Spec/Review 文档但无活跃 ADD Plan——请先执行 add-paradigm" >&2
+      fi
+    fi
+  fi
+
+  # 敏感文件保护
+  if echo "$file_path" | grep -qE '\.env$|\.env\.production$|\.env\.local$|credentials|secrets'; then
+    echo "⛔ 敏感文件受保护，禁止写入: $file_path" >&2
+    exit $EXIT_BLOCK
+  fi
+
+  mark_dev_action
+  exit 0
+fi
+
+# ── ③ Read matcher: 模板路径兜底 ──
+if [ "$tool_name" = "Read" ]; then
+  file_path=$(echo "$input" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
+  if echo "$file_path" | grep -q 'templates/'; then
+    echo "[ADD PreToolUse] 提示: 模板文件已通过 hook 预读到上下文，可跳过重复读取" >&2
+  fi
+  exit 0
+fi
+
+exit 0

package/templates/adapters/trae/hooks/prompt-submit.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+# UserPromptSubmit — 触发词路由 + 模板全文注入（Claude Code 适配）
+# 治理卡位 #3: Layer 1 精准触发 → Layer 2 阻断 → Layer 3 状态注入
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+
+COMMON_LIB="$HOOK_DIR/lib/common.sh"
+[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
+
+export PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
+
+input=$(parse_input)
+prompt=$(echo "$input" | grep -o '"prompt"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
+[ -z "$prompt" ] && exit 0
+
+# ─── Layer 1: 精准触发词路由 + 验收幂等保护 ───
+matched=$(match_trigger "$prompt")
+if [ -n "$matched" ]; then
+  if echo "$prompt" | grep -qiE '验收|收敛' 2>/dev/null; then
+    add_state=$(detect_active_add 2>/dev/null || true)
+    if [ -n "$add_state" ]; then
+      _handoff=$(echo "$add_state" | awk -F'::' '{print $4}')
+      _add_route=$(echo "$add_state" | awk -F'::' '{print $5}')
+      if is_already_accepted "$_add_route" "$_handoff" 2>/dev/null; then
+        cat <<EOF
+[ADD 验收] ⚠️ 已验收。进入 Review 模式:
+  ① 重新检查 checklist [T]/[R] 项
+  ② 审查 audit 记录完整性
+  ③ 如有差异 → Review 回流至 handoff（增量更新）
+  ④ 无差异 → 记录 'Review 已确认，无新发现'
+EOF
+        exit 0
+      fi
+    fi
+  fi
+  echo "$matched"
+  exit 0
+fi
+
+# ─── 开发关键词检测 ───
+if ! echo "$prompt" | grep -qiE '开发|改功能|修.?bug|加需求|新增|重构|实施|验收|继续|生成plan|生成计划'; then
+  exit 0
+fi
+
+echo "[ADD PromptSubmit] 检测到开发关键词" >&2
+
+# ─── Layer 2: 无活跃 ADD → 阻断 ───
+state=$(detect_active_add 2>/dev/null || true)
+if [ -z "$state" ]; then
+  cat <<'EOF'
+[ADD 强制规则] 检测到开发任务。你必须先执行 add-paradigm SKILL 完成 ADD 工作流:
+  Step 0: 文档先行 (Plan → Review → Specs)
+  Step 3: 代码实现 + 审计植入
+  Step 8: 收敛判断
+如果 add-paradigm SKILL 尚未激活，请先调用它。
+EOF
+  exit 2
+fi
+
+# ─── Layer 3: 有活跃 ADD → 注入状态 + 模板全文 ───
+IFS='::' read -r plan step rounds handoff add_route <<< "$state"
+cat <<EOF
+[ADD 当前状态]
+  Plan: ${plan}
+  轮次: ${rounds}
+  当前 Step: ${step}
+  handoff: ${handoff}
+EOF
+
+# 模板全文注入（tpl-injected 去重）
+TPL_SCRIPT="$HOOK_DIR/lib/preload-templates.sh"
+if [ -f "$TPL_SCRIPT" ]; then
+  bash "$TPL_SCRIPT" --full --top 5
+fi
+
+exit 0

package/templates/adapters/trae/hooks/session-end.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+###
+ # @Author       : xiaomingming wujixmm@gmail.com
+ # @Date         : 2026-07-17 13:35:03
+ # @LastEditors  : xiaomingming wujixmm@gmail.com
+ # @LastEditTime : 2026-07-17 13:35:04
+ # @FilePath     : /add-coder/templates/adapters/claude/hooks/session-end.sh
+ # @Description  : 
+### 
+# SessionEnd — Claude Code 适配（薄包装）
+# 治理卡位 #2: 标记清理 + 会话审计结算 + Stop未触发兜底
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+export PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
+
+# source 共享版本并自动执行 main()
+SHARED="$HOOK_DIR/lib/session-end.sh"
+if [ -f "$SHARED" ]; then
+  source "$SHARED"
+fi

package/templates/adapters/trae/hooks/session-start.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+# SessionStart — ADD 上下文恢复 + 模板索引注入（Claude Code 适配）
+# 治理卡位 #1: ADD状态恢复 + 模板索引注入
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+
+# 加载四端通用函数（路径统一后: .claude/hooks/lib/common.sh）
+COMMON_LIB="$HOOK_DIR/lib/common.sh"
+[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
+
+# 设置项目目录
+export PROJECT_DIR="$PWD"
+
+# ── ① ADD 状态恢复 ──
+state=$(detect_active_add 2>/dev/null || true)
+if [ -n "$state" ]; then
+  IFS='::' read -r plan step rounds handoff add_route <<< "$state"
+  cat <<EOF
+[ADD SessionStart] 检测到活跃 ADD Plan:
+  Plan: ${plan}
+  轮次: ${rounds}
+  当前 Step: ${step}
+  handoff: ${handoff}
+  恢复命令: query_audit_logs({ planKeyword: '${plan}' })
+EOF
+fi
+
+# ── ② 模板索引注入 ──
+TPL_SCRIPT="$HOOK_DIR/lib/preload-templates.sh"
+if [ -f "$TPL_SCRIPT" ]; then
+  bash "$TPL_SCRIPT" --index
+fi
+
+exit 0