add-coder 0.2.1 → 0.2.3

package/templates/adapters/qoder/hooks/doc-format-guard.sh

@@ -4,20 +4,31 @@ set -euo pipefail
 
 input=$(cat)
 
+# 动态探测 MAGIC_DIR（兼容多 adapter）
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+PARENT_DIR="$(dirname "$HOOK_DIR")"
+MAGIC_DIR="$(basename "$PARENT_DIR")"
+
 # DEBUG: dump stdin for investigation
-mkdir -p .qoder/debug-dump
-echo "=== $(date) ===" >> .qoder/debug-dump/stdin.log
-echo "file_path: $(echo "$input" | jq -r '.tool_input.file_path // "EMPTY"')" >> .qoder/debug-dump/stdin.log
-echo "has_file_content: $(echo "$input" | jq 'has("tool_input") and (.tool_input | has("file_content"))')" >> .qoder/debug-dump/stdin.log
-echo "has_replacements: $(echo "$input" | jq 'has("tool_input") and (.tool_input | has("replacements"))')" >> .qoder/debug-dump/stdin.log
-echo "top_keys: $(echo "$input" | jq -r 'keys | join(", ")')" >> .qoder/debug-dump/stdin.log
-echo "tool_input_keys: $(echo "$input" | jq -r '.tool_input | keys | join(", ") // "NO_TOOL_INPUT"')" >> .qoder/debug-dump/stdin.log
-echo "=== DONE ===" >> .qoder/debug-dump/stdin.log
+mkdir -p "$MAGIC_DIR/debug-dump"
+echo "=== $(date) ===" >> "$MAGIC_DIR/debug-dump/stdin.log"
+echo "file_path: $(echo "$input" | jq -r '.tool_input.file_path // "EMPTY"')" >> "$MAGIC_DIR/debug-dump/stdin.log"
+echo "has_file_content: $(echo "$input" | jq 'has("tool_input") and (.tool_input | has("file_content"))')" >> "$MAGIC_DIR/debug-dump/stdin.log"
+echo "has_replacements: $(echo "$input" | jq 'has("tool_input") and (.tool_input | has("replacements"))')" >> "$MAGIC_DIR/debug-dump/stdin.log"
+if echo "$input" | jq -e 'has("tool_input") and (.tool_input | has("file_content"))' > /dev/null 2>&1; then
+  echo "[file_content[500]]: $(echo "$input" | jq -r '.tool_input.file_content' | head -c 500)" >> "$MAGIC_DIR/debug-dump/stdin.log"
+fi
+if echo "$input" | jq -e 'has("tool_input") and (.tool_input | has("replacements"))' > /dev/null 2>&1; then
+  echo "[replacement_new_text[500]]: $(echo "$input" | jq -r '.tool_input.replacements[0].new_text' | head -c 500)" >> "$MAGIC_DIR/debug-dump/stdin.log"
+fi
+echo "top_keys: $(echo "$input" | jq -r 'keys | join(", ")')" >> "$MAGIC_DIR/debug-dump/stdin.log"
+echo "tool_input_keys: $(echo "$input" | jq -r '.tool_input | keys | join(", ") // "NO_TOOL_INPUT"')" >> "$MAGIC_DIR/debug-dump/stdin.log"
+echo "=== DONE ===" >> "$MAGIC_DIR/debug-dump/stdin.log"
 file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
 # L17: 非文件工具事件（空 stdin）→ 不拦截（由 matcher 层过滤）
 [ -z "$file_path" ] && exit 0
 
-if ! echo "$file_path" | grep -qE '\.qoder/(plans|specs)/'; then
+if ! echo "$file_path" | grep -qE '$MAGIC_DIR/(plans|specs)/'; then
   exit 0
 fi
 
@@ -35,7 +46,7 @@ if [ -z "$CONTENT" ]; then
 fi
 
 PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
-TEMPLATES_DIR="$PROJECT_DIR/.qoder/templates"
+TEMPLATES_DIR="$PROJECT_DIR/$MAGIC_DIR/templates"
 
 # 通过 filename 匹配模板名
 TEMPLATE_NAME=""
@@ -49,10 +60,12 @@ done
 
 # 退一步：根据文件内容特征猜测模板类型
 if [ -z "$TEMPLATE_NAME" ]; then
-  if echo "$CONTENT" | grep -q "## 四、Handoff"; then
-    TEMPLATE_NAME="simple-standard-plan-template.md"
-  elif echo "$CONTENT" | grep -q "## PLAN 元信息"; then
+  if echo "$CONTENT" | grep -q "## PLAN 元信息"; then
     TEMPLATE_NAME="standard-plan-template.md"
+  elif echo "$CONTENT" | grep -q "## 一、Plan 概述"; then
+    TEMPLATE_NAME="simple-plan-template.md"
+  elif echo "$CONTENT" | grep -q "## 四、Handoff"; then
+    TEMPLATE_NAME="simple-plan-template.md"
   elif echo "$CONTENT" | grep -q "## Review 元信息"; then
     if echo "$CONTENT" | grep -q "运行时验证"; then
       TEMPLATE_NAME="review-runtime-template.md"
@@ -104,7 +117,7 @@ if [ -z "$TEMPLATE_NAME" ]; then
   fi
 fi
 
-SCHEMA_FILE="$TEMPLATES_DIR/$(echo "${TEMPLATE_NAME%.md}" | sed 's/-template$//').schema.json"
+SCHEMA_FILE="$TEMPLATES_DIR/${TEMPLATE_NAME%.md}.schema.json"
 # L84: schema 文件不存在 → 无校验规则，阻断（不允许无规则放行）
 if [ ! -f "$SCHEMA_FILE" ]; then
   echo "⛔ 阻断：模板 ${TEMPLATE_NAME} 缺少对应的 .schema.json 校验规则" >&2
@@ -119,7 +132,7 @@ ISSUES=""
 
 # ── 章节校验 ──
 # 使用项目目录下的临时文件，避免 /tmp 在沙箱中不可写导致静默跳过
-TMPFILE="$PROJECT_DIR/.qoder/.doc-guard-issues.tmp"
+TMPFILE="$PROJECT_DIR/$MAGIC_DIR/.doc-guard-issues.tmp"
 : > "$TMPFILE"
 trap "rm -f $TMPFILE" EXIT
 # SearchReplace 只传 patch → 跳过章节/子章节校验（无法从 patch 推断完整文档结构）
@@ -154,6 +167,62 @@ done >> "$TMPFILE"
 
 ISSUES=$(cat "$TMPFILE" 2>/dev/null)
 
+# ── 算法化规则校验（ADD 范式约束下沉为代码）──
+ALGO_ISSUES=""
+
+# 规则1: 精简版 Plan 反作弊
+if echo "$TEMPLATE_NAME" | grep -q 'simple-plan'; then
+  # 1a. 文件数 ≤ 3
+  file_count=$(echo "$CONTENT" | grep -cP '^\|\s*`[^`]+`' 2>/dev/null || echo "0")
+  if [ "$file_count" -gt 3 ] 2>/dev/null; then
+    ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: 涉及 ${file_count} 个文件（超过 3 个限制），应改用 standard-plan-template.md\n"
+  fi
+  # 1b. HITL 表不能写 "等 N 个文件"
+  if echo "$CONTENT" | grep -qP '等\s*\d*\s*个文件|等\s*若干'; then
+    ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: HITL 表文件清单使用模糊描述（'等 N 个文件'），必须列出实际完整路径\n"
+  fi
+  # 1c. HITL 方案/设计决策不能写 "等若干决策"
+  if echo "$CONTENT" | grep -qP '等\s*若干\s*(决策|方案|设计)'; then
+    ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: HITL 表方案/设计决策使用模糊描述（'等若干决策'），必须逐条列出\n"
+  fi
+  # 1d. 不能包含架构设计章节（精简版无架构设计）
+  if echo "$CONTENT" | grep -q '## 三、架构设计'; then
+    ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: 包含 '## 三、架构设计' 章节，精简版不应有架构设计——应改用 standard-plan-template.md\n"
+  fi
+fi
+
+# 规则2: HITL 表非空校验（所有 Plan + Review 模板）
+if echo "$TEMPLATE_NAME" | grep -qE 'plan|review'; then
+  if echo "$CONTENT" | grep -q '## HITL'; then
+    # HITL 表至少要有 1 行非占位符内容（不包含 { } 占位符）
+    hitl_rows=$(echo "$CONTENT" | sed -n '/## HITL/,/^## /p' | grep -cP '^\|\s*[^|{]*\s*\|' 2>/dev/null || echo "0")
+    # rows 包含表头行和分隔行，实际数据行 = rows - 2
+    hitl_data=$((hitl_rows - 2))
+    if [ "$hitl_data" -lt 1 ] 2>/dev/null; then
+      ALGO_ISSUES="${ALGO_ISSUES}  ⚠️  HITL 表为空——必须填写至少 1 行实际内容后再提交审核\n"
+    fi
+  fi
+fi
+
+# 规则3: 精简版 Plan 禁止同时存在独立 handoff 文件
+if echo "$TEMPLATE_NAME" | grep -q 'simple-plan'; then
+  plan_base=$(basename "$file_path" | sed 's/-plan-v.*//')
+  plan_dir=$(dirname "$file_path")
+  handoff_pattern="${plan_dir}/${plan_base}-handoff"
+  if find "$plan_dir" -name "${plan_base}-handoff*.md" 2>/dev/null | grep -q .; then
+    ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版 Handoff 冲突: 检测到独立 handoff 文件（${plan_base}-handoff*.md）。精简版 Plan 的 Handoff 已融合在 §四，不应生成独立文件。请删除独立 handoff 文件或改用 standard-plan-template.md\n"
+  fi
+fi
+
+if [ -n "$ALGO_ISSUES" ]; then
+  echo "⛔ 算法化规则校验不通过:" >&2
+  echo -e "$ALGO_ISSUES" >&2
+  # 合并到 ISSUES 中一起阻断
+  echo -e "$ALGO_ISSUES" >> "$TMPFILE"
+fi
+
+ISSUES=$(cat "$TMPFILE" 2>/dev/null)
+
 # ── 阻断或放行 ──
 if [ -n "$ISSUES" ]; then
   echo "⛔ $TEMPLATE_NAME 校验不通过:
@@ -163,7 +232,7 @@ $ISSUES" >&2
 fi
 
 # ── 自动更新 index.md ──
-if echo "$file_path" | grep -q '\.qoder/plans/'; then
+if echo "$file_path" | grep -q '$MAGIC_DIR/plans/'; then
   if [ -x "$PROJECT_DIR/scripts/gen-plan-index.sh" ]; then
     "$PROJECT_DIR/scripts/gen-plan-index.sh" 2>/dev/null || true
   fi

package/templates/adapters/qoder/hooks/lib/common.sh

@@ -0,0 +1,261 @@
+#!/bin/bash
+###
+ # @Author       : xiaomingming wujixmm@gmail.com
+ # @Date         : 2026-07-17 13:14:46
+ # @LastEditors  : xiaomingming wujixmm@gmail.com
+ # @LastEditTime : 2026-07-17 13:21:36
+ # @FilePath     : /add-coder/templates/core/hooks/lib/common.sh
+ # @Description  : ADD Hook 共享库 — 四端通用函数
+### 
+# ADD Hook 共享库 — 四端通用函数
+# 被 Claude/Qoder/VS Code/Trae adapter 的 hook 脚本 source 引用
+# 路径: templates/core/hooks/lib/common.sh
+
+# 退出码常量,目前适配的ide都一样
+export EXIT_PASS=0   # 放行
+export EXIT_BLOCK=2  # 阻断
+
+# ── 输入解析 ──
+
+# 从 stdin 解析 JSON 输入（hook 事件通过 stdin 传入 JSON）
+parse_input() {
+  if [ -t 0 ]; then
+    echo "{}"
+  else
+    cat
+  fi
+}
+
+# 从 JSON 中提取字段值（简单实现，不依赖 jq）
+# 用法: json_get "$json" "field_name"
+json_get() {
+  echo "$1" | grep -o "\"$2\"[[:space:]]*:[[:space:]]*\"[^\"]*\"" | head -1 | sed 's/.*: *"\([^"]*\)".*/\1/'
+}
+
+# ── ADD 活跃 Plan 检测（裁决定逻辑，SKILL §0.7.1） ──
+#
+# 活跃判定标准：
+#   1. magicDir 优先级: 由 Hook 脚本自身的路径推断（.claude/hooks/xxx.sh → .claude）→ .add → stderr 提示全局搜索
+#   2. 索引优先: 先读 plans/index.md 匹配 → 无匹配才 glob *-handoff*.md
+#   3. 活跃定义: add-route 中存在 [ ] 未勾选项 = 活跃；全部 [x] = 已收敛
+#   4. 多 Plan 冲突: 取 add-route 最近 mtime
+#   5. 无 add-route: Plan 初始态，视为活跃
+#
+# 前置条件: 调用方需设置 PROJECT_DIR 环境变量（项目根目录）
+# 返回: "plan_keyword::step_n/total::round_n/total::handoff_path::add_route_path" 或 ""
+
+detect_active_add() {
+  local plans_dir=""
+
+  # 1. magicDir 回退: 当前 IDE（CURRENT_MAGIC）→ 目录检测 → .add → 提示全局搜索
+  local magic_dirs=()
+  if [ -n "${CURRENT_MAGIC:-}" ]; then
+    magic_dirs+=("$CURRENT_MAGIC")
+  else
+    # 兜底: 检测 PROJECT_DIR 下哪个 magicDir 存在
+    for m in ".claude" ".qoder" ".vscode" ".trae"; do
+      [ -d "${PROJECT_DIR:-$PWD}/$m" ] && { magic_dirs+=("$m"); break; }
+    done
+  fi
+  magic_dirs+=(".add")
+
+  for magic in "${magic_dirs[@]}"; do
+    if [ -d "${PROJECT_DIR:-$PWD}/$magic/plans" ]; then
+      plans_dir="${PROJECT_DIR:-$PWD}/$magic/plans"
+      break
+    fi
+  done
+
+  if [ -z "$plans_dir" ]; then
+    echo "[ADD detect] 未在当前 IDE magicDir 和 .add 中找到 plans 目录。是否需要全局搜索所有 magicDir？" >&2
+    return 1
+  fi
+
+  local handoff=""
+  local add_route=""
+
+  # 2. 索引优先: 先读 index.md
+  if [ -f "$plans_dir/index.md" ]; then
+    # 从 index.md 表格提取最近一个 handoff 相对路径
+    # 表格格式: | YYYY-MM/DD/path-to-handoff.md | ...
+    handoff=$(grep -oE '[0-9]{4}-[0-9]{2}/[0-9]{2}/[^|]*handoff[^|]*\.md' "$plans_dir/index.md" 2>/dev/null | head -1 | xargs)
+    if [ -n "$handoff" ] && [ -f "$plans_dir/$handoff" ]; then
+      handoff="$plans_dir/$handoff"
+    else
+      handoff=""
+    fi
+  fi
+
+  # 3. 退路: glob handoff 文件（mtime 7 天内）
+  if [ -z "$handoff" ]; then
+    local today_dir="$plans_dir/$(date +%Y-%m)"
+    [ -d "$today_dir" ] && handoff=$(find "$today_dir" -name "*handoff*.md" -mtime -7 -type f 2>/dev/null | head -1)
+    [ -z "$handoff" ] && handoff=$(find "$plans_dir" -name "*handoff*.md" -mtime -7 -type f 2>/dev/null | head -1)
+  fi
+  [ -z "$handoff" ] && return 1
+
+  # 提取 plan keyword
+  local plan_kw=$(basename "$handoff" | sed 's/-handoff.*//')
+
+  # 查找 add-route
+  local handoff_dir=$(dirname "$handoff")
+  add_route=$(find "$handoff_dir" -name "*add-route*.md" -type f 2>/dev/null | head -1)
+  [ -z "$add_route" ] && add_route=$(find "$plans_dir" -name "*add-route*.md" -type f 2>/dev/null | head -1)
+
+  # 4. 活跃判定: 读 add-route，存在 [ ] 未勾选项 = 活跃
+  local step_info="?"
+  if [ -f "$add_route" ]; then
+    local ck=$(grep -c '\[x\]' "$add_route" 2>/dev/null || true)
+    local uc=$(grep -c '\[ \]' "$add_route" 2>/dev/null || true)
+    ck=${ck:-0}; uc=${uc:-0}
+    local total=$((ck + uc))
+    [ "$total" -gt 0 ] && step_info="${ck}/${total}"
+    # 全部 [x] → 已收敛（但 handoff 还存在 → 可能是遗留，仍返回但标记）
+  else
+    # 无 add-route → Plan 初始态，视为活跃
+    step_info="init"
+  fi
+
+  # 5. 轮次统计（从 handoff）
+  local round_info="?"
+  if grep -q '<第[0-9]轮>' "$handoff" 2>/dev/null; then
+    local ck=$(grep -c '\[x\]' "$handoff" 2>/dev/null || true); ck=${ck:-0}
+    local total=$(grep -c '<第[0-9]轮>' "$handoff" 2>/dev/null || true); total=${total:-0}
+    [ "$total" -gt 0 ] && round_info="${ck}/${total}"
+  else
+    round_info="1/1"
+  fi
+
+  echo "${plan_kw}::${step_info}::${round_info}::${handoff}::${add_route:-none}"
+}
+
+# ── Dev Action 追踪 ──
+
+# dev action 标记文件（项目级，PreToolUse 写入，Stop 读取）
+DEV_FLAG="/tmp/add_dev_$(echo "${PROJECT_DIR:-$PWD}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")"
+
+mark_dev_action() {
+  touch "$DEV_FLAG" 2>/dev/null || true
+}
+
+has_dev_action() {
+  [ -f "$DEV_FLAG" ]
+}
+
+clear_dev_action() {
+  rm -f "$DEV_FLAG" 2>/dev/null || true
+}
+
+# ── 验收完整度检查 ──
+
+# 检查 handoff + add-route 的验收完整度
+# 用法: check_add_completeness "$handoff_path" "$add_route_path"
+check_add_completeness() {
+  local handoff="$1" add_route="$2"
+  local issues=""
+
+  # devlog（内容已回流至 handoff，检查 handoff 是否含验收结果）
+  if [ -f "$handoff" ] && ! grep -qE '验收|收敛|闭环|本轮改了什么|devlog' "$handoff" 2>/dev/null; then
+    issues="${issues}  [ ] devlog 缺失（handoff 无验收记录）\n"
+  fi
+
+  # handoff 验证标准
+  if [ -f "$handoff" ]; then
+    local uc=$(grep -c '\[ \]' "$handoff" 2>/dev/null || echo "0")
+    [ "$uc" -gt 0 ] && issues="${issues}  [ ] handoff ${uc} 项未勾选\n"
+  fi
+
+  # add-route Step
+  if [ -f "$add_route" ]; then
+    local uc=$(grep -c '\[ \]' "$add_route" 2>/dev/null || echo "0")
+    [ "$uc" -gt 0 ] && issues="${issues}  [ ] add-route ${uc} Step 未闭环\n"
+  fi
+
+  echo -e "$issues"
+}
+
+# ── 验收幂等保护 ──
+
+# 检查是否已验收（幂等保护）
+# 用法: is_already_accepted "$add_route_path" "$handoff_path"
+# 返回 0 = 已验收，1 = 未验收
+is_already_accepted() {
+  local add_route="$1" handoff="$2"
+  # add-route Step 8 是否已 [x]
+  if [ -f "$add_route" ]; then
+    if grep -A 10 'Step 8' "$add_route" 2>/dev/null | grep -q '\[x\].*验证并更新项目状态'; then
+      # handoff 是否有验收记录
+      if [ -f "$handoff" ] && grep -qE '✅.*验收|收敛|全部闭环|全部.*完成' "$handoff" 2>/dev/null; then
+        return 0
+      fi
+    fi
+  fi
+  return 1
+}
+
+# ── Stop 四象限分流 few-shot 上下文（卡位 #7） ──
+# 用法: build_stop_context "$quadrant" "$info"
+build_stop_context() {
+  local quadrant="$1" info="$2"
+  case "$quadrant" in
+    "no_add_no_dev")
+      echo "[ADD Stop] 无活跃 Plan，无代码改动。正常结束。"
+      ;;
+    "no_add_has_dev")
+      cat <<'EOF'
+[ADD Stop] ⚠️ 检测到代码修改但无活跃 ADD Plan。
+
+Plan 不是"文档开销"——它是代码治理的基础设施。跳过 Plan 的后果:
+  · 没有 add-route → 每次改动无法追溯到具体 Task
+  · 没有 tasks.md → 后续 AI Session 不知道改了哪些文件
+  · 没有 handoff → 交接时上下文全丢，只能靠 git log 猜
+
+你必须立即补救，二选一:
+
+方案 A — 补 ADD 流程（招安）:
+  Step 0: 读 .qoder/templates/plan-template.md → 生成 Plan
+          生成 add-route → check_dps ≥ 85
+  Step 1: 扩展 AgentAuditPhase（如需要）
+  Step 2: 确认 agentAudit() 通道
+  Step 3: 将已写代码关联到 tasks.md
+  完成后可正常停止。
+
+方案 B — 补不上则回滚:
+  如果改动太复杂无法追溯生成 Plan，则:
+  ① git diff 确认改动范围
+  ② git checkout -- <改动的文件> 撤回
+  ③ 告知用户 "以下改动已回滚，请先走 ADD 流程再重新实施: <文件列表>"
+
+无论选 A 还是 B，完成后告诉用户下次执行 session-init 恢复上下文。
+EOF
+      ;;
+    "has_add_no_dev")
+      echo "[ADD Stop] ADD 流程进行中 (${info})，本次无代码改动。下次继续时执行 session-init 恢复上下文。"
+      ;;
+    "has_add_dev_unclosed")
+      cat <<EOF
+[ADD Stop] ⚠️ 代码已完成但验收未闭环:
+${info}
+
+请依次执行（不要等下次会话）:
+  ① Write devlog → handoff 同目录 devlog-{plan}-v{n}.md
+     格式: # Devlog: {plan}\n 日期 / Plan / 轮次 / 本轮改了什么 / 验收结果 / 遗留项 / 架构回看
+  ② Edit handoff → 更新 §验证标准 全部 [x] + 补充审计 ID
+  ③ Read docs/ → 回看架构文档确认一致性
+  ④ Edit add-route → 勾选对应 Step [x]
+
+以上全部完成后 Agent 才能停止。
+EOF
+      ;;
+  esac
+}
+
+# ── PreToolUse 写入前置守卫上下文（卡位 #4） ──
+build_pretool_context() {
+  local plan="$1" round="$2"
+  cat <<EOF
+[ADD PreToolUse] 当前 Plan: ${plan}，轮次: ${round}。
+本次写入应属于 ADD Step 3 代码实现阶段。
+完成后执行 record_dev_operation 记录审计。
+EOF
+}

package/templates/adapters/qoder/hooks/lib/preload-templates.sh

@@ -0,0 +1,187 @@
+#!/bin/bash
+###
+ # @Author       : xiaomingming wujixmm@gmail.com
+ # @Date         : 2026-07-17 13:19:01
+ # @LastEditors  : xiaomingming wujixmm@gmail.com
+ # @LastEditTime : 2026-07-17 13:21:29
+ # @FilePath     : /add-coder/templates/core/hooks/lib/preload-templates.sh
+ # @Description  : ADD 模板预读脚本
+### 
+# preload-templates.sh — ADD 模板预读脚本
+# 路径: templates/core/hooks/lib/preload-templates.sh
+#
+# 用法:
+#   preload-templates.sh --index              # 输出模板清单（文件名 + 用途）
+#   preload-templates.sh --full               # 输出全部模板全文
+#   preload-templates.sh --full --top 5       # 输出前 5 个最常用模板全文
+#   preload-templates.sh --full --mark        # 全文输出 + 落 tpl-injected 标记
+#
+# 被 SessionStart（--index）和 UserPromptSubmit（--full）调用。
+# tpl-injected 标记文件用于去重——同会话二次命中时不重复注入。
+
+set -euo pipefail
+
+# 模板目录（相对于本脚本）
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+TEMPLATES_DIR="${SCRIPT_DIR}/../../../core/templates"
+
+# tpl-injected 标记文件路径（项目级，/tmp 下按项目 hash 区分）
+PROJECT_HASH=$(echo "${PROJECT_DIR:-$PWD}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")
+TPL_FLAG="/tmp/add_tpl_${PROJECT_HASH}"
+
+# 模板清单（文件名:用途描述，按常用度排序）
+# 顺序即 --top N 的优先级
+declare -A TEMPLATES=(
+  ["simple-plan-template.md"]="需求方案（简单版）：六节结构，元信息+背景+方案+架构+实施+验收"
+  ["spec-template.md"]="功能规格：Why/What Changes/Impact/WHEN-THEN Requirements"
+  ["tasks-template.md"]="任务拆分：Phase→Task→SubTask层级"
+  ["checklist-template.md"]="验收清单：[T]编译期+[R]运行时+ADD规则合规"
+  ["review-template.md"]="方案审查（ADD-9）：问题复现+方案对比+决策结论+影响评估"
+  ["standard-plan-template.md"]="需求方案（标准版）：PLAN元信息+背景+方案+架构+实施Task+验收+关联文档"
+  ["add-route-template-heavyweight.md"]="ADD执行路线图（重型）：每Step验证并更新状态+spec_sync交叉校验"
+  ["add-route-template.md"]="ADD执行路线图（轻量）：标准Step产出检查"
+  ["handoff-single-round-template.md"]="单轮交接：9章节（含恢复上下文审计查询）"
+  ["handoff-multi-round-template.md"]="多轮交接：全局拓扑+每轮13子章节+收敛规则+启动模板"
+  ["review-implementation-template.md"]="实现审查（ADD-10）：格式契约+框架版本+数据模型+E2E curl"
+  ["review-runtime-template.md"]="运行时纠偏（ADD-11）：发现列表+根因分析+流程改进项"
+  ["prd-standard-template.md"]="产品需求文档（新建）：背景目标+用户场景+功能需求+验收标准"
+  ["prd-incremental-template.md"]="产品需求文档（增量）：变更摘要+diff式记录"
+  ["fix-verification-template.md"]="修复验证模板"
+  ["report-template.md"]="代码审查报告模板"
+  ["runtime-report-template.md"]="运行时报告模板"
+  ["TERMINOLOGY.md"]="模板术语速查"
+)
+
+# 按优先级排序的模板文件名列表
+PRIORITY_ORDER=(
+  "simple-plan-template.md"
+  "spec-template.md"
+  "tasks-template.md"
+  "checklist-template.md"
+  "review-template.md"
+  "standard-plan-template.md"
+  "add-route-template-heavyweight.md"
+  "add-route-template.md"
+  "handoff-single-round-template.md"
+  "handoff-multi-round-template.md"
+  "review-implementation-template.md"
+  "review-runtime-template.md"
+  "prd-standard-template.md"
+  "prd-incremental-template.md"
+  "fix-verification-template.md"
+  "report-template.md"
+  "runtime-report-template.md"
+  "TERMINOLOGY.md"
+)
+
+# 读取模板文件内容（strip frontmatter）
+read_template_content() {
+  local file="$1"
+  if [ -f "$file" ]; then
+    # 跳过 YAML frontmatter（--- 开头和 --- 结束之间的内容）
+    awk '
+      BEGIN { in_fm=0; started=0 }
+      NR==1 && /^---$/ { in_fm=1; next }
+      in_fm && /^---$/ { in_fm=0; next }
+      !in_fm { print }
+    ' "$file"
+  fi
+}
+
+# ── --index 模式：输出模板清单 ──
+
+output_index() {
+  echo "## ADD 可用模板清单"
+  echo ""
+  echo "| # | 模板文件 | 用途 |"
+  echo "|---|---------|------|"
+  local i=1
+  for tmpl in "${PRIORITY_ORDER[@]}"; do
+    if [ -f "$TEMPLATES_DIR/$tmpl" ]; then
+      echo "| $i | $tmpl | ${TEMPLATES[$tmpl]:-模板文件} |"
+      ((i++))
+    fi
+  done
+}
+
+# ── --full 模式：输出模板全文 ──
+
+output_full() {
+  local top="${1:-0}"  # 0 = 全部
+
+  echo "## ADD 模板全文内容"
+  echo ""
+
+  local count=0
+  for tmpl in "${PRIORITY_ORDER[@]}"; do
+    if [ ! -f "$TEMPLATES_DIR/$tmpl" ]; then
+      continue
+    fi
+
+    count=$((count + 1))
+    if [ "$top" -gt 0 ] && [ "$count" -gt "$top" ]; then
+      break
+    fi
+
+    echo "---"
+    echo "### $tmpl"
+    echo ""
+    read_template_content "$TEMPLATES_DIR/$tmpl"
+    echo ""
+  done
+}
+
+# ── 标记文件管理 ──
+
+mark_injected() {
+  touch "$TPL_FLAG" 2>/dev/null || true
+}
+
+is_injected() {
+  [ -f "$TPL_FLAG" ]
+}
+
+clear_injected() {
+  rm -f "$TPL_FLAG" 2>/dev/null || true
+}
+
+# ── 主入口 ──
+
+main() {
+  local mode="index"
+  local top=0
+  local do_mark=false
+
+  while [ $# -gt 0 ]; do
+    case "$1" in
+      --index) mode="index"; shift ;;
+      --full)  mode="full"; shift ;;
+      --top)
+        top="${2:-0}"
+        shift 2
+        ;;
+      --mark) do_mark=true; shift ;;
+      *) shift ;;
+    esac
+  done
+
+  case "$mode" in
+    index)
+      output_index
+      ;;
+    full)
+      # 去重检查：如果已注入且没有主动要求重新注入，跳过
+      if is_injected && ! $do_mark; then
+        echo "[ADD preload] 模板已在本会话注入，跳过重复注入（tpl-injected 标记存在）" >&2
+        exit 0
+      fi
+
+      output_full "$top"
+
+      # 落标记文件
+      mark_injected
+      ;;
+  esac
+}
+
+main "$@"

package/templates/adapters/qoder/hooks/lib/session-end.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+###
+ # @Author       : xiaomingming wujixmm@gmail.com
+ # @Date         : 2026-07-17 13:20:43
+ # @LastEditors  : xiaomingming wujixmm@gmail.com
+ # @LastEditTime : 2026-07-17 13:34:19
+ # @FilePath     : /add-coder/templates/core/hooks/lib/session-end.sh
+ # @Description  : SessionEnd 治理卡位
+### 
+# session-end.sh — SessionEnd 治理卡位
+# 路径: templates/core/hooks/lib/session-end.sh
+#
+# 治理职能（卡位 #2）:
+#   ① 清理 tpl-injected 标记文件
+#   ② 会话审计结算（汇总 tool 调用统计）
+#   ③ Stop 未触发兜底: 若 Stop 未执行验收检查，补执行 checklist 快照（best-effort）
+#
+# 用法: 被各 IDE adapter 的 SessionEnd hook 脚本 source 并调用 main
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/common.sh" 2>/dev/null || true
+
+# 清理 tpl-injected 标记
+cleanup_tpl_flag() {
+  local project_hash=$(echo "${PROJECT_DIR:-$PWD}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")
+  rm -f "/tmp/add_tpl_${project_hash}" 2>/dev/null || true
+}
+
+# 清理 dev action 标记
+cleanup_dev_flag() {
+  local project_hash=$(echo "${PROJECT_DIR:-$PWD}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")
+  rm -f "/tmp/add_dev_${project_hash}" 2>/dev/null || true
+}
+
+# Stop 未触发兜底: 如果 dev action 标记还在（说明 Stop 没执行验收检查）
+stop_fallback() {
+  if has_dev_action 2>/dev/null; then
+    echo "[ADD SessionEnd] ⚠️ 检测到 dev action 标记未清除——Stop 可能未触发验收检查" >&2
+
+    # 尝试找到 handoff 做 checklist 快照
+    local state=""
+    if type detect_active_add >/dev/null 2>&1; then
+      state=$(detect_active_add 2>/dev/null || true)
+    fi
+
+    if [ -n "$state" ]; then
+      local handoff=$(echo "$state" | awk -F'::' '{print $4}')
+      local add_route=$(echo "$state" | awk -F'::' '{print $5}')
+      if [ -f "$handoff" ]; then
+        echo "[ADD SessionEnd] 补执行 checklist 快照（best-effort，不阻断）" >&2
+        if type check_add_completeness >/dev/null 2>&1; then
+          check_add_completeness "$handoff" "$add_route" >&2 2>/dev/null || true
+        fi
+      fi
+    fi
+  fi
+}
+
+main() {
+  # ① 清理标记文件
+  cleanup_tpl_flag
+  cleanup_dev_flag
+
+  # ② 审计结算（输出到 stderr 供日志记录）
+  echo "[ADD SessionEnd] 会话结束 — $(date -Iseconds)" >&2
+
+  # ③ Stop 未触发兜底
+  stop_fallback
+
+  exit 0
+}
+
+# 被 source 时不自动执行，source 后调用 main
+if [ "${BASH_SOURCE[0]}" = "$0" ]; then
+  main "$@"
+fi