add-coder 0.1.12 → 0.1.14

package/dist/index.js

@@ -532,7 +532,7 @@ async function injectPrisma2(projectRoot, options = {}) {
 }
 
 // src/cli/commands/init.ts
-import { readFileSync as readFileSync7, writeFileSync as writeFileSync3, existsSync as existsSync6, mkdirSync as mkdirSync3 } from "fs";
+import { readFileSync as readFileSync7, writeFileSync as writeFileSync3, existsSync as existsSync6, mkdirSync as mkdirSync3, copyFileSync as copyFileSync2, readdirSync as readdirSync5 } from "fs";
 import { resolve as resolve4 } from "path";
 import { spawnSync as spawnSync2 } from "child_process";
 import { createConnection } from "net";
@@ -759,7 +759,7 @@ PROJECT_NAME=${config.projectName || "add-project"}
   }
   const coreFiles = renderCore(config, !!options.dryRun);
   console.log(`Core \u6A21\u677F: ${coreFiles.size} \u6587\u4EF6`);
-  const CORE_TARGETS = [".add", ".qoder", ".claude", ".vscode"];
+  const CORE_TARGETS = [".add", magicDir];
   const allFiles = /* @__PURE__ */ new Map();
   for (const [relPath, content] of coreFiles) {
     for (const t of CORE_TARGETS) {
@@ -778,7 +778,7 @@ PROJECT_NAME=${config.projectName || "add-project"}
   const result = await writeFiles2(projectRoot, allFiles, { force: options.force, dryRun: options.dryRun });
   if (db.engine === "postgresql" && db.container && db.container !== "manual") {
     if (!options.dryRun) {
-      const dbScript = resolve4(projectRoot, ".qoder", "scripts", "db-ensure.sh");
+      const dbScript = resolve4(projectRoot, magicDir, "scripts", "db-ensure.sh");
       const dbEnv = { ...process.env, DATABASE_USER: db.user, DATABASE_PASSWORD: db.password, DATABASE_PORT: db.port, PROJECT_NAME: config.projectName };
       const mode = db.reuseExisting ? "manual" : db.container;
       console.log(db.reuseExisting ? "\u590D\u7528\u5DF2\u6709 PostgreSQL ..." : `\u90E8\u7F72\u6570\u636E\u5E93 (${db.container}) ...`);
@@ -792,14 +792,14 @@ PROJECT_NAME=${config.projectName || "add-project"}
   }
   if (db.engine === "postgresql" && db.container === "manual") {
     if (!options.dryRun) {
-      const dbScript = resolve4(projectRoot, ".qoder", "scripts", "db-ensure.sh");
+      const dbScript = resolve4(projectRoot, magicDir, "scripts", "db-ensure.sh");
       if (existsSync6(dbScript)) spawnSync2("bash", [dbScript, "postgresql", "manual"], { cwd: projectRoot, stdio: "inherit" });
-      console.log(["", "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501", "ADD \u6A21\u677F\u5DF2\u5C31\u4F4D\u3002\u5728\u5B8C\u6210\u4EE5\u4E0B\u64CD\u4F5C\u524D MCP \u4E0D\u53EF\u7528\uFF1A", "", "1. \u7F16\u8F91 .env.development\uFF0C\u914D\u7F6E DATABASE_URL", "2. \u91CD\u65B0\u8FD0\u884C add-coder init \u5B8C\u6210\u8FC1\u79FB", "", "\u26A0\uFE0F  \u975E PG \u6570\u636E\u5E93\u9700\u7F16\u8F91 .qoder/scripts/mcp-server.ts \u624B\u52A8\u914D Prisma 7 adapter", "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"].join("\n"));
+      console.log(["", "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501", "ADD \u6A21\u677F\u5DF2\u5C31\u4F4D\u3002\u5728\u5B8C\u6210\u4EE5\u4E0B\u64CD\u4F5C\u524D MCP \u4E0D\u53EF\u7528\uFF1A", "", "1. \u7F16\u8F91 .env.development\uFF0C\u914D\u7F6E DATABASE_URL", "2. \u91CD\u65B0\u8FD0\u884C add-coder init \u5B8C\u6210\u8FC1\u79FB", "", `\u26A0\uFE0F  \u975E PG \u6570\u636E\u5E93\u9700\u7F16\u8F91 ${magicDir}/scripts/mcp-server.ts \u624B\u52A8\u914D Prisma 7 adapter`, "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"].join("\n"));
     }
   }
   if (db.engine === "manual") {
     if (!options.dryRun) {
-      console.log(["", "Prisma \u652F\u6301\u7684 datasource: postgresql / mysql / sqlite / sqlserver / cockroachdb", "\u81EA\u884C prisma init + \u7F16\u8F91 .env.development\uFF0C\u91CD\u65B0 run init \u5B8C\u6210\u8FC1\u79FB\u3002", "", "\u26A0\uFE0F Prisma 7 adapter \u9700\u624B\u52A8\u914D \u2192 .qoder/scripts/mcp-server.ts"].join("\n"));
+      console.log(["", "Prisma \u652F\u6301\u7684 datasource: postgresql / mysql / sqlite / sqlserver / cockroachdb", "\u81EA\u884C prisma init + \u7F16\u8F91 .env.development\uFF0C\u91CD\u65B0 run init \u5B8C\u6210\u8FC1\u79FB\u3002", "", `\u26A0\uFE0F Prisma 7 adapter \u9700\u624B\u52A8\u914D \u2192 ${magicDir}/scripts/mcp-server.ts`].join("\n"));
     }
   }
   if (db.engine === "sqlite") {
@@ -813,6 +813,26 @@ PROJECT_NAME=${config.projectName || "add-project"}
       }
     }
   }
+  if (!options.dryRun) {
+    const pn = config.projectName || "add-project";
+    const docsBase = resolve4(projectRoot, "docs", pn, "knowledge");
+    const groundingSrc = resolve4(import.meta.dirname, "../templates/core/templates");
+    for (const d of ["00-\u9700\u6C42", "01-\u67B6\u6784", "02-\u89C4\u8303"]) {
+      const srcDir = resolve4(groundingSrc, d);
+      const destDir = resolve4(docsBase, d);
+      if (!existsSync6(destDir)) mkdirSync3(destDir, { recursive: true });
+      if (!existsSync6(srcDir)) continue;
+      for (const f of readdirSync5(srcDir)) {
+        const src = resolve4(srcDir, f);
+        const dest = resolve4(destDir, f);
+        if (existsSync6(dest)) continue;
+        try {
+          copyFileSync2(src, dest);
+        } catch {
+        }
+      }
+    }
+  }
   console.log(`
 \u5B8C\u6210: \u65B0\u5EFA ${result.created}, \u8DF3\u8FC7 ${result.skipped}, \u8986\u76D6 ${result.overwritten}`);
   if (!options.dryRun) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-coder",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "private": false,
   "description": "[codein2027](https://github.com/xiaomingming92/codein2027) 快速构建 ADD 编程范式的完整脚手架——AI 代码治理的落地方案。以「审计即基础设施」为核心，彻底打破编程过程黑盒与跨轮失忆，让编程范式进化为可审计、可追溯、可收敛的新时代。npx 即用，人人可体验。",
   "type": "module",

package/templates/core/agents/add-flow-guardian.md

@@ -33,7 +33,7 @@ Step N-1 出口     ──→  Guardian 出口检查  ──→  BLOCKED? 回退
 
 **0.1 从 MCP 获取 ADD 状态快照**
 
-读取 `.qoder/plans/` 目录（递归搜索子目录 `**/*.md`，目录已按 `YYYY-MM/DD/` 分层），定位当前活跃的 Plan 和 add-route 文件：
+读取 `{{magicDir}}/plans/` 目录（递归搜索子目录 `**/*.md`，目录已按 `YYYY-MM/DD/` 分层），定位当前活跃的 Plan 和 add-route 文件：
 
 1. 使用 Glob `**/*add-route*.md` 递归搜索所有 add-route 文件
 2. 从 add-route 提取绑定的 Plan / Specs / Tasks / Checklist 路径
@@ -76,7 +76,7 @@ Step N-1 出口     ──→  Guardian 出口检查  ──→  BLOCKED? 回退
 #### Step 3 入口（业务逻辑实现）
 | 检查项 | 方法 | 不通过 |
 |--------|------|--------|
-| add-route 存在性 | 递归搜索 `.qoder/plans/`（含 `YYYY-MM/DD/` 子目录）确认 `*add-route*.md` 文件存在 | 不存在 → **BLOCKED** — 回退 Step 0.5 |
+| add-route 存在性 | 递归搜索 `{{magicDir}}/plans/`（含 `YYYY-MM/DD/` 子目录）确认 `*add-route*.md` 文件存在 | 不存在 → **BLOCKED** — 回退 Step 0.5 |
 | add-route 审计记录 | 检查 add-route 文件内容中 Steps 0/1/2 的产出 checkbox 是否已全部 `[x]` | 有 `[ ]` → **BLOCKED** — 回退完成前置 Step |
 | Tasks 文件就绪 | 确认 `tasks.md` 存在且 Task 清单与 add-route 映射表一致 | 缺失 → **BLOCKED** |
 
@@ -108,7 +108,7 @@ Step N-1 出口     ──→  Guardian 出口检查  ──→  BLOCKED? 回退
 | 检查项 | 方法 | 不通过 |
 |--------|------|--------|
 | Plan 为 runtime-fix 类型 | 检查 Plan 元信息是否标注 runtime-fix | 非 runtime-fix → **SKIP** |
-| gateway.md 发现可定位 | 确认 `.qoder/reports/{{projectName}}-runtime-report/gateway.md` 存在 | 缺失 → **FAIL** |
+| gateway.md 发现可定位 | 确认 `{{magicDir}}/reports/{{projectName}}-runtime-report/gateway.md` 存在 | 缺失 → **FAIL** |
 | report-handoff-template 已读取 | 确认模板存在 | 缺失 → **FAIL** |
 
 ---
@@ -118,10 +118,10 @@ Step N-1 出口     ──→  Guardian 出口检查  ──→  BLOCKED? 回退
 #### Step 0 出口
 | 检查项 | 方法 | 判定 |
 |--------|------|------|
-| Plan 文件存在 | 确认 `.qoder/plans/` 下（含日期子目录）有对应的 `-plan-v*.md` | 缺失 → **BLOCKED** |
+| Plan 文件存在 | 确认 `{{magicDir}}/plans/` 下（含日期子目录）有对应的 `-plan-v*.md` | 缺失 → **BLOCKED** |
 | Specs 三元组就绪 | 确认 `spec.md` + `tasks.md` + `checklist.md` 存在 | 缺失 → **BLOCKED** |
-| Review 文件存在 | 确认 `.qoder/reviews/` 下有对应的 review 文件 | 缺失 → **BLOCKED** |
-| add-route 已生成 | 确认 `.qoder/plans/` 下（含日期子目录）有 `*add-route*.md` | 缺失 → **BLOCKED** |
+| Review 文件存在 | 确认 `{{magicDir}}/reviews/` 下有对应的 review 文件 | 缺失 → **BLOCKED** |
+| add-route 已生成 | 确认 `{{magicDir}}/plans/` 下（含日期子目录）有 `*add-route*.md` | 缺失 → **BLOCKED** |
 | 项目文档已更新 | 检查 add-route Step 0 产出中是否勾选了"项目文档已更新"或"无需更新声明已记录" | 未勾选 → **FAIL** |
 | 0.6.5 回流完成 | 检查 add-route §0.8 是否记录了 DPS ≥ 85（或有 DPS 待通过标记） | 无记录 → **FAIL** |
 | 原子闭包判定已执行 | add-route 含"原子闭包三可性判定"章节且有结论 | 缺失 → **BLOCKED** |

package/templates/core/agents/add-orchestrator.md

@@ -29,7 +29,7 @@ mcpServers:
 
 **0.1 加载 Plan 索引**
 
-读取 `.qoder/plans/index.md`，提取最近的 Plan 列表。如文件不存在 → 跳过，继续。
+读取 `{{magicDir}}/plans/index.md`，提取最近的 Plan 列表。如文件不存在 → 跳过，继续。
 
 **0.2 获取 ADD 状态快照**
 
@@ -141,7 +141,7 @@ mcpServers:
 ✅ Step 8 收敛判断通过！
 
 ⚠️ 验收闭环四步（不可跳过）：
-  ① 写 devlog日志(走mcp) → .qoder/plans/{YYYY-MM}/{DD}/
+  ① 写 devlog日志(走mcp) → {{magicDir}}/plans/{YYYY-MM}/{DD}/
   ② 更新 handoff（记录实际产出与偏离）
   ③ Step 9 Report Closure（如为 runtime-fix plan）→ gateway.md 追 - [x]
   ④ 架构文档回看（ADD-12）

package/templates/core/hooks/doc-format-guard.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# doc-format-guard.sh — 文档格式守卫（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"
+
+input=$(parse_input)
+file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+[ -z "$file_path" ] && exit 0
+
+# 检查 ADD 文档格式
+if echo "$file_path" | grep -qE '\.qoder/(specs|plans|reviews)/.*\.md$'; then
+  echo "[ADD DocFormatGuard] 检测到 ADD 文档变更，请确保格式符合模板规范。"
+fi
+exit 0

package/templates/core/hooks/lib/context-inject.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+# context-inject.sh — 上下文注入模板
+# 共享库
+
+# 结构化 SessionStart JSON 注入
+build_session_start_json() {
+  local plan="$1" step="$2" round="$3" handoff="$4"
+  cat <<EOF
+{
+  "continue": true,
+  "hookSpecificOutput": {
+    "hookEventName": "SessionStart",
+    "additionalContext": "上次 ADD 流程未完成:\n  Plan: ${plan}\n  轮次: ${round}\n  当前 Step: ${step} (add-route)\n  恢复命令: query_audit_logs({ planKeyword: '${plan}' })\n  handoff: ${handoff}"
+  }
+}
+EOF
+}
+
+# Stop 四象限分流 few-shot 上下文
+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 → .qoder/plans/{today}/{keyword}-plan-v1.md
+          生成 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_step02")
+      echo "[ADD Stop] ADD Step 0-2: 文档先行/审计准备阶段。无需验收闭环。下一步: 进入 Step 3 代码实现。"
+      ;;
+    "has_add_dev_step3")
+      echo "[ADD Stop] ADD Step 3: 代码实现进行中 (${info})。完成后进入 Step 3.5 实现审查。"
+      ;;
+    "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
+     ★ 同步: checklist 有新 cuid → handoff ADD-7 表必须对应新增行
+     ★ Step 0 准入: handoff + add-route + Specs 三元组缺一不可，缺则回退 Step 0.5
+  ③ Read docs/ → 回看架构文档确认一致性
+  ④ Edit add-route → 勾选对应 Step [x]
+
+以上全部完成后 Agent 才能停止。
+
+下次恢复: 读 handoff → 查同目录 devlog-*.md → query_audit_logs
+EOF
+      ;;
+        "has_add_dev_closed")
+      echo "[ADD Stop] ✅ 验收闭环: add-route全部[x], devlog已记录, handoff已更新。验收幂等——重复触发不覆盖已有结论。"
+      ;;
+  esac
+}
+
+# 写操作前置守卫上下文
+build_pretool_context() {
+  local plan="$1" round="$2"
+  cat <<EOF
+[ADD PreToolUse] 当前 Plan: ${plan}，轮次: ${round}。
+本次写入应属于 ADD Step 3 代码实现阶段。
+完成后执行 record_dev_operation 记录审计。
+EOF
+}

package/templates/core/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/core/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/core/hooks/notification.sh

@@ -0,0 +1,9 @@
+#!/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/core/hooks/permission-gate.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# PermissionRequest — 权限请求门禁（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"
+
+input=$(parse_input)
+tool_name=$(echo "$input" | jq -r '.tool_name // empty')
+
+# 高风险工具需要二次确认
+case "$tool_name" in
+  Bash|Write|Edit)
+    echo "[ADD PermissionGate] 高风险工具: ${tool_name}，请确认操作。"
+    ;;
+esac
+exit 0

package/templates/core/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/core/hooks/post-tool-use.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# post-tool-use.sh — Claude Code PostToolUse 审计提醒
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+input=$(parse_input)
+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
+
+echo "[ADD PostToolUse] 文件已写入: ${file_path}。如果尚未记录，请执行 record_dev_operation 落库审计。"
+exit 0

package/templates/core/hooks/pre-compact.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# PreCompact — 上下文压缩前检查（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"
+
+# 检查是否有未完成的 ADD 审计记录
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
+[ -d "$PROJECT_DIR/.qoder/plans" ] || exit 0
+
+echo "[ADD PreCompact] 上下文压缩前，请确认 ADD-7 审计记录已落库。"
+exit 0

package/templates/core/hooks/pre-tool-use.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# pre-tool-use.sh — Claude Code PreToolUse：源码 Plan 关联检查
+# 与 Qoder 版本共享核心逻辑，差异仅在工具名和环境变量
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+input=$(parse_input)
+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="${CLAUDE_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
+  exit 0
+fi
+
+echo "⛔ 阻断: ${file_path} 无相关 ADD Plan。请先创建 Plan。" >&2
+exit $EXIT_BLOCK

package/templates/core/hooks/prompt-submit.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# UserPromptSubmit — 用户输入提交前检查（ADD 关键词兜底）
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
+[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
+
+input=$(parse_input)
+prompt=$(echo "$input" | jq -r '.prompt // empty')
+
+# 检测 ADD 关键词触发
+if echo "$prompt" | grep -qiE '开发|改功能|修.?bug|加需求|新增|重构|实施|验收|继续'; then
+  echo "[ADD PromptSubmit] 检测到开发关键词，请确认已加载 ADD 工作流上下文。"
+fi
+exit 0

package/templates/core/hooks/review-checklist.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# review-checklist.sh — Review 检查清单校验（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 ReviewChecklist] 请在提交前确认 checklist.md 全部项已勾选。"
+exit 0

package/templates/core/hooks/session-start.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+# SessionStart — ADD 上下文恢复（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"
+
+# 尝试加载 Qoder 的 state-detect 和 context-inject 库
+QODER_LIB="$HOOK_DIR/../../qoder/hooks/lib"
+[ -f "$QODER_LIB/state-detect.sh" ] && source "$QODER_LIB/state-detect.sh"
+[ -f "$QODER_LIB/context-inject.sh" ] && source "$QODER_LIB/context-inject.sh"
+
+export QODER_PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
+
+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/core/hooks/stop-check.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# Stop — 停止前合规检查（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 Stop] 会话结束前，请确认所有 checklist 项已勾选、ADD-7 审计已落库。"
+exit 0

package/templates/core/hooks/subagent-guard.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# SubagentStart/SubagentStop — 子代理门禁（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"
+
+input=$(parse_input)
+event=$(echo "$input" | jq -r '.hook_event_name // empty')
+
+if [ "$event" = "SubagentStart" ]; then
+  echo "[ADD SubagentGuard] 子代理启动，请确认其遵循 ADD 规范。"
+fi
+exit 0