add-coder 0.1.11 → 0.1.13

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

@@ -1,24 +1,24 @@
-# farm-agent-add-coder-npm-package-plan-v1
+# add-coder-add-coder-npm-package-plan-v1
 
 > **Plan/Spec 边界提醒**：Plan 回答"改什么、为什么改、改哪里"——写到让 Review 能判断方向对不对、有没有遗漏维度的程度（文件路径 + Task 验收标准 + 架构维度全覆盖）。**不要**在 Plan 中写完整 TS 类型定义、WHEN-THEN 场景、精确函数签名——那是 Spec 的职责。
 
 ## PLAN 元信息
 
-- **Plan 名称**: farm-agent-add-coder-npm-package-v1
+- **Plan 名称**: add-coder-add-coder-npm-package-v1
 - **启动时间**: 2026-07-08T00:00:00+08:00
 - **主导 AI**: Qoder (Claude 4)
 - **关联文档**:
-  - ADD Route: `.qoder/plans/2026-07/08/farm-agent-add-coder-npm-package-add-route-v1.md` ✅
-  - Handoff: `.qoder/plans/2026-07/08/farm-agent-add-coder-npm-package-handoff-v1.md` ✅
-  - 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` ✅ — 代码实现评审，2 条 P0（spawnSync catch 失能、ask 重复定义）
+  - ADD Route: `{{magicDir}}/plans/2026-07/08/add-coder-add-coder-npm-package-add-route-v1.md` ✅
+  - Handoff: `{{magicDir}}/plans/2026-07/08/add-coder-add-coder-npm-package-handoff-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` ✅ — 代码实现评审，2 条 P0（spawnSync catch 失能、ask 重复定义）
 - **ADD-7 审计策略**:
 
 | 文件 | targetType | action | beforeState | afterState | 状态 |
 |-----|-----------|--------|------------|-----------|------|
 | packages/add-coder/package.json | PACKAGE | PACKAGE_CONFIG_UPDATED | private:true, 无构建流程 | public, TypeScript 构建, 发布就绪 | 待实施 |
 | packages/add-coder/src/ | SOURCE | SOURCE_CREATED | 无 src 目录 | 完整 CLI + 适配器源码 | 待实施 |
-| packages/add-coder/templates/ | TEMPLATE | TEMPLATE_REFACTORED | 硬编码 farm-agent 专属 | 参数化占位符 + 通用化 | 待实施 |
+| packages/add-coder/templates/ | TEMPLATE | TEMPLATE_REFACTORED | 硬编码 add-coder 专属 | 参数化占位符 + 通用化 | 待实施 |
 
 ---
 
@@ -28,7 +28,7 @@
 
 当前 `packages/add-coder/` 是一个 **不可发布的半成品**：
 
-1. **模板硬编码**：`templates/` 下所有文件直接来自 farm-agent 项目，包含数据库密码、项目名、特定路径等不可移植内容
+1. **模板硬编码**：`templates/` 下所有文件直接来自 add-coder 项目，包含数据库密码、项目名、特定路径等不可移植内容
 2. **CLI 纯搬运**：`bin/add-coder.js`（113 行 CommonJS）只有 `init/sync/status` 三个命令，全是 `fs.copyFileSync`，无参数化渲染、无配置合并
 3. **无适配层抽象**：`.qoder` 和 `.vscode` 是两套独立静态模板，无共享逻辑。加 Claude 适配需要再复制一套
 4. **VS Code 无 hook 层**：`.vscode/` 只有 MCP 配置，缺少 Qoder 的 11 个 hook 等价物
@@ -43,7 +43,7 @@
 2. **极客可调**：通过 `add-coder.config.ts` 覆盖任意模板变量、自定义 hook 行为
 3. **多 IDE 兼容**：Claude Code（第一公民）、Qoder/QoderCN（Claude 衍生）、VS Code（阉割版），三层适配器共享同一套 ADD 核心逻辑
 4. **模板参数化**：所有硬编码（项目名、数据库密码、特定路径）替换为 `{{placeholder}}`，`init` 时交互式填充或从配置文件读取
-5. **配置智能合并**：不覆盖用户已有的 `.qoder/settings.json`、`.vscode/settings.json` 等配置
+5. **配置智能合并**：不覆盖用户已有的 `{{magicDir}}/settings.json`、`.vscode/settings.json` 等配置
 
 ---
 
@@ -146,7 +146,7 @@ src/cli/commands/init.ts        ── 主命令
         │
         ├── ① 检测 IDE 环境
         │     src/cli/detect.ts
-        │     → 扫描 .qoder/ .claude/ .vscode/ 存在性 → 确定 targetAdapter
+        │     → 扫描 {{magicDir}}/ .claude/ .vscode/ 存在性 → 确定 targetAdapter
         │     → 若 --adapter 未指定，且检测不到任何 IDE 特征：
         │       无 package.json → 报错退出（无法确定项目根）
         │       有 package.json → 交互式提示选择 IDE（claude/qoder/vscode/auto）
@@ -256,7 +256,7 @@ packages/add-coder/
 │   │   │   ├── hooks/                  # shell 脚本（共享 core 逻辑，matcher 用标准工具名）
 │   │   │   ├── settings.json
 │   │   │   └── mcp.json
-│   │   ├── qoder/                      # 产出 .qoder/
+│   │   ├── qoder/                      # 产出 {{magicDir}}/
 │   │   │   ├── hooks/                  # shell 脚本（matcher 适配双套工具名）
 │   │   │   ├── settings.json
 │   │   │   ├── mcp.json
@@ -299,7 +299,7 @@ packages/add-coder/
 │   ├── settings.json                   # ← templates/adapters/{target}/settings.json
 │   └── sync-policy.json                # ← templates/adapters/qoder/sync-policy.json
 │
-├── .qoder/                             # ★ Qoder IDE 配置
+├── {{magicDir}}/                             # ★ Qoder IDE 配置
 │   ├── agents/                         # ← 同 .add/agents/
 │   ├── skills/                         # ← 同 .add/skills/
 │   ├── templates/                      # ← 同 .add/templates/
@@ -349,13 +349,13 @@ packages/add-coder/
 └── .env.development                    # prisma init 创建，用户配置 DATABASE_URL
 ```
 
-> **部署策略**：`templates/core/` 内容复制到 `.add/`、`.qoder/`、`.claude/` 三个目录。
-> IDE 只认自身的 magic path（`.qoder/` / `.claude/`），必须各自包含完整内容。
+> **部署策略**：`templates/core/` 内容复制到 `.add/`、`{{magicDir}}/`、`.claude/` 三个目录。
+> IDE 只认自身的 magic path（`{{magicDir}}/` / `.claude/`），必须各自包含完整内容。
 > `.add/` 保留作为 add-coder 推荐蓝图，供未来工具链引用。
 
 > **⚠️ 改造待执行**：当前 `renderCore()` 仅输出到 `.add/`，需改造为三目录并行输出：
 > 1. `src/core/renderer.ts`：`renderCore()` 返回值改为 `Map<string, string>[]`（三份）
-> 2. `src/cli/commands/init.ts`：core 文件写入 `.add/` `.qoder/` `.claude/` 三个目标
+> 2. `src/cli/commands/init.ts`：core 文件写入 `.add/` `{{magicDir}}/` `.claude/` 三个目标
 > 3. adapter renderers：不再单独部署 core 内容，只处理 adapter 专属文件（hooks/mcp/settings）
 > 4. 写入去重：三目录同名文件只写一次，后两次 skip（内容相同）
 
@@ -375,7 +375,7 @@ const adapterDir = path.join(TEMPLATES_ROOT, 'adapters', target)
 
 | 维度 | Claude Code | Qoder | VS Code |
 |------|--------|-------|---------|
-| Magic Path | `.claude/` | `.qoder/` | `.vscode/` |
+| Magic Path | `.claude/` | `{{magicDir}}/` | `.vscode/` |
 | Hook 配置格式 | `settings.json` (Claude schema) | `settings.json` (Qoder schema) | 无原生 hook |
 | Hook 事件数量 | 27 个（含 PreToolUse/PostToolUse/Stop/SessionStart/UserPromptSubmit/PermissionRequest 等） | ~11 个 | 0（可用 tasks.json 模拟文件保存触发） |
 | 工具名 matcher | `Write`, `Edit`, `Bash`（标准名） | `Write\|write_to_file`, `Edit\|edit_file`, `Bash`（双套兼容） | N/A |
@@ -383,8 +383,8 @@ const adapterDir = path.join(TEMPLATES_ROOT, 'adapters', target)
 | 退出码机制 | exit 0 = 放行，exit 2 = 阻断 | exit 0 = 放行，exit 2 = 阻断 | N/A |
 | Hook 脚本 | 完整（与 Qoder 共享核心逻辑，差异仅在 matcher 工具名映射） | 完整（matcher 适配） | 无 |
 | MCP 配置 | `mcp.json` (Claude 格式) | `mcp.json` (Qoder 格式) | `settings.json` 内嵌 |
-| Skills 加载 | `.claude/skills/` | `.qoder/skills/` | 不支持 |
-| Subagents 加载 | `.claude/agents/` | `.qoder/agents/` | 不支持 |
+| Skills 加载 | `.claude/skills/` | `{{magicDir}}/skills/` | 不支持 |
+| Subagents 加载 | `.claude/agents/` | `{{magicDir}}/agents/` | 不支持 |
 | 能力声明 | 完整 ADD 运行时 | 完整 ADD 运行时 | 仅模板 + MCP，无 hook 执法 |
 
 **关键发现**：Claude Code 和 Qoder 的 hook 退出码机制完全一致（exit 0/2），shell 脚本可 90% 复用。SessionStart、UserPromptSubmit、PermissionRequest 三个事件两者均原生支持，不应在迁移时移除。
@@ -431,11 +431,11 @@ const adapterDir = path.join(TEMPLATES_ROOT, 'adapters', target)
 ### 3.5 裁决层：CaijueHub（三段式裁决生成管线）
 
 > **定位**：add-coder 聚焦管线阶段 ③④——通用转录引擎 + 编译集成。
-> 阶段 ①②（产品文档 → 规则提取 → caijue.toml）由 farm-agent 的独立 Plan 承接，add-coder 不耦合业务域。
+> 阶段 ①②（产品文档 → 规则提取 → caijue.toml）由 add-coder 的独立 Plan 承接，add-coder 不耦合业务域。
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
-│ 阶段 ①②: farm-agent Plan 承接                              │
+│ 阶段 ①②: add-coder Plan 承接                              │
 │                                                             │
 │ 产品文档 → 提取函数 → caijue.toml                           │
 │ （业务规则）  （AI/规则引擎）  （规则索引）                    │
@@ -552,7 +552,7 @@ init 启动
 | IDE 检测 | `{ env: {}, dirs: [] }` | `{ detected: "qoder", via: "QODER_CN_IDE" }` |
 | 配置加载 | `{ sources: ["auto-detect", "defaults"] }` | `{ projectName: "test", ... }` |
 | Prisma 注入 | `{ prisma: "missing" }` | `{ decision: "block", reason: "无 Prisma 目录" }` |
-| Writer 写入 | `{ path: ".qoder/settings.json", existing: true }` | `{ decision: "skip", reason: "--yes" }` |
+| Writer 写入 | `{ path: "{{magicDir}}/settings.json", existing: true }` | `{ decision: "skip", reason: "--yes" }` |
 
 #### 3.5.5 目录结构增量
 
@@ -619,7 +619,7 @@ packages/add-coder/
 
 **范围**：`templates/core/prisma/add.prisma` + `src/cli/prisma-injector.ts`
 
-- 从 farm-agent 的 `prisma/main.prisma` 中提取 DevOperation 和 AuditLog 模型定义
+- 从 add-coder 的 `prisma/main.prisma` 中提取 DevOperation 和 AuditLog 模型定义
 - 写入 `templates/core/prisma/add.prisma`（模型定义，无参数化）
 - 实现 `src/cli/prisma-injector.ts`：
   - 检测用户项目是否已有 Prisma（`prisma/` 目录 + `schema.prisma`）→ 无则报错
@@ -644,29 +644,29 @@ packages/add-coder/
 
 | # | 文件组 | 文件 | 典型硬编码 | 改为 | 变量类型 |
 |---|--------|------|----------|------|---------|
-| 1 | 模板 | 15 个 `.md` 模板（plan/spec/tasks/checklist/handoff/review/add-route 等） | `docs/大田精准耕播智能决策系统/`、`farm-agent-*` 文件名示例 | `{{docsDir}}/`、`{{projectName}}-*` | Init-time |
+| 1 | 模板 | 15 个 `.md` 模板（plan/spec/tasks/checklist/handoff/review/add-route 等） | `docs/大田精准耕播智能决策系统/`、`add-coder-*` 文件名示例 | `{{docsDir}}/`、`{{projectName}}-*` | Init-time |
 | 2 | 模板 Schema | 15 个 `.schema.json` | 无硬编码（结构定义） | 无需修改 | — |
-| 3 | Skills | `skills/add-paradigm/SKILL.md` | `docs/大田精准耕播智能决策系统/`、`/home/xmm/ai/farm-agent/`、`farm-agent-response-strategy/` 示例 | `{{docsDir}}/`、`{{projectRoot}}/`、`{{projectName}}-*` | Init-time |
-| 4 | Skills | `skills/session-init/SKILL.md` | `farm-agent-review-runtime.md` 示例 | `{{projectName}}-review-runtime.md` | Init-time |
+| 3 | Skills | `skills/add-paradigm/SKILL.md` | `docs/大田精准耕播智能决策系统/`、`/home/xmm/ai/add-coder/`、`add-coder-response-strategy/` 示例 | `{{docsDir}}/`、`{{projectRoot}}/`、`{{projectName}}-*` | Init-time |
+| 4 | Skills | `skills/session-init/SKILL.md` | `add-coder-review-runtime.md` 示例 | `{{projectName}}-review-runtime.md` | Init-time |
 | 5 | Agents | `agents/add-flow-guardian.md` | 无项目特定硬编码 | 检查确认 | — |
 | 6 | Agents | `agents/add-orchestrator.md` | 无项目特定硬编码 | 检查确认 | — |
-| 7 | Rules | `rules/project_rules.md` | `farm-agent` 项目名、`src/agents/` 路径 | `{{projectName}}`、`{{sourceDir}}/agents/` | Init-time |
+| 7 | Rules | `rules/project_rules.md` | `add-coder` 项目名、`src/agents/` 路径 | `{{projectName}}`、`{{sourceDir}}/agents/` | Init-time |
 | 8 | Rules | `rules/theory-practice-map.toml` | 无项目特定硬编码 | 检查确认 | — |
 | 9 | 词汇 | `vocabulary/add-governance-vocabulary.md` | 无项目特定硬编码 | 检查确认 | — |
 | 10 | 脚本 | `scripts/mcp-server.ts` | `DATABASE_URL \|\| "postgresql://farm_admin:farm_secure_pass_2024@..."`、`".env.development"` | `process.env.DATABASE_URL`（无兜底值）、`"{{envFilePath}}"` | Runtime + Init-time |
 | 11 | 脚本 | `scripts/add-coder-mcp-server.ts` | 同上 | 同上 | Runtime + Init-time |
-| 12 | Hook 配置 | `.qoder/settings.json` | hook 脚本绝对路径 `/home/xmm/ai/farm-agent/.qoder/hooks/` | `{{projectRoot}}/.qoder/hooks/` | Init-time |
-| 13 | MCP 配置 | `.qoder/mcp.json` | `DATABASE_URL` 硬编码密码 | `process.env.DATABASE_URL`（无兜底值） | Runtime |
-| 14 | 同步策略 | `.qoder/sync-policy.json` | 无项目特定硬编码 | 检查确认 | — |
-| 15 | Hook 脚本 | `.qoder/hooks/` 下 14 个 `.sh` 文件 | `state-detect.sh` 中项目名提取逻辑、hook 脚本内部绝对路径 | 使用 `$CLAUDE_PROJECT_DIR` 或 `{{projectRoot}}` 替代 | Init-time |
+| 12 | Hook 配置 | `{{magicDir}}/settings.json` | hook 脚本绝对路径 `/home/xmm/ai/add-coder/{{magicDir}}/hooks/` | `{{projectRoot}}/{{magicDir}}/hooks/` | Init-time |
+| 13 | MCP 配置 | `{{magicDir}}/mcp.json` | `DATABASE_URL` 硬编码密码 | `process.env.DATABASE_URL`（无兜底值） | Runtime |
+| 14 | 同步策略 | `{{magicDir}}/sync-policy.json` | 无项目特定硬编码 | 检查确认 | — |
+| 15 | Hook 脚本 | `{{magicDir}}/hooks/` 下 14 个 `.sh` 文件 | `state-detect.sh` 中项目名提取逻辑、hook 脚本内部绝对路径 | 使用 `$CLAUDE_PROJECT_DIR` 或 `{{projectRoot}}` 替代 | Init-time |
 | 16 | VS Code | `.vscode/settings.json` | MCP 配置中的项目特定路径 | `{{projectRoot}}` | Init-time |
 | 17 | VS Code | `.vscode/tasks.json` | 无项目特定硬编码 | 检查确认 | — |
 | 18 | VS Code | `.vscode/launch.json` | 无项目特定硬编码 | 检查确认 | — |
 | 19 | VS Code | `.vscode/extensions.json` | 无项目特定硬编码 | 检查确认 | — |
-| 20 | Reports | `reports/` 下 7 个文件 | `farm-agent`、`/Users/milkytea/WebstormProjects/rfMain/智能体/farm-agent/` 等绝对路径 | 全部 `{{projectName}}`、`{{projectRoot}}` | Init-time |
+| 20 | Reports | `reports/` 下 7 个文件 | `add-coder`、`/Users/milkytea/WebstormProjects/rfMain/智能体/add-coder/` 等绝对路径 | 全部 `{{projectName}}`、`{{projectRoot}}` | Init-time |
 | 21 | 工具 | `tools/README.md` | 无项目特定硬编码 | 检查确认 | — |
 | 22 | Prisma | `prisma/add.prisma` | 无硬编码（模型定义，直接复制到用户项目） | 无需修改 | — |
-| 23 | Grounding 文档 | `docs/01-架构/《ADD开发工作路径与文档协同规范》.md` | `docs/大田精准耕播智能决策系统/`、`farm-agent-*` 文件名示例（15 处） | `{{docsDir}}/`、`{{projectName}}-*` | Init-time |
+| 23 | Grounding 文档 | `docs/01-架构/《ADD开发工作路径与文档协同规范》.md` | `docs/大田精准耕播智能决策系统/`、`add-coder-*` 文件名示例（15 处） | `{{docsDir}}/`、`{{projectName}}-*` | Init-time |
 
 - 创建 `src/core/renderer.ts`：接收 config 对象，执行 `"{{projectName}}".replace("{{projectName}}", config.name)`
 
@@ -694,10 +694,10 @@ packages/add-coder/
 | `reports/` | `templates/core/reports/` | IDE 无关 |
 | `tools/` | `templates/core/tools/` | IDE 无关 |
 | `docs/`（grounding 文档：00-需求/01-架构/02-规范） | `templates/core/docs/` | 保留子目录结构 |
-| `.qoder/hooks/`（14 个 .sh + lib/） | `templates/adapters/qoder/hooks/` | Qoder 适配器 |
-| `.qoder/settings.json` | `templates/adapters/qoder/settings.json` | Qoder 适配器 |
-| `.qoder/mcp.json` | `templates/adapters/qoder/mcp.json` | Qoder 适配器 |
-| `.qoder/sync-policy.json` | `templates/adapters/qoder/sync-policy.json` | Qoder 适配器 |
+| `{{magicDir}}/hooks/`（14 个 .sh + lib/） | `templates/adapters/qoder/hooks/` | Qoder 适配器 |
+| `{{magicDir}}/settings.json` | `templates/adapters/qoder/settings.json` | Qoder 适配器 |
+| `{{magicDir}}/mcp.json` | `templates/adapters/qoder/mcp.json` | Qoder 适配器 |
+| `{{magicDir}}/sync-policy.json` | `templates/adapters/qoder/sync-policy.json` | Qoder 适配器 |
 | `.vscode/`（4 个文件） | `templates/adapters/vscode/` | VS Code 适配器 |
 | `debug-dump/`, `repowiki/` | `templates/shared/` | 空目录占位，init 时在用户项目中创建 |
 | 无（新建） | `templates/adapters/claude/` | Claude 适配器，从 qoder 派生 |
@@ -729,12 +729,12 @@ packages/add-coder/
 
 **范围**：`templates/adapters/qoder/` + `src/adapters/qoder/renderer.ts`
 
-- 从现有 `templates/.qoder/` 迁移到 `templates/adapters/qoder/`，清理 hardcode
+- 从现有 `templates/{{magicDir}}/` 迁移到 `templates/adapters/qoder/`，清理 hardcode
 - `settings.json` 的 matcher 适配：`Write|write_to_file|create_file|CreateFile` 等双套工具名
 - 保留 Qoder 专有事件：`SessionStart`, `UserPromptSubmit`, `PermissionRequest`
 - 实现 `src/adapters/qoder/renderer.ts`
 
-**验收**：`npx add-coder init --adapter qoder` 生成正确的 `.qoder/` 目录
+**验收**：`npx add-coder init --adapter qoder` 生成正确的 `{{magicDir}}/` 目录
 
 #### Task 2: VS Code 适配器实现
 
@@ -867,11 +867,11 @@ packages/add-coder/
 
 - [ ] `npx add-coder init` 在空白项目中零配置生成完整 ADD 模板
 - [ ] `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/` 目录
-- [ ] 模板中无 farm-agent 硬编码（`grep -r "farm.agent\|大田" dist/` 返回空）
+- [ ] 模板中无 add-coder 硬编码（`grep -r "farm.agent\|大田" dist/` 返回空）
 - [ ] `add-coder.config.ts` 可覆盖项目名、源码目录、日志目录等
-- [ ] 已有 `.qoder/settings.json` 时 `init` 不覆盖，展示 diff 并交互确认
+- [ ] 已有 `{{magicDir}}/settings.json` 时 `init` 不覆盖，展示 diff 并交互确认
 - [ ] `npx tsc --noEmit` 通过
 - [ ] `npm pack` 产出的 tarball 包含 `dist/` + `templates/` + `bin/`，不包含 `src/`
 - [ ] `package.json` 中 `"private": false`
@@ -887,9 +887,9 @@ packages/add-coder/
 
 | 文档 | 路径 | 状态 |
 |------|------|:--:|
-| ADD Route | `.qoder/plans/2026-07/08/farm-agent-add-coder-npm-package-add-route-v1.md` | ✅ |
-| Handoff | `.qoder/plans/2026-07/08/farm-agent-add-coder-npm-package-handoff-v1.md` | ✅ |
-| Review | `.qoder/reviews/farm-agent-add-coder-npm-package-review-v1.md` | ✅ |
-| Spec | `.qoder/specs/farm-agent-add-coder-npm-package/spec.md` | ✅ |
-| Tasks | `.qoder/specs/farm-agent-add-coder-npm-package/tasks.md` | ✅ |
-| Checklist | `.qoder/specs/farm-agent-add-coder-npm-package/checklist.md` | ✅ |
+| ADD Route | `{{magicDir}}/plans/2026-07/08/add-coder-add-coder-npm-package-add-route-v1.md` | ✅ |
+| Handoff | `{{magicDir}}/plans/2026-07/08/add-coder-add-coder-npm-package-handoff-v1.md` | ✅ |
+| Review | `{{magicDir}}/reviews/add-coder-add-coder-npm-package-review-v1.md` | ✅ |
+| Spec | `{{magicDir}}/specs/add-coder-add-coder-npm-package/spec.md` | ✅ |
+| Tasks | `{{magicDir}}/specs/add-coder-add-coder-npm-package/tasks.md` | ✅ |
+| Checklist | `{{magicDir}}/specs/add-coder-add-coder-npm-package/checklist.md` | ✅ |

package/templates/core/reports/REPORT-WORKFLOW.md

@@ -7,7 +7,7 @@
 ## 目录结构
 
 ```
-.qoder/reports/
+{{magicDir}}/reports/
 ├── REPORT-WORKFLOW.md                ← 本文件
 ├── boundary-runtime-report.md        ← Runtime Report ↔ 静态 Report 边界划分
 ├── index.md                          ← Issue 注册表（由 gen-report-index.sh 每天自动生成，勿手动编辑）
@@ -130,7 +130,7 @@ runtime-issue-{date}-{seq}.md
    ▼
 创建 runtime-fix-plan-v1.md
    │  命名: {子系统}-runtime-fix-{关键词}-plan-v1.md
-   │  位置: .qoder/plans/{YYYY-MM}/{DD}/
+   │  位置: {{magicDir}}/plans/{YYYY-MM}/{DD}/
    │  模板: plan-template.md
    │
    ▼

package/templates/core/reports/index.md

@@ -2,7 +2,7 @@
 
 > 自动生成: 2026-07-01 11:41:22 | 共 6 份 Report | 下次更新: 每天 2:10 AM
 >
-> 扫描范围: `.qoder/reports/`（Plan Review 在 `.qoder/reviews/`，由 Plan 管线管理）
+> 扫描范围: `{{magicDir}}/reports/`（Plan Review 在 `{{magicDir}}/reviews/`，由 Plan 管线管理）
 
 ---
 

package/templates/core/rules/project_rules.md

@@ -38,13 +38,13 @@ AI 助手必须先恢复到基线、找到对应的 SKILL 文件并按步骤执
 
 ### ADD 词汇→操作映射（L1 预埋）
 
-> **完整词汇表已独立维护**：`.qoder/vocabulary/add-governance-vocabulary.md`
+> **完整词汇表已独立维护**：`{{magicDir}}/vocabulary/add-governance-vocabulary.md`
 > **六类分类**: A.文档类型 / B.ADD阶段 / C.门禁/闸门 / D.MCP工具 / E.Skills/Subagents / F.核心概念
 > **消费者**: IDE 侧 LLM + 未来治理 AI。领域触发词汇（面向 {{projectName}} 运行时用户 LLM）另有独立路径。
 
 ### 理论→实践映射
 
-> 完整结构化映射：`.qoder/rules/theory-practice-map.toml`（可被脚本解析验证）
+> 完整结构化映射：`{{magicDir}}/rules/theory-practice-map.toml`（可被脚本解析验证）
 
 | 规则 | 实践位置 | 触发时机 |
 |------|---------|---------|
@@ -73,7 +73,7 @@ AI 助手必须先恢复到基线、找到对应的 SKILL 文件并按步骤执
 
 **触发条件**：每次新对话启动时，作为第一个操作执行。
 
-SKILL 文件位于 `.qoder/skills/session-init/SKILL.md`，包含 4 个步骤：
+SKILL 文件位于 `{{magicDir}}/skills/session-init/SKILL.md`，包含 4 个步骤：
 1. 查询 `query_audit_logs({})` 获取最近的开发操作记录
 2. 分析审计日志推断上下文
 3. 构建上下文摘要
@@ -87,7 +87,7 @@ SKILL 文件位于 `.qoder/skills/session-init/SKILL.md`，包含 4 个步骤：
 
 **触发条件**：用户提出任何功能开发、Bug 修复、系统修改需求时。
 
-SKILL 文件位于 `.qoder/skills/add-paradigm/SKILL.md`，包含 10 个阶段（Step 0 - Step 9），每个阶段包含若干子步骤：
+SKILL 文件位于 `{{magicDir}}/skills/add-paradigm/SKILL.md`，包含 10 个阶段（Step 0 - Step 9），每个阶段包含若干子步骤：
 0. 文档先行（Documentation First — 在编写任何代码之前更新项目文档 + 验收后回看架构文档）
 1. 功能分析与审计阶段定义
 2. 审计基础设施实现
@@ -148,7 +148,7 @@ ADD 是**开发阶段**的编程范式，不是运行时范式。
 | 架构文档 | `docs/*/knowledge/01-架构/` 或 `02-架构/` | 架构说明书、系统设计、模块定义 |
 | 规范文档 | `docs/*/knowledge/02-规范/` 或 `03-规范/` | 开发规范、AI 核心规范、状态机规范 |
 
-**此外，ADD 工作流的核心产物由 `.qoder/templates/` 下的 11 个模板定义**，这些模板不是参考资料，而是每次变更必须产出的文档骨架。分析变更影响范围时，必须同步确认需要创建/更新哪些模板产物：
+**此外，ADD 工作流的核心产物由 `{{magicDir}}/templates/` 下的 11 个模板定义**，这些模板不是参考资料，而是每次变更必须产出的文档骨架。分析变更影响范围时，必须同步确认需要创建/更新哪些模板产物：
 
 | 模板 | 用途 | 对应阶段 |
 |------|------|---------|
@@ -425,7 +425,7 @@ reason: 中文/英文说明本次改动的目的
 正确示例：
 - ✅ `src/middleware.ts`（{{projectName}} workspace 内）
 - ✅ `agrisynapse/src/api/agent/types.ts`（跨项目时带项目名前缀）
-- ✅ `.qoder/plans/{{projectName}}-agrisynapse-integration-plan-v1.md`（.qoder 内文件）
+- ✅ `{{magicDir}}/plans/{{projectName}}-agrisynapse-integration-plan-v1.md`（.qoder 内文件）
 
 原因：`query_audit_logs({ targetId })` 做精确匹配，绝对路径和相对路径是两条不同的记录，导致漏查。
 
@@ -447,13 +447,13 @@ ADD 开发流程产生多种产物（方案、拆分、交接、评审、spec）
 | `docs/哲学理论/` | 哲学理论基础文章 | 公开 |
 | `{{docsDir}}/` | 项目文档（需求/架构/规范） | 公开 |
 | `TODO/` | 开源协作 TODO，与 docs/ 平级 | 公开 |
-| `.qoder/plans/` | 需求方案（plan）+ 任务拆分（execution）+ 轮间交接手册（handoff） | 开发内部 |
-| `.qoder/reviews/` | 方案评审 + 逐轮 spec 评审 | 开发内部 |
-| `.qoder/specs/` | 每轮 spec + tasks + checklist（三件套） | 开发内部 |
-| `.qoder/templates/` | 文档模板（plan/spec/tasks/checklist/review） | 开发内部 |
-| `.qoder/rules/` | 项目规则文件 | 开发内部 |
-| `.qoder/skills/` | SKILL 行为定义 | 开发内部 |
-| `.qoder/scripts/` | 工具脚本 + MCP 服务器 | 开发内部 |
+| `{{magicDir}}/plans/` | 需求方案（plan）+ 任务拆分（execution）+ 轮间交接手册（handoff） | 开发内部 |
+| `{{magicDir}}/reviews/` | 方案评审 + 逐轮 spec 评审 | 开发内部 |
+| `{{magicDir}}/specs/` | 每轮 spec + tasks + checklist（三件套） | 开发内部 |
+| `{{magicDir}}/templates/` | 文档模板（plan/spec/tasks/checklist/review） | 开发内部 |
+| `{{magicDir}}/rules/` | 项目规则文件 | 开发内部 |
+| `{{magicDir}}/skills/` | SKILL 行为定义 | 开发内部 |
+| `{{magicDir}}/scripts/` | 工具脚本 + MCP 服务器 | 开发内部 |
 
 ### 命名规范
 
@@ -466,31 +466,31 @@ ADD 开发流程产生多种产物（方案、拆分、交接、评审、spec）
 ### ADD 工作流三大阶段与目录对应
 
 ```
-需求理解 + 任务拆分 → .qoder/plans/      （plan + execution + handoff）
+需求理解 + 任务拆分 → {{magicDir}}/plans/      （plan + execution + handoff）
     ↓
-Review（强制关卡）    → .qoder/reviews/    （plan-review + roundN-spec-review）
+Review（强制关卡）    → {{magicDir}}/reviews/    （plan-review + roundN-spec-review）
     ↓
-Spec 执行              → .qoder/specs/       （三件套：spec + tasks + checklist）
+Spec 执行              → {{magicDir}}/specs/       （三件套：spec + tasks + checklist）
 ```
 
 **Review 强制关卡约束**：每轮计划在实际代码改动之前，必须先生成 Review 文件并通过评审。
 - Review 是 **spec → 代码** 之间的强制关卡，未通过 Review 不得写代码
 - Review 至少包含：元信息（对象/方案/时间/类型）、问题复现、方案对比、决策结论
-- 每轮的 Review 文件路径：`.qoder/reviews/{需求域名}-round{N}-{核心内容}-spec-review-v{版本}.md`
+- 每轮的 Review 文件路径：`{{magicDir}}/reviews/{需求域名}-round{N}-{核心内容}-spec-review-v{版本}.md`
 
 ### 文档产出物模板
 
-ADD 开发流程产生五类文档，模板文件位于 `.qoder/templates/`：
+ADD 开发流程产生五类文档，模板文件位于 `{{magicDir}}/templates/`：
 
 | 模板 | 文件路径 | 说明 |
 |------|---------|------|
-| Plan | `.qoder/templates/plan-template.md` | 元信息 + 背景目标 + 方案选型 + 架构设计 + 实施步骤 + 验收标准 + 关联文档 |
-| Spec | `.qoder/templates/spec-template.md` | Why + What Changes + Impact + Requirements(WHEN/THEN) |
-| Tasks | `.qoder/templates/tasks-template.md` | Phase → Task → SubTask 层级 |
-| Checklist | `.qoder/templates/checklist-template.md` | Phase 检查项 + ADD 规则合规检查 |
-| Review | `.qoder/templates/review-template.md` | 元信息 + 问题复现 + 方案对比 + 决策结论 + 影响评估 |
-| Handoff（单轮） | `.qoder/templates/handoff-single-round-template.md` | 单轮变更 Handoff 基础格式（9 章节） |
-| Handoff（多轮） | `.qoder/templates/handoff-multi-round-template.md` | 多轮原子事务 Handoff（全局结构 + 13 子章节 + 收敛规则 + 启动模板） |
+| Plan | `{{magicDir}}/templates/plan-template.md` | 元信息 + 背景目标 + 方案选型 + 架构设计 + 实施步骤 + 验收标准 + 关联文档 |
+| Spec | `{{magicDir}}/templates/spec-template.md` | Why + What Changes + Impact + Requirements(WHEN/THEN) |
+| Tasks | `{{magicDir}}/templates/tasks-template.md` | Phase → Task → SubTask 层级 |
+| Checklist | `{{magicDir}}/templates/checklist-template.md` | Phase 检查项 + ADD 规则合规检查 |
+| Review | `{{magicDir}}/templates/review-template.md` | 元信息 + 问题复现 + 方案对比 + 决策结论 + 影响评估 |
+| Handoff（单轮） | `{{magicDir}}/templates/handoff-single-round-template.md` | 单轮变更 Handoff 基础格式（9 章节） |
+| Handoff（多轮） | `{{magicDir}}/templates/handoff-multi-round-template.md` | 多轮原子事务 Handoff（全局结构 + 13 子章节 + 收敛规则 + 启动模板） |
 
 使用时直接复制模板文件到目标路径，将 `{...}` 占位符替换为实际内容。
 
@@ -571,7 +571,7 @@ Handoff 分两种场景，格式要求不同：
 | 2 | **上游已完成** | ✅ | 列表：上游本轮依赖的能力/文件/状态（不允许靠记忆，必须写清楚） |
 | 3 | **恢复上下文审计查询** | ✅ | MCP 工具调用列表，按"第一步搜索代码 → 第二步搜索文档 → 第三步按行动词"组织。每个 `query_audit_logs` 写清楚预期命中数和返回内容摘要 |
 | 4 | **原子事务目标** | ✅ | 一句话概括本轮目标；覆盖父 Plan 的哪个 Step |
-| 5 | **spec 文件** | ✅ | `.qoder/specs/{spec-name}/spec.md` + `tasks.md` + `checklist.md` 三件套路径 |
+| 5 | **spec 文件** | ✅ | `{{magicDir}}/specs/{spec-name}/spec.md` + `tasks.md` + `checklist.md` 三件套路径 |
 | 6 | **架构文档** | ✅ | 关联的 `docs/` 下架构/技术文档路径 + 对应章节号 |
 | 7 | **你要改的文件** | ✅ | 表格：文件路径 + 操作（新建/修改）+ 改什么（一句话） |
 | 8 | **核心设计** | 🔶 | 本轮最关键的代码片段/设计要点，不超过 10 行 |
@@ -827,12 +827,12 @@ AI 助手遵循"调用工具 → 获得结果 → 编码 → 验证"的闭环流
 
 ### MCP-5：稀疏推理恢复（Sparse Inference Recovery）
 
-AI 助手在**每次新对话启动时**，必须先执行 `.qoder/skills/session-init/SKILL.md`（SKILL-1 会话初始化），作为**不可跳过的前置操作**。
+AI 助手在**每次新对话启动时**，必须先执行 `{{magicDir}}/skills/session-init/SKILL.md`（SKILL-1 会话初始化），作为**不可跳过的前置操作**。
 
 `session-init` SKILL 的 Step 1 要求调用 `query_audit_logs` 工具查询开发操作审计记录，以恢复开发上下文。
 
 **执行顺序**（新对话启动时的首个操作）：
-1. 定位并执行 `session-init` SKILL（`.qoder/skills/session-init/SKILL.md`）
+1. 定位并执行 `session-init` SKILL（`{{magicDir}}/skills/session-init/SKILL.md`）
 2. 按 SKILL 的 Step 1 调用 `query_audit_logs({})` 查询
 3. 按 SKILL 的 Step 2 分析推断上下文
 4. 按 SKILL 的 Step 3 构建摘要
@@ -867,7 +867,7 @@ AI 助手在**每次新对话启动时**，必须先执行 `.qoder/skills/sessio
 
 ### MCP 配置
 
-MCP 服务器配置在 `.qoder/mcp.json`，通过 `npx tsx .qoder/scripts/mcp-server.ts` 启动。
+MCP 服务器配置在 `{{magicDir}}/mcp.json`，通过 `npx tsx {{magicDir}}/scripts/mcp-server.ts` 启动。
 Trae IDE 加载项目时自动连接 MCP 服务器。
 
 ### 附录

package/templates/core/scripts/mcp-server.ts

@@ -394,7 +394,7 @@ server.registerTool(
 
         // ADD 工作流产物目录
         parts.push(`=== ${MAGIC_DIR}/ ADD 工作流产物 ===`)
-        const qoderDirs = [
+        const magicDirs = [
           { dir: "templates", desc: "ADD 文档模板（11 个）" },
           { dir: "specs", desc: "specs 三元组（spec+tasks+checklist）" },
           { dir: "reviews", desc: "方案审查 + 实现审查 + 运行时审查" },
@@ -403,7 +403,7 @@ server.registerTool(
           { dir: "skills", desc: "SKILL 行为定义（add-paradigm / session-init）" },
           { dir: "scripts", desc: "工具脚本 + MCP 服务器" },
         ]
-        for (const { dir, desc } of qoderDirs) {
+        for (const { dir, desc } of magicDirs) {
           const fullPath = join(PROJECT_ROOT, MAGIC_DIR, dir)
           if (existsSync(fullPath)) {
             const entries = await readdir(fullPath)
@@ -981,7 +981,7 @@ export async function record${featureName}Audit(record: ${featureName}AuditRecor
 server.registerTool(
   "query_audit_logs",
   {
-    description: "稀疏查询开发操作审计日志（DevOperation 表，MCP-5 稀疏推理恢复）。支持多维度检索，AI 可在不同对话会话中通过任意维度组合查询之前的开发操作记录，实现跨会话的上下文恢复。\n\n典型用法:\n- query_audit_logs({ targetType: \"API_ROUTE\" }) — 查所有 API 路由改动\n- query_audit_logs({ targetId: \"src/app/api/knowledge/route.ts\" }) — 查特定文件改动\n- query_audit_logs({ keyword: \"pagination\" }) — 按关键词搜索\n- query_audit_logs({ planKeyword: \"add-qoder\" }) — 按 Plan 关键词查该 Plan 下所有 devlog\n- query_audit_logs({}) — 查最近的记录（session-init 会话恢复）",
+    description: "稀疏查询开发操作审计日志（DevOperation 表，MCP-5 稀疏推理恢复）。支持多维度检索，AI 可在不同对话会话中通过任意维度组合查询之前的开发操作记录，实现跨会话的上下文恢复。\n\n典型用法:\n- query_audit_logs({ targetType: \"API_ROUTE\" }) — 查所有 API 路由改动\n- query_audit_logs({ targetId: \"src/app/api/knowledge/route.ts\" }) — 查特定文件改动\n- query_audit_logs({ keyword: \"pagination\" }) — 按关键词搜索\n- query_audit_logs({ planKeyword: \"add-coder\" }) — 按 Plan 关键词查该 Plan 下所有 devlog\n- query_audit_logs({}) — 查最近的记录（session-init 会话恢复）",
     inputSchema: {
       targetType: z.string().optional().describe("按目标类型精确过滤"),
       action: z.string().optional().describe("按操作类型精确过滤"),
@@ -1223,7 +1223,7 @@ server.registerTool(
       }
 
       // ${MAGIC_DIR}/ 产物类别映射
-      const qoderCategoryMap: Record<string, string> = {
+      const magicCategoryMap: Record<string, string> = {
         plans: "plan",
         specs: "spec",
         reviews: "review",
@@ -1232,7 +1232,7 @@ server.registerTool(
       // 收集所有 Markdown 文件
       const allFiles: Array<{ path: string; relativePath: string; category: string }> = []
 
-      const walkDir = async (dir: string, relativeDir: string, sourceType: "docs" | "qoder" = "docs"): Promise<void> => {
+      const walkDir = async (dir: string, relativeDir: string, sourceType: "docs" | "magic" = "docs"): Promise<void> => {
         try {
           const entries = await readdir(dir, { withFileTypes: true })
           for (const entry of entries) {
@@ -1242,10 +1242,10 @@ server.registerTool(
               await walkDir(fullPath, relPath, sourceType)
             } else if (entry.isFile() && (entry.name.endsWith(".md") || entry.name.endsWith(".html"))) {
               let docCategory = "unknown"
-              if (sourceType === "qoder") {
+              if (sourceType === "magic") {
                 // ${MAGIC_DIR}/ 产物按目录分类
                 const topDir = relPath.split("/")[0]
-                docCategory = qoderCategoryMap[topDir] || "unknown"
+                docCategory = magicCategoryMap[topDir] || "unknown"
                 // handoff 文件特殊识别（存放在 plans/ 下但含 handoff 关键词）
                 if (topDir === "plans" && entry.name.includes("handoff")) {
                   docCategory = "handoff"
@@ -1274,11 +1274,11 @@ server.registerTool(
       // 搜索 docs/ 目录
       await walkDir(docsDir, "", "docs")
       // 搜索 ${MAGIC_DIR}/ 产物目录（plans/specs/reviews）
-      const qoderSearchDirs = ["plans", "specs", "reviews"]
-      for (const qDir of qoderSearchDirs) {
-        const qPath = join(PROJECT_ROOT, MAGIC_DIR, qDir)
-        if (existsSync(qPath)) {
-          await walkDir(qPath, qDir, "qoder")
+      const magicSearchDirs = ["plans", "specs", "reviews"]
+      for (const mDir of magicSearchDirs) {
+        const mPath = join(PROJECT_ROOT, MAGIC_DIR, mDir)
+        if (existsSync(mPath)) {
+          await walkDir(mPath, mDir, "magic")
         }
       }
 
@@ -2127,12 +2127,12 @@ server.registerTool(
       const planContent = await readFileSafe(planPath)
       let specDirName = ""
       if (planContent) {
-        const specMatch = planContent.match(/Spec:\s*\.qoder\/specs\/([^/\s]+)/)
+        const specMatch = planContent.match(/Spec:\s*\.(qoder|claude|add|vscode)\/specs\/([^/\s]+)/)
         if (specMatch) specDirName = specMatch[1]
       }
       if (!specDirName) {
         // 退而求其次：从 tasks.md 引用提取
-        const taskMatch = planContent?.match(/Tasks:\s*\.qoder\/specs\/([^/\s]+)/)
+        const taskMatch = planContent?.match(/Tasks:\s*\.(qoder|claude|add|vscode)\/specs\/([^/\s]+)/)
         if (taskMatch) specDirName = taskMatch[1]
       }
       if (!specDirName) {
@@ -2809,7 +2809,7 @@ server.registerTool(
       if (existsSync(reviewsDir)) {
         const reviewFiles = await readdir(reviewsDir)
         // 从 Plan 全文提取所有 Review 引用，优先匹配含 planKeyword 的
-        const allReviewRefs = Array.from(planContent.matchAll(/\.qoder\/reviews\/([^\s)]+\.md)/g))
+        const allReviewRefs = Array.from(planContent.matchAll(/\.(qoder|claude|add|vscode)\/reviews\/([^\s)]+\.md)/g))
           .map(m => m[1].split("/").pop() || "")
           .filter(Boolean)
         // 策略1: 在所有引用中优先选含 planKeyword 的
@@ -2837,10 +2837,10 @@ server.registerTool(
       let specContent = ""
       let tasksContent = ""
       // 从 Plan 绑定或 §7 提取
-      const specRef = planContent.match(/Spec:\s*\.qoder\/specs\/([^/\s]+)/)
+      const specRef = planContent.match(/Spec:\s*\.(qoder|claude|add|vscode)\/specs\/([^/\s]+)/)
       if (specRef) specDirName = specRef[1]
       if (!specDirName) {
-        const taskRef = planContent.match(/Tasks:\s*\.qoder\/specs\/([^/\s]+)/)
+        const taskRef = planContent.match(/Tasks:\s*\.(qoder|claude|add|vscode)\/specs\/([^/\s]+)/)
         if (taskRef) specDirName = taskRef[1]
       }
       if (!specDirName) {