add-coder 0.1.0

package/templates/adapters/qoder/hooks/lib/state-detect.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# state-detect.sh — ADD 活跃流程检测 + dev action 追踪
+# 共享库
+
+PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
+QODER_DIR="$PROJECT_DIR/.qoder"
+PLANS_DIR="$QODER_DIR/plans"
+
+# dev action 标记文件（项目级，PreToolUse 写入，Stop 读取）
+DEV_FLAG="/tmp/qoder_dev_$(echo "$PROJECT_DIR" | md5sum 2>/dev/null | cut -c1-8 || echo "default")"
+
+# 检测活跃 ADD 流程
+# 返回: "plan_keyword::step_x/total::round_n/total_r::handoff_path::add_route_path" 或 ""
+detect_active_add() {
+  local handoff=""
+  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)
+  [ -z "$handoff" ] && return 1
+
+  local plan_kw=$(basename "$handoff" | sed 's/-handoff.*//')
+
+  # add-route
+  local add_route=$(find "$PLANS_DIR" -name "*add-route*.md" -type f 2>/dev/null | head -1)
+
+  # Step 统计（从 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}"
+  fi
+
+  # 轮次统计（从 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
+mark_dev_action() {
+  touch "$DEV_FLAG" 2>/dev/null || true
+}
+
+# 检测 dev action
+has_dev_action() {
+  [ -f "$DEV_FLAG" ]
+}
+
+# 清理 dev action 标记（验收闭环后调用）
+clear_dev_action() {
+  rm -f "$DEV_FLAG" 2>/dev/null || true
+}
+
+# 检查验收完整度，返回 issues 文本
+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"
+}
+
+# 检查是否已验收（幂等保护）
+# 返回 0 = 未验收，1 = 已验收
+is_already_accepted() {
+  local add_route="$1" handoff="$2"
+  # add-route Step 8 是否已 [x]
+  if [ -f "$add_route" ]; then
+    # 检查 Step 8 产出项是否勾选
+    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
+}

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

@@ -0,0 +1,49 @@
+#!/bin/bash
+# vocabulary.sh — 从 vocabulary markdown 表格加载触发词
+# 单一数据源: .qoder/vocabulary/add-governance-vocabulary.md §类别 A-F 表格
+
+VOCABULARY_FILE="$PWD/.qoder/vocabulary/add-governance-vocabulary.md"
+
+# 输出格式: 优先级::触发词正则::响应文本（:: 避免与触发词内的 | 冲突）
+load_triggers() {
+  [ ! -f "$VOCABULARY_FILE" ] && return 1
+  sed -n '/^## 类别 A: 文档类型/,/^## 类别 [G-Z]/p' "$VOCABULARY_FILE" \
+    | grep -E '^\| (P0|P1|P2) ' \
+    | while IFS='|' read -r _ prio raw_trigger action; do
+        prio=$(echo "$prio" | xargs)
+        trigger=$(echo "$raw_trigger" | sed 's/`//g;s/ *\/ */|/g;s/^ *//;s/ *$//')
+        action=$(echo "$action" | xargs)
+        [ -z "$trigger" ] && continue
+        echo "${prio}::${trigger}::${action}"
+      done || true
+}
+
+match_trigger() {
+  local prompt="$1"
+  while IFS= read -r line; do
+    [ -z "$line" ] && continue
+    local prio="${line%%::*}"
+    local rest="${line#*::}"
+    local regex="${rest%%::*}"
+    local action="${rest#*::}"
+    # 跳过开发关键词检测行（由 Layer 2/3 分流处理，特征：超长regex含"修bug"）
+    if echo "$regex" | grep -qE '修\.\?bug|fix\.\?bug' 2>/dev/null; then
+      continue
+    fi
+    if echo "$prompt" | grep -qiE "$regex" 2>/dev/null; then
+      echo "[ADD 触发] ${regex} → ${action}"
+    fi
+  done < <(load_triggers 2>/dev/null)
+}
+
+load_dev_keywords() {
+  load_triggers 2>/dev/null | while IFS= read -r line; do
+    [ -z "$line" ] && continue
+    # 只取包含"开发|改功能"的开发关键词检测行
+    if echo "$line" | grep -q '开发|改功能' 2>/dev/null; then
+      local rest="${line#*::}"
+      local regex="${rest%%::*}"
+      echo "$regex"
+    fi
+  done || true
+}

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

@@ -0,0 +1,22 @@
+#!/bin/bash
+# notification.sh — Notification Review 提醒
+set -euo pipefail
+input=$(cat)
+ntype=$(echo "$input" | jq -r '.notification_type // ""')
+
+if [ "$ntype" != "result" ]; then
+  exit 0
+fi
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$HOOK_DIR/lib/state-detect.sh"
+
+state=$(detect_active_add 2>/dev/null || true)
+[ -z "$state" ] && exit 0
+
+# 检查是否有未读 Review
+reviews_dir="${QODER_DIR:-.qoder}/reviews"
+if ls "$reviews_dir"/*.md >/dev/null 2>&1; then
+  echo "[ADD Notification] 请检查 Review 文档: ${reviews_dir}"
+fi
+exit 0

package/templates/adapters/qoder/hooks/permission-gate.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+# permission-gate.sh — PermissionRequest 人工卡位（不干预）
+set -euo pipefail
+# ADD Review 卡位由 Qoder 本身的权限弹窗处理，此 hook 仅做日志
+input=$(cat)
+tool_name=$(echo "$input" | jq -r '.tool_name // "unknown"')
+echo "[ADD PermissionRequest] 工具 ${tool_name} 请求权限。如有 Review 文档待确认，请先检查。" >&2
+exit 0

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

@@ -0,0 +1,8 @@
+#!/bin/bash
+# post-tool-failure.sh — PostToolUseFailure 错误定位
+set -euo pipefail
+input=$(cat)
+tool_name=$(echo "$input" | jq -r '.tool_name // "unknown"')
+error=$(echo "$input" | jq -r '.error // "unknown"')
+echo "[ADD PostToolUseFailure] 工具 ${tool_name} 失败: ${error}。检查是否需要回退到上一 ADD Step 重新执行。" >&2
+exit 0

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

@@ -0,0 +1,20 @@
+#!/bin/bash
+# post-tool-use.sh — PostToolUse 审计提醒
+set -euo pipefail
+input=$(cat)
+file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+[ -z "$file_path" ] && exit 0
+
+# 只在写入核心文件时提醒
+if ! echo "$file_path" | grep -qE 'src/agents/|src/lib/agent-audit-logger\.ts|src/types/|prisma/schema\.prisma'; then
+  exit 0
+fi
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$HOOK_DIR/lib/state-detect.sh"
+
+state=$(detect_active_add 2>/dev/null || true)
+[ -z "$state" ] && exit 0
+
+echo "[ADD PostToolUse] 文件已写入: ${file_path}。如果尚未记录，请执行 record_dev_operation({ targetId: '${file_path}' }) 落库审计。"
+exit 0

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

@@ -0,0 +1,12 @@
+#!/bin/bash
+# pre-compact.sh — PreCompact ADD 状态快照
+set -euo pipefail
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$HOOK_DIR/lib/state-detect.sh"
+
+state=$(detect_active_add 2>/dev/null || true)
+[ -z "$state" ] && exit 0
+
+IFS='::' read -r plan step rounds handoff add_route <<< "$state"
+echo "[ADD PreCompact] 压缩前状态: Plan=${plan}, 轮次=${rounds}, Step=${step}"
+exit 0

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

@@ -0,0 +1,77 @@
+#!/bin/bash
+# pre-tool-use.sh — PreToolUse §B：源码 Plan 关联检查（阻断模式 v3）
+set -euo pipefail
+
+input=$(cat)
+file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+[ -z "$file_path" ] && exit 0
+
+if ! echo "$file_path" | grep -qE '(src/|/src/).*\.(ts|tsx)$'; then
+  exit 0
+fi
+
+PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
+MOD=$(basename "$file_path" | sed 's/\.[jt]sx\?$//')
+
+MATCHES=$(grep -rl "$MOD" "$PROJECT_DIR/.qoder/plans" "$PROJECT_DIR/.qoder/specs" "$PROJECT_DIR/.qoder/reports" 2>/dev/null | wc -l)
+
+if [ "$MATCHES" -gt 0 ]; then
+  echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"allow","permissionDecisionReason":"相关 ADD Plan 已存在"}}'
+  exit 0
+fi
+
+echo "⛔ 阻断: ${file_path} 无相关 ADD Plan。请先创建 Plan（plan-template / simple-plan-template）。" >&2
+echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"无相关 ADD Plan。请用 AskUserQuestion 询问用户选择 plan-template 或 simple-plan-template 创建 Plan。"}}'
+exit 2
+#!/bin/bash
+# pre-tool-use.sh — PreToolUse §B：源码 Plan 关联检查（阻断模式）
+set -euo pipefail
+
+input=$(cat)
+file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+[ -z "$file_path" ] && exit 0
+
+# 只处理 src/**/*.ts / src/**/*.tsx
+if ! echo "$file_path" | grep -qE '^src/.*\.(ts|tsx)$' && ! echo "$file_path" | grep -qE '^/home/.*/src/.*\.(ts|tsx)$'; then
+  exit 0
+fi
+
+PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
+PLANS_DIR="$PROJECT_DIR/.qoder/plans"
+SPECS_DIR="$PROJECT_DIR/.qoder/specs"
+REPORTS_DIR="$PROJECT_DIR/.qoder/reports"
+
+MOD=$(basename "$file_path" | sed 's/\.[jt]sx\?$//')
+
+MATCHES=$(grep -rl "$MOD" "$PLANS_DIR" "$SPECS_DIR" "$REPORTS_DIR" 2>/dev/null \
+  | sed "s|$PROJECT_DIR/||" \
+  | grep -oE '[^/]*-(plan|handoff|review|report)-v[0-9]+' \
+  | sed 's/\(plan\|handoff\|review\|report\)-v[0-9]\+\.md//' \
+  | sort -u | head -10 2>/dev/null || true)
+
+if [ -n "$MATCHES" ]; then
+  cat >&2 <<EOF
+[ADD PreToolUse] 📋 相关文档:
+$(echo "$MATCHES" | sed 's/^/  - /')
+允许编辑 $file_path。
+EOF
+  exit 0
+fi
+
+cat >&2 <<EOF
+[ADD PreToolUse] ⛔ 阻断：${file_path} 无相关 ADD 文档。
+
+必须先生成 Plan 后才能修改源码。请执行：
+  ① 用 AskUserQuestion 询问用户：要创建 Plan 吗？
+     A) plan-template     — 复杂改动，含架构设计 + 独立 Spec
+     B) simple-plan-template — 单一修复，Tasks 内联于 Plan 体
+  ② 按模板创建 Plan → Plan 中引用此文件路径
+  ③ 重新执行修改操作
+
+JSON 输出格式（阻断时必须）:
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"无相关 ADD Plan，请先生成 Plan 文档"}}
+EOF
+
+# 输出阻断 JSON 到 stdout，Qoder 会读它来展示阻断原因
+echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"无相关 ADD Plan，请先生成 Plan 文档"}}'
+exit 2

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

@@ -0,0 +1,72 @@
+#!/bin/bash
+# prompt-submit.sh — UserPromptSubmit 触发词智能路由（★入口）
+input=$(cat)
+prompt=$(echo "$input" | jq -r '.prompt // empty')
+[ -z "$prompt" ] && exit 0
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$HOOK_DIR/lib/vocabulary.sh"
+source "$HOOK_DIR/lib/state-detect.sh"
+
+# ─── Layer 1: 精准 P0 触发词 ───
+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
+        printf '%s\n' \
+          "[ADD 验收] ⚠️ 已验收。进入 Review 模式:" \
+          "  ① 重新检查 checklist [T]/[R] 项" \
+          "  ② 审查 audit 记录完整性" \
+          "  ③ 如有差异 → Review 回流至 handoff（增量更新，不覆盖已有结论）" \
+          "  ④ 无差异 → 记录 'Review 已确认，无新发现'" \
+          "  ★ 同步检查: 如 checklist 有新 cuid 但 handoff 审计表缺失 → 更新 handoff ADD-7 表 + query_audit_logs 命令"
+        # 执行 checklist 质量检查
+        HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+        "$HOOK_DIR/review-checklist.sh" "$_handoff" "$_add_route" 2>/dev/null
+        exit 0
+      fi
+    fi
+  fi
+  echo "$matched"
+  exit 0
+fi
+
+# ─── 开发关键词检测 ───
+dev_kw=$(load_dev_keywords 2>/dev/null || true)
+if [ -z "$dev_kw" ]; then
+  exit 0
+fi
+
+if ! echo "$prompt" | grep -qiE "$dev_kw"; then
+  exit 0
+fi
+
+# ─── Layer 2/3: 按活跃 ADD 分流 ───
+state=$(detect_active_add 2>/dev/null || true)
+if [ -z "$state" ]; then
+  # Layer 2: 无活跃 ADD → 强制启动
+  cat >&2 <<'EOF'
+[ADD 强制规则] 检测到开发任务。你必须先执行 add-paradigm SKILL 完成 ADD 工作流:
+  Step 0: 文档先行 (Plan → Review → Specs)
+  Step 1: 扩展 AgentAuditPhase
+  Step 2: 确认 agentAudit() 通道
+  Step 3: 代码实现 + 审计植入
+  ...
+  Step 8: 收敛判断
+如果 add-paradigm SKILL 尚未激活，请先调用它。
+EOF
+  exit 2
+fi
+
+# Layer 3: 有活跃 ADD → 注入状态
+plan=$(echo "$state" | awk -F'::' '{print $1}')
+step=$(echo "$state" | awk -F'::' '{print $2}')
+rounds=$(echo "$state" | awk -F'::' '{print $3}')
+handoff=$(echo "$state" | awk -F'::' '{print $4}')
+echo "[ADD 状态] Plan: ${plan}, 轮次: ${rounds}, Step: ${step}, handoff: ${handoff}"
+exit 0

package/templates/adapters/qoder/hooks/review-checklist.sh

@@ -0,0 +1,157 @@
+#!/bin/bash
+# review-checklist.sh — 验收 Review 模式：检查 checklist 质量
+# 被 prompt-submit.sh 的"验收"幂等检查后调用
+# 
+# 输入: handoff_path add_route_path
+# 输出: checklist 质量问题清单
+
+handoff="$1"
+add_route="$2"
+[ -z "$handoff" ] && exit 0
+
+# 从 handoff 关联找到 spec 目录
+plan_dir=$(dirname "$handoff")
+plan_kw=$(basename "$handoff" | sed 's/-handoff.*//')
+
+# 找 checklist
+spec_dir=".qoder/specs/${plan_kw}"
+checklist=""
+[ -d "$spec_dir" ] && checklist="$spec_dir/checklist.md"
+# fallback: 搜索
+[ ! -f "$checklist" ] && checklist=$(find .qoder/specs -name "checklist.md" -path "*${plan_kw}*" 2>/dev/null | head -1)
+
+tasks_file=""
+[ -d "$spec_dir" ] && tasks_file="$spec_dir/tasks.md"
+[ ! -f "$tasks_file" ] && tasks_file=$(find .qoder/specs -name "tasks.md" -path "*${plan_kw}*" 2>/dev/null | head -1)
+
+issues=""
+
+# ══════════════════════════════════════════════════════════════════════
+# 0. Step 0 准入: ADD 核心文档存在性（BLOCKING）
+# ══════════════════════════════════════════════════════════════════════
+_missing_docs=""
+if [ ! -f "$handoff" ]; then
+  _missing_docs="${_missing_docs} Handoff"
+else
+  # 章节完整性: 至少要有 spec 文件/你要改的文件/验证标准/完成后记录 四个关键小节
+  _h_sections=0
+  grep -q "spec 文件" "$handoff" 2>/dev/null && _h_sections=$((_h_sections + 1))
+  grep -q "你要改的文件" "$handoff" 2>/dev/null && _h_sections=$((_h_sections + 1))
+  grep -q "验证标准" "$handoff" 2>/dev/null && _h_sections=$((_h_sections + 1))
+  grep -q "完成后记录 ADD-7 审计" "$handoff" 2>/dev/null && _h_sections=$((_h_sections + 1))
+  if [ "$_h_sections" -lt 4 ]; then
+    _missing_docs="${_missing_docs} Handoff(缺章节:${_h_sections}/4)"
+  fi
+fi
+if [ ! -f "$add_route" ]; then
+  _missing_docs="${_missing_docs} add-route"
+else
+  # add-route 至少要有 Task 映射表 + 文件清单
+  if ! grep -q "Task 映射表" "$add_route" 2>/dev/null && ! grep -q "文件清单" "$add_route" 2>/dev/null; then
+    _missing_docs="${_missing_docs} add-route(缺Task映射/文件清单)"
+  fi
+fi
+if [ ! -f "$checklist" ]; then
+  _missing_docs="${_missing_docs} checklist"
+else
+  # checklist 至少要有 [T] 项
+  if ! grep -q '\[T\]' "$checklist" 2>/dev/null; then
+    _missing_docs="${_missing_docs} checklist(无[T]项)"
+  fi
+fi
+if [ ! -f "$tasks_file" ]; then
+  _missing_docs="${_missing_docs} tasks"
+else
+  # tasks 至少要有 Task 列表 + 验证
+  if ! grep -q 'Task\|\- \[ \]' "$tasks_file" 2>/dev/null; then
+    _missing_docs="${_missing_docs} tasks(无Task项)"
+  fi
+fi
+if [ -n "$_missing_docs" ]; then
+  echo "  ❌ Step 0 未完成:$(echo $_missing_docs | sed 's/ /, /g') 文件缺失。回退 Step 0.5/Step 1 补建后再进入代码实现。"
+  exit 1
+fi
+
+# 1. checklist [x] 数 vs tasks.md [x] 数 是否一致
+if [ -f "$checklist" ] && [ -f "$tasks_file" ]; then
+  cl_ck=$(grep -c '\[x\]' "$checklist" 2>/dev/null || true); cl_ck=${cl_ck:-0}
+  cl_open=$(grep -c '\[ \]' "$checklist" 2>/dev/null || true); cl_open=${cl_open:-0}
+  tk_ck=$(grep -c '\[x\]' "$tasks_file" 2>/dev/null || echo "0")
+
+  if [ "$cl_open" -gt 0 ]; then
+    issues="${issues}  ⚠️ checklist 有 ${cl_open} 项未勾选\n"
+  fi
+
+  # 2. [T] 项是否都有 [x]（编译期验证项）
+  t_items=$(grep -c '\[T\]' "$checklist" 2>/dev/null || true); t_items=${t_items:-0}
+  t_checked=$(grep '\[T\]' "$checklist" 2>/dev/null | grep -c '\[x\]' || true); t_checked=${t_checked:-0}
+  if [ "$t_items" -gt "$t_checked" ]; then
+    issues="${issues}  ⚠️ [T] 编译期验证: ${t_checked}/${t_items} 通过\n"
+  fi
+
+  # 3. 证据缺失检测：[x] 但缺 — 证据: 标记
+  _no_evidence=0
+  while IFS= read -r line; do
+    [ -z "$line" ] && continue
+    # 有证据: — 证据: 字段 + 具体内容（tsc/vitest/grep/审计ID 等）
+    if echo "$line" | grep -qE '—\s*证据:\s*\S' 2>/dev/null; then
+      continue
+    fi
+    # 有验证结果描述也行
+    if echo "$line" | grep -qE 'npx|tsc|vitest|grep|✅|cmq[0-9a-z]{10}|18/18|exit.*0' 2>/dev/null; then
+      continue
+    fi
+    _no_evidence=$((_no_evidence + 1))
+  done < <(grep '\[x\]' "$checklist" 2>/dev/null)
+
+  if [ "$_no_evidence" -gt 0 ]; then
+    issues="${issues}  ❌ ${_no_evidence} 项 [x] 缺少验收证据（需附 — 证据: tsc/vitest/grep/审计ID 等）\n"
+  fi
+
+  # 4. 审计链：[x] 项引用 audit ID 的比例
+  #    初验: 有证据即可，审计ID是证据产出物
+  #    复验: 有审计ID + 证据仍有效 → 不重复落库；证据失效 → 追写新审计
+  _with_audit=$(grep '\[x\]' "$checklist" 2>/dev/null | grep -cE 'cmq[a-z0-9]{10,}' || true); _with_audit=${_with_audit:-0}
+  _fake_audit=$(grep '\[x\]' "$checklist" 2>/dev/null | grep -cE 'cmq\.\.\.|cmqxxx|审计.*cmq\.\.' || true); _fake_audit=${_fake_audit:-0}
+  if [ "$_fake_audit" -gt 0 ]; then
+    issues="${issues}  ❌ ${_fake_audit} 项 [x] 使用了占位符审计ID（cmq.../cmqxxx），必须调 record_dev_operation 获取真实 cuid 后替换\n"
+  fi
+  _with_evidence=$(grep '\[x\]' "$checklist" 2>/dev/null | grep -cE 'tsc|vitest|npx|grep|✅|验证|确认|compgen|审计.*cmq[a-z0-9]{10}' || true); _with_evidence=${_with_evidence:-0}
+  if [ "$_with_evidence" -gt 0 ] && [ "$_with_audit" -eq 0 ]; then
+    issues="${issues}  📎 初验: ${_with_evidence}/${cl_ck} 项有证据但未写审计 ID（需调 record_dev_operation 落库）\n"
+  elif [ "$_with_audit" -gt 0 ] && [ "$_with_audit" -lt "$cl_ck" ]; then
+    issues="${issues}  📎 复验: ${_with_audit}/${cl_ck} 项引用审计 ID。${_with_evidence}/${cl_ck} 项有证据。证据一致则不需追写 devlog日志(走mcp)\n"
+  fi
+fi
+
+# 5. add-route Step 闭环
+if [ -f "$add_route" ]; then
+  ar_ck=$(grep -c '\[x\]' "$add_route" 2>/dev/null || true); ar_ck=${ar_ck:-0}
+  ar_open=$(grep -c '\[ \]' "$add_route" 2>/dev/null || true); ar_open=${ar_open:-0}
+  if [ "$ar_open" -gt 0 ]; then
+    issues="${issues}  ⚠️ add-route ${ar_open} Step 未闭环\n"
+  fi
+fi
+
+# 6. handoff 审计表同步：checklist 中的 cuid 是否在 handoff 中有记录
+if [ -f "$handoff" ] && [ -f "$checklist" ]; then
+  _new_cuids=""
+  while IFS= read -r cuid; do
+    [ -z "$cuid" ] && continue
+    if ! grep -q "$cuid" "$handoff" 2>/dev/null; then
+      [ -n "$_new_cuids" ] && _new_cuids="${_new_cuids}, "
+      _new_cuids="${_new_cuids}${cuid}"
+    fi
+  done < <(grep -oE 'cmq[a-z0-9]{10,}' "$checklist" 2>/dev/null | sort -u)
+  if [ -n "$_new_cuids" ]; then
+    _new_count=$(echo "$_new_cuids" | tr ',' '\n' | wc -l)
+    issues="${issues}  ❌ handoff 审计表未同步: ${_new_count} 个 cuid 在 checklist 中存在但 handoff 中缺失（需更新 handoff ADD-7 表 + query_audit_logs 命令）\n"
+  fi
+fi
+
+if [ -z "$issues" ]; then
+  echo "  ✅ Review: checklist 质量检查通过"
+else
+  echo "  📋 Review 发现问题:"
+  echo -e "$issues"
+fi

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

@@ -0,0 +1,16 @@
+#!/bin/bash
+# SessionStart — ADD 上下文恢复
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$HOOK_DIR/lib/state-detect.sh"
+source "$HOOK_DIR/lib/context-inject.sh"
+
+state=$(detect_active_add 2>/dev/null || true)
+if [ -z "$state" ]; then
+  exit 0
+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

@@ -0,0 +1,71 @@
+#!/bin/bash
+# stop-check.sh — Stop 验收闭环检查（四象限 + few-shot）
+input=$(cat)
+stop_active=$(echo "$input" | jq -r '.stop_hook_active // 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"
+
+state=$(detect_active_add 2>/dev/null || true)
+has_dev=$(has_dev_action 2>/dev/null && echo "true" || echo "false")
+
+# ═══════════════ 四象限分流 ═══════════════
+
+# Q1: 无 ADD + 无 dev → 正常停
+if [ -z "$state" ] && [ "$has_dev" != "true" ]; then
+  exit 0
+fi
+
+# Q2: 无 ADD + 有 dev → 严重违规，强制阻止
+if [ -z "$state" ] && [ "$has_dev" = "true" ]; then
+  build_stop_context "no_add_has_dev" >&2
+  exit 2
+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}')
+
+# Q3: 有 ADD + 无 dev → 注入状态
+if [ "$has_dev" != "true" ]; then
+  echo "[ADD Stop] Plan: ${plan}, 轮次: ${round_info}, Step: ${step_info}"
+  echo "本次无代码改动。下次继续时执行 session-init 恢复上下文。"
+  exit 0
+fi
+
+# Q4: 有 ADD + 有 dev → Step 定位分流
+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
+fi
+
+# 全部闭环
+clear_dev_action 2>/dev/null || true
+echo "[ADD Stop] ✅ 验收闭环: add-route 全部 [x], devlog 已写, handoff 已更新。"
+exit 0

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

@@ -0,0 +1,11 @@
+#!/bin/bash
+# subagent-guard.sh — SubagentStart/Stop 门禁日志
+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}"
+fi
+exit 0

package/templates/adapters/qoder/mcp.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "add-dev-tools": {
+      "command": "{{mcpServerCommand}}",
+      "args": [
+        "{{projectRoot}}/.qoder/scripts/mcp-server.ts"
+      ],
+      "env": {
+        "NODE_ENV": "development"
+      }
+    }
+  }
+}