add-coder 0.1.11 → 0.1.13

package/README.md

@@ -74,25 +74,15 @@ hook 不是「通知推送」，而是 **IDE 运行时拦截层**：
 npx add-coder init
 ```
 
-首次 init 自动检测 IDE，交互式引导完成 Prisma 初始化、User 模型注入、ADD 模板部署。
-
-### 完整初始化流程
+首次 init 自动检测 IDE，交互式引导完成数据库选择（PostgreSQL / SQLite / 自行管理）、容器运行时（podman / docker / 自行管理）、Prisma 初始化、ADD 模板部署。
 
 ```bash
-# ① 首次执行（自动：prisma init + User 模型 + add.prisma + 模板部署）
 npx add-coder init
-# → 是否执行 prisma init？[Y/n] y
-# → 已将 DATABASE_URL 迁移到 .env.development
-# → 已注入 User 模型
-# → 已复制 add.prisma
-# → Core 模板: 55 文件 + adapter 模板已就位
-
-# ② 编辑 .env.development 配置数据库连接串
-DATABASE_URL="postgresql://user:pass@localhost:5432/mydb?schema=public"
-
-# ③ 第二次执行（自动：prisma migrate + generate）
-npx add-coder init --yes
-# → prisma migrate dev（创建 DevOperation + AuditLog 表）
+# → 选择 IDE（Qoder / Claude / VS Code）
+# → 选择数据库（PostgreSQL / SQLite / 自行管理）
+# → 选择容器（podman / docker / 自行管理）
+# → prisma init + add.prisma 复制
+# → prisma db push（仅新增表，不删数据）
 # → prisma generate
 # → ADD 治理模型已就绪 ✓
 ```
@@ -113,7 +103,7 @@ npx add-coder init --yes
 |------|------|------|
 | ① | 检测 IDE | 扫描 `.qoder/` `.claude/` `.vscode/` 存在性，或通过 `--adapter` 指定 |
 | ② | 加载配置 | 交互式问答 > `add-coder.config.ts` > 自动检测 > 默认值 |
-| ③ | Prisma 注入 | 检测 Prisma → 引导安装 → 注入 User 模型 → 复制 `add.prisma` → 迁移 |
+| ③ | 数据库部署 | `db-ensure.sh` 启容器/PG 连接 + `injectPrisma()` 裁决层（Prisma init → AddUser 模型复制 → db push → generate） |
 | ④ | 渲染模板 | 55 个 core 模板文件（skills/agents/templates/plans/specs/scripts…） |
 | ⑤ | 部署适配 | 将 core 内容复制到 `.add/` `.qoder/` `.claude/` 三目录，补 IDE 专属 hooks/mcp |
 | ⑥ | 写入文件 | 交互/yes/force/dry-run 四种模式，`.sh` 脚本自动 `chmod` |
@@ -197,8 +187,8 @@ npx add-coder init --yes
 ## 前置条件
 
 - Node.js >= 20
-- Prisma >= 6.9 / ^7.0（`init` 时自动检测，无则引导安装）
-- PostgreSQL（MCP 工具链依赖 DevOperation + AuditLog 表）
+- Prisma ^7.0（`init` 时自动检测，无则引导安装）
+- PostgreSQL / SQLite（MCP 工具链依赖 DevOperation + AuditLog 表）
 
 > **推荐**：使用 Podman/Docker 运行 PostgreSQL，参考配置：
 > ```yaml

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";
@@ -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.11",
+  "version": "0.1.13",
   "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/plans/2026-07/08/{farm-agent-add-coder-npm-package-add-route-v1.md → add-coder-npm-package-add-route-v1.md}

@@ -1,10 +1,10 @@
-# farm-agent-add-coder-npm-package-add-route-v1
+# add-coder-add-coder-npm-package-add-route-v1
 
 > **定位**：Plan → ADD Step 执行映射。不重复 Plan 的架构设计和 Specs 的任务细节——只定义每个 ADD Step 在本 Plan 中的具体动作、输入、产出。
 >
-> **模式**：重型（Heavyweight）——每一步产出检查强制执行"验证并更新项目状态"。本项目为 npm 包工程化，代码产物在 `packages/add-coder/`，不修改 farm-agent 业务代码。
+> **模式**：重型（Heavyweight）——每一步产出检查强制执行"验证并更新项目状态"。本项目为 npm 包工程化，代码产物在 `packages/add-coder/`，不修改 add-coder 业务代码。
 >
-> **绑定**：Plan: `.qoder/plans/2026-07/08/farm-agent-add-coder-npm-package-plan-v1.md` · Spec: `.qoder/specs/farm-agent-add-coder-npm-package/spec.md` ✅ · Tasks: `.qoder/specs/farm-agent-add-coder-npm-package/tasks.md` ✅ · Handoff: `.qoder/plans/2026-07/08/farm-agent-add-coder-npm-package-handoff-v1.md` ✅
+> **绑定**：Plan: `{{magicDir}}/plans/2026-07/08/add-coder-add-coder-npm-package-plan-v1.md` · Spec: `{{magicDir}}/specs/add-coder-add-coder-npm-package/spec.md` ✅ · Tasks: `{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md` ✅ · Handoff: `{{magicDir}}/plans/2026-07/08/add-coder-add-coder-npm-package-handoff-v1.md` ✅
 
 ---
 
@@ -13,9 +13,9 @@
 **目的**：代码动工前，确认 Plan + Specs + Handoff 三元组齐全，项目文档反映即将实现的变更。
 
 **输入**：
-- 上游 Review：`.qoder/reviews/farm-agent-add-coder-npm-package-review-v1.md` ✅
-- 上游 Review v2：`.qoder/reviews/farm-agent-add-coder-npm-package-review-v2.md` ✅ — 代码实现评审
-- Plan 文档：`.qoder/plans/2026-07/08/farm-agent-add-coder-npm-package-plan-v1.md` ✅
+- 上游 Review：`{{magicDir}}/reviews/add-coder-add-coder-npm-package-review-v1.md` ✅
+- 上游 Review v2：`{{magicDir}}/reviews/add-coder-add-coder-npm-package-review-v2.md` ✅ — 代码实现评审
+- Plan 文档：`{{magicDir}}/plans/2026-07/08/add-coder-add-coder-npm-package-plan-v1.md` ✅
 
 **动作**：
 1. 确认 Specs 三元组就绪：`spec.md` + `tasks.md` + `checklist.md` ✅
@@ -44,7 +44,7 @@
 
 ## Step 1：功能分析与审计打点定义
 
-**目的**：本 Plan 为 npm 包工程化，不修改 farm-agent 业务代码。无需新增 `AgentAuditPhase` 字面量。审计通过 `record_dev_operation`（ADD-7）落库 DevOperation 表。
+**目的**：本 Plan 为 npm 包工程化，不修改 add-coder 业务代码。无需新增 `AgentAuditPhase` 字面量。审计通过 `record_dev_operation`（ADD-7）落库 DevOperation 表。
 
 **输入**：
 - Plan §3 的 Task 列表（6 轮 11 个 Task）
@@ -60,7 +60,7 @@
 | 审计方式 | 适用场景 | 工具 |
 |---------|---------|------|
 | `record_dev_operation` | 文件变更（CREATE/MODIFY/DELETE） | MCP 工具 |
-| 无 AgentAuditPhase | 本 Plan 不修改 farm-agent 业务代码 | — |
+| 无 AgentAuditPhase | 本 Plan 不修改 add-coder 业务代码 | — |
 
 ---
 
@@ -108,7 +108,7 @@
 | 4 | 3 | Claude 适配器实现 | `templates/adapters/claude/`、`src/adapters/claude/renderer.ts` | `record_dev_operation` (CREATE) | — | 第2轮 Task 0 | ⬜ |
 | 5 | 3 | Qoder 适配器实现 | `templates/adapters/qoder/`、`src/adapters/qoder/renderer.ts` | `record_dev_operation` (CREATE/MODIFY) | — | 第3轮 Task 0 | ⬜ |
 | 6 | 3 | VS Code 适配器实现 | `templates/adapters/vscode/`、`src/adapters/vscode/renderer.ts` | `record_dev_operation` (CREATE/MODIFY) | — | 第3轮 Task 1 | ⬜ |
-| 6b | 3 | 三目录部署（core→.add/.qoder/.claude） | `src/core/renderer.ts`、`src/cli/commands/init.ts`、adapter renderers | `record_dev_operation` (MODIFY) | — | 第3轮 Task 2 | ⬜ |
+| 6b | 3 | 三目录部署（core→.add/{{magicDir}}/.claude） | `src/core/renderer.ts`、`src/cli/commands/init.ts`、adapter renderers | `record_dev_operation` (MODIFY) | — | 第3轮 Task 2 | ⬜ |
 | 7 | 4 | 配置系统（Zod schema） | `src/config/schema.ts`、`src/config/defaults.ts` | `record_dev_operation` (CREATE) | — | 无 | ⬜ |
 | 8 | 4 | CLI 重写 | `src/cli/`、`bin/add-coder.js`、`tsup.config.ts` | `record_dev_operation` (CREATE/MODIFY) | — | 第1轮 Task 0 + 第4轮 Task 0 | ⬜ |
 | 9 | 5 | 集成测试 + 文档 + devlog | 测试文件、`README.md`、`package.json` | `record_dev_operation` (CREATE/MODIFY) | — | 全部前序 Task | ⬜ |

package/templates/core/plans/2026-07/08/{farm-agent-add-coder-npm-package-handoff-v1.md → add-coder-npm-package-handoff-v1.md}

@@ -1,6 +1,6 @@
 # add-coder npm 包 — 6 轮原子事务交接手册
 
-> **适用场景**：6 轮原子事务变更，每轮独立收敛。将 ADD 范式从 farm-agent 内部工具改造为可发布的 npm 包。
+> **适用场景**：6 轮原子事务变更，每轮独立收敛。将 ADD 范式从 add-coder 内部工具改造为可发布的 npm 包。
 >
 > **用途**：每个新对话开始时，把对应轮次章节粘贴给 LLM。
 
@@ -8,9 +8,9 @@
 
 ## 全局元信息
 
-- **父 Plan**: `farm-agent-add-coder-npm-package-plan-v1.md`
-- **原子事务拓扑**: `farm-agent-add-coder-npm-package-add-route-v1.md`
-- **目标仓库**: `/home/xmm/ai/farm-agent`
+- **父 Plan**: `add-coder-add-coder-npm-package-plan-v1.md`
+- **原子事务拓扑**: `add-coder-add-coder-npm-package-add-route-v1.md`
+- **目标仓库**: `/home/xmm/ai/add-coder`
 - **总文件数**: 约 90 个独立文件
 - **轮次数**: 6 轮局部闭包
 - **拆分原则**: 以业务原子闭包为主，以对话上下文容量为辅
@@ -47,7 +47,7 @@
 
 ### 交接手册与 spec 的优先级
 
-- 本 handoff 是新对话的入口索引。具体实现细节以 `.qoder/specs/farm-agent-add-coder-npm-package/spec.md`、`tasks.md`、`checklist.md` 为准。
+- 本 handoff 是新对话的入口索引。具体实现细节以 `{{magicDir}}/specs/add-coder-add-coder-npm-package/spec.md`、`tasks.md`、`checklist.md` 为准。
 - 如果 handoff 摘要与 spec/tasks/checklist 存在颗粒度差异，以 spec/tasks/checklist 为准。
 
 ---
@@ -83,9 +83,9 @@ query_audit_logs({ targetId: "packages/add-coder/templates/core/prisma/add.prism
 ```
 1. session-init SKILL
 2. query_audit_logs({ planKeyword: "add-coder-npm-package" }) → 查看本轮 4 条记录
-3. read ".qoder/specs/farm-agent-add-coder-npm-package/spec.md"
-4. read ".qoder/specs/farm-agent-add-coder-npm-package/tasks.md"（第1轮）
-5. read ".qoder/specs/farm-agent-add-coder-npm-package/checklist.md"（一、二、四）
+3. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/spec.md"
+4. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md"（第1轮）
+5. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md"（一、二、四）
 ```
 
 ### 原子事务目标
@@ -96,9 +96,9 @@ query_audit_logs({ targetId: "packages/add-coder/templates/core/prisma/add.prism
 
 ### spec 文件
 
-- `.qoder/specs/farm-agent-add-coder-npm-package/spec.md`
-- `.qoder/specs/farm-agent-add-coder-npm-package/tasks.md`（第1轮）
-- `.qoder/specs/farm-agent-add-coder-npm-package/checklist.md`（一、二、四）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/spec.md`
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md`（第1轮）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md`（一、二、四）
 
 ### 你要改的文件（Task 1.0: 2 新建 + Task 1.1: ~70 修改）
 
@@ -106,11 +106,11 @@ query_audit_logs({ targetId: "packages/add-coder/templates/core/prisma/add.prism
 |------|------|--------|
 | `packages/add-coder/templates/core/prisma/add.prisma` | 新建 | DevOperation + AuditLog 模型定义 |
 | `packages/add-coder/src/cli/prisma-injector.ts` | 新建 | Prisma 注入器（检测→复制→迁移→generate） |
-| `templates/` 下 15 个 `.md` 模板 | 修改 | `farm-agent-*` → `{{projectName}}-*` |
+| `templates/` 下 15 个 `.md` 模板 | 修改 | `add-coder-*` → `{{projectName}}-*` |
 | `skills/` 下 2 个 SKILL.md | 修改 | `/home/xmm/` → `{{projectRoot}}/` |
 | `scripts/mcp-server.ts` + `add-coder-mcp-server.ts` | 修改 | 数据库密码 → `process.env.DATABASE_URL` |
-| `.qoder/settings.json` / `.qoder/mcp.json` | 修改 | 硬编码路径 → 占位符 |
-| `.qoder/hooks/` 下 14 个 `.sh` + `lib/` | 修改 | 项目名提取逻辑 |
+| `{{magicDir}}/settings.json` / `{{magicDir}}/mcp.json` | 修改 | 硬编码路径 → 占位符 |
+| `{{magicDir}}/hooks/` 下 14 个 `.sh` + `lib/` | 修改 | 项目名提取逻辑 |
 | `.vscode/` 下 4 个文件 | 修改 | MCP 路径 → `{{projectRoot}}` |
 | `reports/` 下 7 个文件 | 修改 | 硬编码 → `{{projectName}}` |
 | `packages/add-coder/src/core/renderer.ts` | 新建 | 核心渲染器 |
@@ -182,7 +182,7 @@ query_audit_logs({ targetId: "packages/add-coder/src/adapters/" })
 **恢复顺序建议**：
 ```
 1. query_audit_logs({ planKeyword: "add-coder-npm-package" })
-2. read ".qoder/specs/farm-agent-add-coder-npm-package/tasks.md"（第2轮）
+2. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md"（第2轮）
 ```
 
 ### 原子事务目标
@@ -191,7 +191,7 @@ query_audit_logs({ targetId: "packages/add-coder/src/adapters/" })
 
 ### spec 文件
 
-- `.qoder/specs/farm-agent-add-coder-npm-package/tasks.md`（第2轮）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md`（第2轮）
 
 ### 你要改的文件（22 迁移 + 4 新建）
 
@@ -206,9 +206,9 @@ query_audit_logs({ targetId: "packages/add-coder/src/adapters/" })
 | `templates/scripts/` | `templates/core/scripts/` | 迁移 |
 | `templates/reports/` | `templates/core/reports/` | 迁移 |
 | `templates/tools/` | `templates/core/tools/` | 迁移 |
-| `templates/.qoder/hooks/` | `templates/adapters/qoder/hooks/` | 迁移 |
-| `templates/.qoder/settings.json` | `templates/adapters/qoder/settings.json` | 迁移 |
-| `templates/.qoder/mcp.json` | `templates/adapters/qoder/mcp.json` | 迁移 |
+| `templates/{{magicDir}}/hooks/` | `templates/adapters/qoder/hooks/` | 迁移 |
+| `templates/{{magicDir}}/settings.json` | `templates/adapters/qoder/settings.json` | 迁移 |
+| `templates/{{magicDir}}/mcp.json` | `templates/adapters/qoder/mcp.json` | 迁移 |
 | `templates/.vscode/` (4) | `templates/adapters/vscode/` | 迁移 |
 | — | `templates/adapters/claude/` | 新建空壳 |
 | — | `templates/shared/hooks-lib/common.sh` | 新建 |
@@ -258,8 +258,8 @@ query_audit_logs({ targetId: "packages/add-coder/src/adapters/claude/renderer.ts
 **恢复顺序建议**：
 ```
 1. query_audit_logs({ planKeyword: "add-coder-npm-package" })
-2. read ".qoder/specs/farm-agent-add-coder-npm-package/tasks.md"（第3轮）
-3. read ".qoder/specs/farm-agent-add-coder-npm-package/checklist.md"（三）
+2. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md"（第3轮）
+3. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md"（三）
 ```
 
 ### 原子事务目标
@@ -268,8 +268,8 @@ query_audit_logs({ targetId: "packages/add-coder/src/adapters/claude/renderer.ts
 
 ### spec 文件
 
-- `.qoder/specs/farm-agent-add-coder-npm-package/tasks.md`（第3轮）
-- `.qoder/specs/farm-agent-add-coder-npm-package/checklist.md`（三）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md`（第3轮）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md`（三）
 
 ### 你要改的文件（Task 3.0 Claude: 14 新建 / Task 3.1 Qoder: 3 / Task 3.2 VS Code: 3）
 
@@ -300,7 +300,7 @@ query_audit_logs({ targetId: "packages/add-coder/src/adapters/claude/renderer.ts
 #### 已完成验证
 
 - `npx add-coder init --adapter claude` 生成 `.claude/` 目录 ✅
-- `npx add-coder init --adapter qoder` 生成 `.qoder/` 目录 ✅
+- `npx add-coder init --adapter qoder` 生成 `{{magicDir}}/` 目录 ✅
 - `npx add-coder init --adapter vscode` 生成 `.vscode/` 目录 ✅
 
 ---
@@ -336,8 +336,8 @@ query_audit_logs({ targetId: "packages/add-coder/src/cli/commands/init.ts" })
 **恢复顺序建议**：
 ```
 1. query_audit_logs({ planKeyword: "add-coder-npm-package" })
-2. read ".qoder/specs/farm-agent-add-coder-npm-package/tasks.md"（第4轮）
-3. read ".qoder/specs/farm-agent-add-coder-npm-package/checklist.md"（五）
+2. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md"（第4轮）
+3. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md"（五）
 ```
 
 ### 原子事务目标
@@ -346,8 +346,8 @@ query_audit_logs({ targetId: "packages/add-coder/src/cli/commands/init.ts" })
 
 ### spec 文件
 
-- `.qoder/specs/farm-agent-add-coder-npm-package/tasks.md`（第4轮）
-- `.qoder/specs/farm-agent-add-coder-npm-package/checklist.md`（五）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md`（第4轮）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md`（五）
 
 ### 你要改的文件（Task 4.0: 2 新建 + Task 4.1: 10 文件）
 
@@ -412,8 +412,8 @@ query_audit_logs({ targetId: "packages/add-coder/package.json" })
 **恢复顺序建议**：
 ```
 1. query_audit_logs({ planKeyword: "add-coder-npm-package" })
-2. read ".qoder/specs/farm-agent-add-coder-npm-package/tasks.md"（第5轮）
-3. read ".qoder/specs/farm-agent-add-coder-npm-package/checklist.md"（五、六、八）
+2. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md"（第5轮）
+3. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md"（五、六、八）
 ```
 
 ### 原子事务目标
@@ -422,8 +422,8 @@ query_audit_logs({ targetId: "packages/add-coder/package.json" })
 
 ### spec 文件
 
-- `.qoder/specs/farm-agent-add-coder-npm-package/tasks.md`（第5轮）
-- `.qoder/specs/farm-agent-add-coder-npm-package/checklist.md`（五、六、八）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md`（第5轮）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md`（五、六、八）
 
 ### 你要改的文件（6 文件）
 
@@ -495,8 +495,8 @@ query_audit_logs({ targetId: "packages/add-coder/src/cli/detect.ts" })
 **恢复顺序建议**：
 ```
 1. query_audit_logs({ planKeyword: "add-coder-npm-package" })
-2. read ".qoder/specs/farm-agent-add-coder-npm-package/tasks.md"（第6轮）
-3. read ".qoder/specs/farm-agent-add-coder-npm-package/checklist.md"（七）
+2. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md"（第6轮）
+3. read "{{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md"（七）
 4. 执行 npm run generate 确保 GENERATED 区块最新
 ```
 
@@ -507,9 +507,9 @@ query_audit_logs({ targetId: "packages/add-coder/src/cli/detect.ts" })
 
 ### spec 文件
 
-- `.qoder/specs/farm-agent-add-coder-npm-package/spec.md`（Requirement: CaijueHub 裁决层）
-- `.qoder/specs/farm-agent-add-coder-npm-package/tasks.md`（第6轮）
-- `.qoder/specs/farm-agent-add-coder-npm-package/checklist.md`（七）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/spec.md`（Requirement: CaijueHub 裁决层）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md`（第6轮）
+- `{{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md`（七）
 
 ### 你要改的文件（~16 个）
 
@@ -610,11 +610,11 @@ npm run generate → transcribe.ts → GENERATED 区块         │ injectPrisma
 | caijue.toml | 无 | 索引注册 4 个策略 | 新增 |
 | transcribe.ts | 无 | GENERATED 区块产出引擎 | 新增 |
 | 策略文件 | 无 | GENERATED+USER CODE 双区块模式 | 新增 |
-| 模板部署策略 | 仅 `.add/` | `.qoder/` `.claude/` 同时部署 core 内容 | IDE 只认自身 magic path，需三者各自完整 |
+| 模板部署策略 | 仅 `.add/` | `{{magicDir}}/` `.claude/` 同时部署 core 内容 | IDE 只认自身 magic path，需三者各自完整 |
 | `templates/core/prisma/` | add.prisma 模板 | 删除，由 injectPrisma 直接处理 | Prisma 文件不应在 `.add/` 下 |
 | plans/specs 示例 | 无 | `templates/core/plans/` `specs/` 含 add-coder 示例 | 用户首次 init 即可看到完整 ADD 文档样例 |
 | 三目录部署 | 仅 `.add/` | Plan 已设计，`renderCore()` 改造待执行 | 见 Plan §3.2 改造待执行清单 |
-| Review v2 回流 | 无 | `.qoder/reviews/farm-agent-add-coder-npm-package-review-v2.md` | 代码实现评审：2 条 P0（spawnSync catch 失能、ask 重复定义）在 Plan §4.8 回流，P0-1 已补充至 Task 1.0 验收项 |
+| Review v2 回流 | 无 | `{{magicDir}}/reviews/add-coder-add-coder-npm-package-review-v2.md` | 代码实现评审：2 条 P0（spawnSync catch 失能、ask 重复定义）在 Plan §4.8 回流，P0-1 已补充至 Task 1.0 验收项 |
 
 ## §8 验证结果
 
@@ -650,15 +650,15 @@ npm run generate → transcribe.ts → GENERATED 区块         │ injectPrisma
 
 你在执行 add-coder npm 包工程化的 [第N轮]。
 上游 [第1轮~第N-1轮] 已完成。
-先读 .qoder/plans/2026-07/08/farm-agent-add-coder-npm-package-handoff-v1.md 的 <第N轮> 章节。
+先读 {{magicDir}}/plans/2026-07/08/add-coder-add-coder-npm-package-handoff-v1.md 的 <第N轮> 章节。
 
 ## 启动步骤（按顺序）
 
 1. 执行 session-init SKILL
 2. 执行 add-paradigm SKILL
-3. 读 .qoder/specs/farm-agent-add-coder-npm-package/spec.md
-4. 读 .qoder/specs/farm-agent-add-coder-npm-package/tasks.md（第N轮）
-5. 读 .qoder/specs/farm-agent-add-coder-npm-package/checklist.md
+3. 读 {{magicDir}}/specs/add-coder-add-coder-npm-package/spec.md
+4. 读 {{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md（第N轮）
+5. 读 {{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md
 6. 按 tasks.md 顺序执行代码修改
 7. 每完成一个 Task：读 checklist.md → 逐项验证 → 附证据 → 勾选
 8. 每完成一个文件修改：record_dev_operation 写入 ADD-7 审计