@modus-ai/modus 0.2.11 → 0.3.0

package/templates/skills/modus-auto/SKILL.md

@@ -220,7 +220,7 @@ Modus Auto — 智能模式路由工具
   /modus:auto https://tapd.cn/.../1234 --scores-only --output json
   /modus:auto --resume
 
-更多文档：modus/knowledge-catalog.md
+更多文档：modus/knowledge_base/map.md
 ```
 
 ---
@@ -264,8 +264,8 @@ except MCP_UNAVAILABLE:
 
 # 2. 尝试读取知识目录（文件系统不可用时跳过）
 try:
-    catalog = read("modus/knowledge-catalog.md")
-    # v3.2 路径：modus/knowledge/biz-*/SKILL.md（唯一权威）
+    catalog = read("modus/knowledge_base/map.md")
+    # v3.2 路径：modus/knowledge_base/domain/*/code/SKILL.md（唯一权威）
 except FILESYSTEM_UNAVAILABLE:
     catalog = None
     note += " | 文件系统不可用，跳过 Skill 加载，基于 Story 文本评分"
@@ -297,7 +297,7 @@ context_bundle:
   story_id: "1234567890"
   story_title: "{Story 标题}"
   domains: ["{domain}"]
-  domain_skill_path: "modus/knowledge/{domain}/SKILL.md"   # v3.2 路径
+  domain_skill_path: "modus/knowledge_base/domain/{domain}/code/SKILL.md"   # v3.2 路径
   scores: {complexity: 2, risk: 1, clarity: 3, contract: 1}
   recommended_mode: "spec"
   skip_clarify: true
@@ -359,15 +359,15 @@ if cache.valid:
 
 #### Step 2：读取知识目录
 
-读取 `modus/knowledge-catalog.md`：
+读取 `modus/knowledge_base/map.md`：
 
 ```
 知识库路径（v3.2 Single Source of Truth）：
-  modus/knowledge/biz-*/SKILL.md      ← Layer 2 业务域（唯一权威，v3.1+ 迁移后）
-  modus/knowledge/_tech-wiki/SKILL.md
-  modus/knowledge/_conventions/SKILL.md
+  modus/knowledge_base/domain/*/code/SKILL.md      ← Layer 2 业务域（唯一权威，v3.1+ 迁移后）
+  modus/knowledge_base/domain/_tech-wiki/code/SKILL.md
+  modus/knowledge_base/domain/_conventions/code/SKILL.md
 
-⚠️ 注意（v3.1+ 变更）：业务域 Skill 已迁移至 modus/knowledge/biz-*/SKILL.md，
+⚠️ 注意（v3.1+ 变更）：业务域 Skill 已迁移至 modus/knowledge_base/domain/*/code/SKILL.md，
    .codebuddy/skills/modus-biz-* 为引用桩，不含实际内容，请勿从旧路径读取。
 ```
 
@@ -454,7 +454,7 @@ if cache.valid:
 若用户带 `--preview`，路由完成后输出产物目录预览，然后停止：
 ```
 预览：/modus:spec 将在以下路径生成产物
-  modus/stories/{id}/spec/
+  modus/artifacts/{id}/code/spec/
     ├── .modus-state.yaml
     ├── delta/{domain}.md
     ├── design.md
@@ -521,7 +521,7 @@ if cache.valid:
 确认启动 /modus:plan
   Story 摘要: {标题 + 核心需求}
   业务域:     {domain} [draft]
-  产物路径:   modus/stories/{id}/plan.md  ← v3.2 统一路由
+  产物路径:   modus/artifacts/{id}/code/plan.md  ← v3.2 统一路由
   快速模式（--quick，跳过设计文档）: [y/N]
   
 确认？[Y/n]
@@ -533,7 +533,7 @@ if cache.valid:
   Story URL:  {原始 URL}
   业务域:     {domain} [draft]
   规格级别:   Full（因有接口契约变更）/ 可加 --lite 降级
-  产物路径:   modus/stories/{id}/spec/  ← v3.2 统一路由
+  产物路径:   modus/artifacts/{id}/code/spec/  ← v3.2 统一路由
   验收标准:   已提取 {n} 条，将作为 Scenario 输入
   
 确认？[Y/n]
@@ -543,7 +543,7 @@ if cache.valid:
 ```
 确认启动 /modus:harness
   Story URL:  {原始 URL}
-  产物路径:   modus/stories/{id}/harness/  ← v3.2 统一路由
+  产物路径:   modus/artifacts/{id}/code/  ← v3.2 统一路由
   跳过阶段:   无（如需跳过：--skip [agents]）
   
 ⚠️ Harness 将全自动执行多个 SubAgent，预计耗时较长。
@@ -562,7 +562,7 @@ context_bundle:
   acceptance_criteria: ["{ac1}", "{ac2}"]
   domains: ["{domain}"]
   domain_skill_paths:                           # v3.2 路径（唯一权威）
-    - "modus/knowledge/{domain}/SKILL.md"
+    - "modus/knowledge_base/domain/{domain}/code/SKILL.md"
   domain_skills_loaded: true
   scores:
     complexity: 2
@@ -588,16 +588,16 @@ context_bundle:
 
 ```
 有 --story [id]：
-  modus/stories/{id}/plan.md          # plan 产物
-  modus/stories/{id}/spec/            # spec 产物目录
-  modus/stories/{id}/harness/         # harness 产物目录
+  modus/artifacts/{id}/code/plan.md          # plan 产物
+  modus/artifacts/{id}/code/spec/            # spec 产物目录
+  modus/artifacts/{id}/code/         # harness 产物目录
 
 无 --story（自动推断 feature 名）：
   modus/local/{feature-name}/plan.md
   modus/local/{feature-name}/spec/
 ```
 
-> **v3.2 变更说明**：废弃 `modus/plans/active/{id}/`，统一使用 `modus/stories/{id}/`。
+> **v3.2 变更说明**：废弃 `modus/plans/active/{id}/`，统一使用 `modus/artifacts/{id}/`。
 
 ---
 
@@ -653,7 +653,7 @@ Modus Auto — 请提供需求来源：
 - **--no-confirm 默认生效**：Codex 环境视同携带此参数
 - **文件系统降级**：文件系统不可用时跳过 Skill 加载，仅基于 Story 文本评分，Context Bundle 不写文件
 - **结构化日志**：`--output json` 时输出完整 JSON，便于在 Codex 日志中机器解析
-- **Context Bundle 路径**：使用 `modus/knowledge/biz-*/SKILL.md`（v3.2 唯一权威路径），不读旧路径
+- **Context Bundle 路径**：使用 `modus/knowledge_base/domain/*/code/SKILL.md`（v3.2 唯一权威路径），不读旧路径
 
 ---
 

package/templates/skills/modus-cr/SKILL.md

@@ -51,7 +51,7 @@ disable: false
    - 若路径是目录，自动在目录内查找：`design.md` > `plan.md`，以及同级 `tasks.md`
 2. 若有 `--story`，调用 TAPD MCP（`tapd_mcp_http`）读取 Story 描述作为 PRD 补充
 3. `modus/config.yaml`：读取 `constitution`（`hard_rules`、`tech_stack`、`key_patterns`）
-4. `modus/knowledge-catalog.md`：识别相关业务域，加载对应 `modus/knowledge/biz-{domain}/SKILL.md`（仅 hash 检查，不更新）
+4. `modus/knowledge_base/map.md`：识别相关业务域，加载对应 `modus/knowledge_base/domain/{domain}/code/SKILL.md`（仅 hash 检查，不更新）
 
 **输出上下文加载摘要：**
 

package/templates/skills/modus-design-brief/SKILL.md

@@ -27,7 +27,7 @@ disable: false
 
 | `mode` 值 | 来源类型 | 处理方式 |
 |----------|---------|---------|
-| `harness` | 文件路径 | 读取 `modus/stories/{story-id}/harness/01-analysis.md`（v3.2 路径）|
+| `harness` | 文件路径 | 读取 `modus/artifacts/{story_id}/pid/prd.md`（v3.2 路径）|
 | `spec` | 文件路径 | 读取调用方目录下的 `proposal.md`；若存在同级 `specs/*/spec.md` 也一并读取 |
 | `vibe` | 运行时字符串 | `analysis_doc` 参数是调用方直接传入的「用户意图摘要」字符串，**不读取任何文件**；直接将此字符串作为需求描述，与 Step 5 加载的 Skill 内容结合生成设计方案 |
 
@@ -108,7 +108,7 @@ disable: false
 将生成内容写入调用方指定路径：
 - plan 模式：`modus/plans/{name}/design-brief.md`
 - spec 模式：`modus/changes/{name}/design-brief.md`（gate_status 写 `passed`，此模式无 Gate 检查）
-- harness 模式：`modus/stories/{story-id}/harness/02-design-brief.md`
+- harness 模式：`modus/artifacts/{story_id}/design/design.md`
   - **gate_status 必须由 `modus-designer` SubAgent 在 Step 4 后动态评估并填写**（见 `modus-harness-agents/01-5-design/SKILL.md` 的 gate_status 赋值规则）
   - 固定写 `passed` 将使 Gate A0.5 失效，严禁在 harness 模式下硬编码该字段
 
@@ -347,4 +347,4 @@ constitution: {constitution 字段内容}
 
 ### harness 模式调用方式
 
-由 SubAgent 02（设计阶段，原 01.5）独立执行（见 `modus-harness-agents/01-5-design/SKILL.md`），输入为 `modus/stories/{story-id}/harness/01-analysis.md`，输出为 `modus/stories/{story-id}/harness/02-design-brief.md` 含 HANDOFF 块（`agent: "02-design"`）。
+由 SubAgent 02（设计阶段，原 01.5）独立执行（见 `modus-harness-agents/01-5-design/SKILL.md`），输入为 `modus/artifacts/{story_id}/pid/prd.md`，输出为 `modus/artifacts/{story_id}/design/design.md` 含 HANDOFF 块（`agent: "02-design"`）。

package/templates/skills/modus-harness/SKILL.md

@@ -101,7 +101,7 @@ Step P1：读取 plan.md
     → continue_token：记录到工作目录 .harness-state.yaml
 
 Step P2：初始化工作目录
-  若 plan.md 含 story_id：工作目录 = modus/stories/{story_id}/harness/
+  若 plan.md 含 story_id：工作目录 = modus/artifacts/{story_id}/code/
   若无 story_id：工作目录 = modus/plans/{PLAN_NAME}/harness/
 
 Step P3：输出接力摘要
@@ -130,10 +130,10 @@ Step P4：设置 SKIP_AGENTS = ["01", "02"]（强制跳过 SA01 + SA02）
 读取 `{project}/modus/config.yaml`（即当前项目根目录下的 `modus/config.yaml`，多项目 workspace 需先通过 `workspace-catalog.md` 确认项目路径，如 `operations-job/modus/config.yaml`）的 `constitution` 字段，将 `hard_rules` 传递给所有 SubAgent 作为硬性约束。SubAgent 直接使用 Orchestrator 传入的 constitution 内容，无需独立解析路径。
 
 **检查业务 Skill：**
-读取 `modus/knowledge-catalog.md`（Level 1 加载）：
+读取 `modus/knowledge_base/map.md`（Level 1 加载）：
 - 若不存在，强烈建议先运行 `/modus:init`：
 ```
-⚠️ 未找到知识目录（modus/knowledge-catalog.md）！
+⚠️ 未找到知识目录（modus/knowledge_base/map.md）！
 
 /modus:harness 依赖业务 Skill 为 SubAgent 提供项目背景知识。
 建议：
@@ -143,14 +143,14 @@ B. 强制继续（无业务上下文，风险较高）
 
 **解析 Story ID + 初始化状态追踪：**
 - 从 TAPD URL 提取 Story ID（格式：`tapd.cn/{project}/stories/view/{id}`）
-- 创建工作目录：`modus/stories/{story-id}/harness/`
+- 创建工作目录：`modus/artifacts/{story_id}/code/`
 
 **`.harness-state.yaml` 断点续跑机制（优先级高于 HANDOFF 块探测）：**
 
 检查工作目录下是否存在 `.harness-state.yaml`；若存在部分产出物（含 HANDOFF frontmatter），也可从断点处继续。
 
 ```yaml
-# 示例：modus/stories/{story-id}/harness/.harness-state.yaml
+# 示例：modus/artifacts/{story_id}/code/.harness-state.yaml
 story_id: "{story-id}"
 loop: 1                         # 当前 Loop 轮次（1 或 2）
 # SubAgent ID 约定：00=INIT 阶段、01/02/03/04/05/06/07/08 为主流程；00-ARCHIVE=ARCHIVE 阶段

package/templates/skills/modus-init/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: modus-init
-description: Use this skill when executing /modus:init command (or /modus:init --help/--enhance/--migrate/--dry-run etc.) to scan the codebase, classify business domains, generate Business Skill files in modus/knowledge/, update knowledge-catalog.md, and sync to multi-platform adapters. Trigger on /modus:init or any of its parameter variants. (Modus v3.3 — Router + Strategy)
+description: Use this skill when executing /modus:init command (or /modus:init --help/--enhance/--migrate/--dry-run etc.) to scan the codebase, classify business domains, generate Business Skill files in modus/knowledge_base/, update knowledge-catalog.md, and sync to multi-platform adapters. Trigger on /modus:init or any of its parameter variants. (Modus v3.3 — Router + Strategy)
 allowed-tools: Read, Write, Glob, Bash
 disable: false
 architecture: router-strategy        # v3.3 起：本文件为 Router；具体扫描 + Skill 生成委派给 strategies/{stack}-init.md
@@ -55,8 +55,8 @@ supported_platforms:
   --platform <p1,p2>        仅同步指定平台（claude,cursor,codex,copilot，逗号分隔）
   --dry-run                 预览将生成/修改的文件清单，不写入磁盘
   --force                   跳过所有「是否确认」交互，直接执行
-  --no-sync                 跳过多平台同步，仅生成 modus/knowledge/ 下的文件
-  --migrate                 将旧路径 .codebuddy/skills/modus-biz-* 迁移到 modus/knowledge/
+  --no-sync                 跳过多平台同步，仅生成 modus/knowledge_base/ 下的文件
+  --migrate                 将旧路径 .codebuddy/skills/modus-biz-* 迁移到 modus/knowledge_base/
   --verbose                 输出详细扫描过程（文件列表、token 预估、hash 变化）
   --reset-maturity          重置所有 Skill 的 maturity 为 draft（谨慎使用）
 
@@ -64,7 +64,7 @@ supported_platforms:
   /modus:init                          # 全量初始化（首次或大重构后）
   /modus:init --enhance biz-track      # 仅更新歌曲域知识
   /modus:init --migrate --dry-run      # 预览迁移操作，不写入
-  /modus:init --migrate                # 执行知识库路径迁移（旧 → modus/knowledge/）
+  /modus:init --migrate                # 执行知识库路径迁移（旧 → modus/knowledge_base/）
   /modus:init --enhance-all --no-sync  # 重建所有业务域，不同步平台
   /modus:init --project operations-job --enhance biz-album  # 多项目指定
 ```
@@ -82,7 +82,7 @@ Modus Init — 业务知识库初始化工具
 用途：
   扫描项目代码，按业务域分类，生成结构化 Skill 文件，作为后续所有
   Modus 命令（vibe/plan/spec/harness）的知识底座。
-  支持多项目工作区路由，知识库统一存放于 modus/knowledge/（平台无关）。
+  支持多项目工作区路由，知识库统一存放于 modus/knowledge_base/（平台无关）。
 
 语法：
   /modus:init [参数]
@@ -96,14 +96,14 @@ Modus Init — 业务知识库初始化工具
   --dry-run                 预览模式，不写入文件
   --force                   跳过所有确认提示
   --no-sync                 跳过多平台同步
-  --migrate                 迁移旧知识路径到 modus/knowledge/
+  --migrate                 迁移旧知识路径到 modus/knowledge_base/
   --verbose                 显示详细扫描日志
   --reset-maturity          重置 Skill 成熟度为 draft
 
 知识库路径（v3.1）：
-  modus/knowledge/_conventions/SKILL.md   — Layer 0-T 团队约定
-  modus/knowledge/_tech-wiki/SKILL.md     — Layer 1 技术知识
-  modus/knowledge/biz-*/SKILL.md          — Layer 2 业务域知识（Single Source of Truth）
+  modus/knowledge_base/domain/_conventions/code/SKILL.md   — Layer 0-T 团队约定
+  modus/knowledge_base/domain/_tech-wiki/code/SKILL.md     — Layer 1 技术知识
+  modus/knowledge_base/domain/*/code/SKILL.md          — Layer 2 业务域知识（Single Source of Truth）
 
 平台适配文件（引用式，勿直接编辑）：
   .codebuddy/skills/modus-biz-*/SKILL.md  — CodeBuddy 引用桩
@@ -256,20 +256,20 @@ Modus Init — 业务知识库初始化工具
 
 当用户运行 `/modus:init --migrate` 时执行此流程。
 
-**目标：** 将旧路径 `.codebuddy/skills/modus-biz-*` 迁移到 `modus/knowledge/biz-*`
+**目标：** 将旧路径 `.codebuddy/skills/modus-biz-*` 迁移到 `modus/knowledge_base/domain/*/code`
 
 **执行步骤：**
 
 ```
 Step 1-1: 扫描现有文件
   检测 .codebuddy/skills/modus-biz-*/SKILL.md（旧路径）
-  检测 modus/knowledge/biz-*/SKILL.md（新路径，若已存在则提示）
+  检测 modus/knowledge_base/domain/*/code/SKILL.md（新路径，若已存在则提示）
 
 Step 1-2: 展示迁移计划（即使不带 --dry-run 也先展示）
   迁移计划（共 N 个域）：
   ┌──────────────────────────────────────────────────┐
   │ 从：.codebuddy/skills/modus-biz-track/SKILL.md   │
-  │ 到：modus/knowledge/biz-track/SKILL.md           │
+  │ 到：modus/knowledge_base/domain/track/code/SKILL.md           │
   │ 操作：复制 → 改写原文件为引用桩                    │
   └──────────────────────────────────────────────────┘
   (重复 N 次)
@@ -281,16 +281,16 @@ Step 1-3: 用户确认（--force 时跳过）
 
 Step 1-4: 执行迁移
   对每个业务域：
-  a. mkdir -p modus/knowledge/biz-{domain}/
+  a. mkdir -p modus/knowledge_base/domain/{domain}/code/
   b. 复制完整 SKILL.md 内容到新路径
   c. 将原 .codebuddy/skills/modus-biz-{domain}/SKILL.md 改写为引用桩：
      ---
      name: modus-biz-{domain}
-     modus_ref: "{project}/modus/knowledge/biz-{domain}/SKILL.md"
+     modus_ref: "{project}/modus/knowledge_base/domain/{domain}/code/SKILL.md"
      stub: true
      ---
-     <!-- MODUS_REF: {project}/modus/knowledge/biz-{domain}/SKILL.md -->
-     > 业务知识已迁移至：`{project}/modus/knowledge/biz-{domain}/SKILL.md`
+     <!-- MODUS_REF: {project}/modus/knowledge_base/domain/{domain}/code/SKILL.md -->
+     > 业务知识已迁移至：`{project}/modus/knowledge_base/domain/{domain}/code/SKILL.md`
   d. 对 _conventions 和 _tech-wiki 同理处理
 
 Step 1-5: 更新所有引用文件
@@ -302,7 +302,7 @@ Step 1-5: 更新所有引用文件
 Step 1-6: 完成回报
   ✅ 迁移完成
   已迁移 N 个业务域：
-    biz-track → modus/knowledge/biz-track/SKILL.md ✓
+    biz-track → modus/knowledge_base/domain/track/code/SKILL.md ✓
     ...
   已更新引用文件：knowledge-catalog.md, CLAUDE.md, AGENTS.md
 ```
@@ -315,8 +315,8 @@ Step 1-6: 完成回报
 
 ```
 Step 2-1: 确定目标域
-  --enhance biz-track    → 目标：modus/knowledge/biz-track/SKILL.md
-  --enhance-all          → 目标：所有 modus/knowledge/biz-*/SKILL.md
+  --enhance biz-track    → 目标：modus/knowledge_base/domain/track/code/SKILL.md
+  --enhance-all          → 目标：所有 modus/knowledge_base/domain/*/code/SKILL.md
 
 Step 2-2: hash 检查（跳过未变化的域）
   读取当前 Skill frontmatter 中的 last_hash
@@ -329,7 +329,7 @@ Step 2-3: 扫描目标域代码
   提取：核心实体变化、业务规则变化、API 契约变化
 
 Step 2-4: 重建 Skill 文件
-  更新 modus/knowledge/biz-{domain}/SKILL.md
+  更新 modus/knowledge_base/domain/{domain}/code/SKILL.md
   更新 frontmatter: updated, last_hash, last_referenced
 
 Step 2-5: 同步引用桩（若平台适配文件存在）
@@ -369,7 +369,7 @@ Step 2-7: 完成回报
 
 #### 重新初始化分支检查（Step 3 末尾执行）
 
-在进入 Step 4 之前，检查是否已有业务 Skill（`modus/knowledge/biz-*` 或 `.codebuddy/skills/modus-biz-*`）：
+在进入 Step 4 之前，检查是否已有业务 Skill（`modus/knowledge_base/domain/*/code` 或 `.codebuddy/skills/modus-biz-*`）：
 
 **若发现已存在业务 Skill：**
 
@@ -400,7 +400,7 @@ Step 2-7: 完成回报
   - 更新 `format_version`（v1→v2 或 v2→v3）、`version`（小版本 +1）和 `updated` 日期
   - 迁移完成后自动触发 Step 9 多平台同步（`--force` 时默认选择「仅新增缺失域」）
 
-无论何种模式，都在最后更新 `modus/knowledge-catalog.md` 的索引信息。
+无论何种模式，都在最后更新 `modus/knowledge_base/map.md` 的索引信息。
 
 **若未发现已有 Skill：** 继续 Step 4 开始全新初始化流程。
 
@@ -437,7 +437,7 @@ Step 2-7: 完成回报
 2. **技术栈信息**（`techStack` 字段）
    - 从 `CLAUDE.md` 中寻找构建命令、框架名称等技术栈线索
 
-3. **编码规范 / 团队约定**（→ `modus/knowledge/_conventions` Skill）
+3. **编码规范 / 团队约定**（→ `modus/knowledge_base/domain/_conventions/code` Skill）
    - 将各工具中找到的约定规则汇总，标注来源（如 `[来源: .cursor/rules/naming.mdc]`）
 
 4. **MCP 服务器配置**（→ `modus/config.yaml` `mcpServers` 字段）
@@ -459,7 +459,7 @@ Step 2-7: 完成回报
     .cursor/rules/naming.mdc（命名规范）
     .cursor/mcp.json（MCP: tapd）
 
-将把以上规则融入 modus/knowledge/_conventions/SKILL.md，MCP 配置写入 modus/config.yaml。
+将把以上规则融入 modus/knowledge_base/domain/_conventions/code/SKILL.md，MCP 配置写入 modus/config.yaml。
 继续？[Y/n]（--force 时自动确认）
 ```
 
@@ -710,9 +710,9 @@ Step 2-7: 完成回报
 用户在 Step 6 确认域列表后，立即并行启动 N 个 SubAgent：
 
 ```
-SubAgent-1 (biz-{domain1}) ──► 加载 strategy ──► 全量扫描 ──► 生成 modus/knowledge/biz-{domain1}/SKILL.md
-SubAgent-2 (biz-{domain2}) ──► 加载 strategy ──► 全量扫描 ──► 生成 modus/knowledge/biz-{domain2}/SKILL.md
-SubAgent-3 (biz-{domain3}) ──► 加载 strategy ──► 全量扫描 ──► 生成 modus/knowledge/biz-{domain3}/SKILL.md
+SubAgent-1 (biz-{domain1}) ──► 加载 strategy ──► 全量扫描 ──► 生成 modus/knowledge_base/domain/{domain1}/code/SKILL.md
+SubAgent-2 (biz-{domain2}) ──► 加载 strategy ──► 全量扫描 ──► 生成 modus/knowledge_base/biz-{domain2}/SKILL.md
+SubAgent-3 (biz-{domain3}) ──► 加载 strategy ──► 全量扫描 ──► 生成 modus/knowledge_base/biz-{domain3}/SKILL.md
           │                                                                        │
           └──────────────────── 所有 SubAgent 完成 ─────────────────────────────┘
                                            ↓
@@ -735,7 +735,7 @@ SubAgent-3 (biz-{domain3}) ──► 加载 strategy ──► 全量扫描 ─
    - 节号、节名、知识标签**严格遵循** `shared/universal-skill-format.md`（跨栈一致）
    - 节内填充语义按 strategy 的"17 节填充指南"分流
    - frontmatter 严格遵循 `shared/frontmatter-spec.md`
-5. **目标路径**：`modus/knowledge/biz-{domain}/SKILL.md`
+5. **目标路径**：`modus/knowledge_base/domain/{domain}/code/SKILL.md`
 
 #### 8.4 Context 超限自动保护策略（栈无关）
 
@@ -766,8 +766,8 @@ SubAgent-3 (biz-{domain3}) ──► 加载 strategy ──► 全量扫描 ─
 #### 8.6 聚合等待（输出格式栈无关）
 
 ```
-✓ modus/knowledge/biz-{domain1} 已生成（v3-{stack}/17节，{N1}个key_files，{M1}条规则，{K1}个API/endpoint）
-✓ modus/knowledge/biz-{domain2} 已生成（v3-{stack}/17节，{N2}个key_files，{M2}条规则，{K2}个API/endpoint）
+✓ modus/knowledge_base/domain/{domain1}/code 已生成（v3-{stack}/17节，{N1}个key_files，{M1}条规则，{K1}个API/endpoint）
+✓ modus/knowledge_base/biz-{domain2} 已生成（v3-{stack}/17节，{N2}个key_files，{M2}条规则，{K2}个API/endpoint）
 
 跨域依赖 Section 10 回写完成：
   biz-{domain1}.upstream_skills   = [biz-{domainX}, biz-{domainY}]
@@ -798,7 +798,7 @@ SubAgent-3 (biz-{domain3}) ──► 加载 strategy ──► 全量扫描 ─
 主流程在汇总 SubAgent 输出前，必须校验每个 Skill 的 frontmatter 完整性：
 
 ```
-对每个 SubAgent 产出的 modus/knowledge/biz-{domain}/SKILL.md：
+对每个 SubAgent 产出的 modus/knowledge_base/domain/{domain}/code/SKILL.md：
 
 强制项检查：
   ✓ name / description / version / updated / status / format_version / stack
@@ -837,7 +837,7 @@ Business Skills（Step 8）全部生成后，读取 `modus/config.yaml` 的 `pla
 
 **核心设计原则：引用式适配（Reference over Copy）**
 
-`modus/knowledge/` 是 Single Source of Truth。各平台适配文件**不复制内容**，只写引用说明。
+`modus/knowledge_base/` 是 Single Source of Truth。各平台适配文件**不复制内容**，只写引用说明。
 
 > **读取 platforms 配置**：使用 Read 工具读取 `modus/config.yaml` 完整内容，解析其中的 `platforms:` 列表。（Bash 环境也可用 `grep -A5 "^platforms:" modus/config.yaml`）
 
@@ -852,9 +852,9 @@ Business Skills（Step 8）全部生成后，读取 `modus/config.yaml` 的 `pla
 
 执行任何涉及业务逻辑的任务时：
 
-1. 先读取 `modus/knowledge-catalog.md` 或 `modus/workspace-catalog.md`（多项目）
-2. 按需加载 `{project}/modus/knowledge/biz-*/SKILL.md` 获取完整业务上下文
-3. **知识库统一在 modus/knowledge/，不要去 .codebuddy/skills/modus-biz-* 读取（已是引用桩）**
+1. 先读取 `modus/knowledge_base/map.md` 或 `modus/workspace-catalog.md`（多项目）
+2. 按需加载 `{project}/modus/knowledge_base/domain/*/code/SKILL.md` 获取完整业务上下文
+3. **知识库统一在 modus/knowledge_base/，不要去 .codebuddy/skills/modus-biz-* 读取（已是引用桩）**
 
 可用命令：/modus:init | /modus:vibe | /modus:plan | /modus:spec | /modus:harness | /modus:auto
 ```
@@ -864,7 +864,7 @@ Business Skills（Step 8）全部生成后，读取 `modus/config.yaml` 的 `pla
 ```markdown
 ---
 name: modus-biz-{domain}
-description: "[MODUS:BIZ] {中文域名}业务知识。完整知识在 {project}/modus/knowledge/biz-{domain}/SKILL.md"
+description: "[MODUS:BIZ] {中文域名}业务知识。完整知识在 {project}/modus/knowledge_base/domain/{domain}/code/SKILL.md"
 ---
 <!-- modus:meta
 last_hash: "{从 CodeBuddy 主文件读取的 last_hash 值}"
@@ -872,9 +872,9 @@ status: "{从 CodeBuddy 主文件读取的 status 值}"
 updated: "{从 CodeBuddy 主文件读取的 updated 日期}"
 -->
 
-<!-- MODUS_REF: {project}/modus/knowledge/biz-{domain}/SKILL.md -->
+<!-- MODUS_REF: {project}/modus/knowledge_base/domain/{domain}/code/SKILL.md -->
 **域：** {中文域名} | **成熟度：** {maturity} | **更新：** {date}
-> 完整知识见：`{project}/modus/knowledge/biz-{domain}/SKILL.md`
+> 完整知识见：`{project}/modus/knowledge_base/domain/{domain}/code/SKILL.md`
 ```
 
 > 注意：`<!-- modus:meta -->` 注释供工具层快速读取核心防腐字段，每次同步时自动从 CodeBuddy 主文件更新，禁止手动修改。
@@ -883,15 +883,15 @@ updated: "{从 CodeBuddy 主文件读取的 updated 日期}"
 
 ```markdown
 ---
-description: "[MODUS] 知识库引用规则 — 所有业务知识在 modus/knowledge/"
+description: "[MODUS] 知识库引用规则 — 所有业务知识在 modus/knowledge_base/"
 alwaysApply: false
 ---
 
 <!-- MODUS v3.1 知识库路径 -->
-业务知识（Single Source of Truth）：`{project}/modus/knowledge/biz-*/SKILL.md`
-团队约定：`{project}/modus/knowledge/_conventions/SKILL.md`
-技术知识：`{project}/modus/knowledge/_tech-wiki/SKILL.md`
-加载入口：`{project}/modus/knowledge-catalog.md`（~200 tokens）
+业务知识（Single Source of Truth）：`{project}/modus/knowledge_base/domain/*/code/SKILL.md`
+团队约定：`{project}/modus/knowledge_base/domain/_conventions/code/SKILL.md`
+技术知识：`{project}/modus/knowledge_base/domain/_tech-wiki/code/SKILL.md`
+加载入口：`{project}/modus/knowledge_base/map.md`（~200 tokens）
 ```
 
 #### OpenAI Codex / OpenCode（`AGENTS.md`）
@@ -929,7 +929,7 @@ alwaysApply: false
 
 ### Step 10：生成团队约定 Skill（Layer 0-T）
 
-**目标路径（v3.1）：** `modus/knowledge/_conventions/SKILL.md`
+**目标路径（v3.1）：** `modus/knowledge_base/domain/_conventions/code/SKILL.md`
 
 从以下来源提取团队规范（**按优先级排列**）：
 
@@ -942,7 +942,7 @@ alwaysApply: false
 
 ### Step 11：生成技术知识 Skill（Layer 1）
 
-**目标路径（v3.1）：** `modus/knowledge/_tech-wiki/SKILL.md`
+**目标路径（v3.1）：** `modus/knowledge_base/domain/_tech-wiki/code/SKILL.md`
 
 初始内容来源（按优先级）：
 1. Step 4 扫描结果中的技术信息
@@ -953,14 +953,14 @@ alwaysApply: false
 
 ### Step 12：生成知识全景目录（knowledge-catalog.md）
 
-在 `modus/knowledge-catalog.md`（项目级）创建全景索引。
+在 `modus/knowledge_base/map.md`（项目级）创建全景索引。
 
 > **单一真相来源**：目录结构、层级定义、字段格式以 `modus/templates/knowledge-catalog.md` 模板文件为准，本 Step 不再内嵌重复结构。执行时读取该模板文件并按以下规则替换占位符后写入目标路径。
 
 **路径说明（v3.1 格式）：**
-- Layer 0-T 路径：`{project}/modus/knowledge/_conventions/SKILL.md`
-- Layer 1 路径：`{project}/modus/knowledge/_tech-wiki/SKILL.md`
-- Layer 2 路径：`{project}/modus/knowledge/biz-{domain}/SKILL.md`
+- Layer 0-T 路径：`{project}/modus/knowledge_base/domain/_conventions/code/SKILL.md`
+- Layer 1 路径：`{project}/modus/knowledge_base/domain/_tech-wiki/code/SKILL.md`
+- Layer 2 路径：`{project}/modus/knowledge_base/domain/{domain}/code/SKILL.md`
 
 **操作步骤：**
 1. 读取 `{MODUS_PACKAGE}/templates/knowledge-catalog.md`（安装包模板）
@@ -976,7 +976,7 @@ alwaysApply: false
 - `{依赖域列表，无则写-}` → upstream_skills 依赖关系（Step 5 扫描结果）
 - `{last_hash 前8位}` → 运行 hash 计算后的实际值前 8 位；若无法计算，写入 `⚠️ PENDING` 并在知识目录顶部说明原因
 - `{待填入}` → 域依赖图（从 upstream 字段推导：biz-payment --> biz-order 等）
-- 写入后执行自检：`grep -n '{' modus/knowledge-catalog.md | grep -v '<!--'` 输出应为空（注释中的占位符示例不算）
+- 写入后执行自检：`grep -n '{' modus/knowledge_base/map.md | grep -v '<!--'` 输出应为空（注释中的占位符示例不算）
 
 同时更新工作区顶层的 `modus/workspace-catalog.md`（若存在）中的项目更新时间。
 
@@ -996,17 +996,17 @@ alwaysApply: false
 ✅ Modus 知识库初始化完成（v3.2）
 
 知识库路径（Single Source of Truth）：
-  modus/knowledge/_conventions/SKILL.md  (Layer 0-T) [draft]
-  modus/knowledge/_tech-wiki/SKILL.md    (Layer 1)   [draft]
-  modus/knowledge/biz-*/SKILL.md         (Layer 2)   [draft] × N 个域
+  modus/knowledge_base/domain/_conventions/code/SKILL.md  (Layer 0-T) [draft]
+  modus/knowledge_base/domain/_tech-wiki/code/SKILL.md    (Layer 1)   [draft]
+  modus/knowledge_base/domain/*/code/SKILL.md         (Layer 2)   [draft] × N 个域
 
 已融合的已有 AI 工具配置（若有）：
   Claude Code  — CLAUDE.md + .claude/rules/ (M 条规则融入 _conventions)
   Cursor       — .cursor/rules/ (K 条规则融入 _conventions)
 
 生成了 N 个业务 Skill（Layer 2）：
-- modus/knowledge/biz-order/SKILL.md    [draft] [v3/17节]
-- modus/knowledge/biz-payment/SKILL.md  [draft] [v3/17节]
+- modus/knowledge_base/biz-order/SKILL.md    [draft] [v3/17节]
+- modus/knowledge_base/biz-payment/SKILL.md  [draft] [v3/17节]
 - ...
 
 多平台同步（引用式适配，来自 modus/config.yaml platforms 配置）：
@@ -1017,12 +1017,12 @@ alwaysApply: false
   CodeBuddy → .codebuddy/skills/modus-biz-*/SKILL.md（N 个引用桩）
 
 初始化基础 Skill：
-  modus/knowledge/_conventions/SKILL.md  (Layer 0-T) [draft]
+  modus/knowledge_base/domain/_conventions/code/SKILL.md  (Layer 0-T) [draft]
     └─ 融合来源：CLAUDE.md, .cursor/rules/, CONTRIBUTING.md, 代码注解模式
-  modus/knowledge/_tech-wiki/SKILL.md    (Layer 1)   [draft]
+  modus/knowledge_base/domain/_tech-wiki/code/SKILL.md    (Layer 1)   [draft]
 
 知识目录：
-  modus/knowledge-catalog.md（所有命令的快速索引，~200 tokens）
+  modus/knowledge_base/map.md（所有命令的快速索引，~200 tokens）
 
 📊 知识库质量评分报告：
 ┌─────────────────┬──────┬──────┬──────┬──────┬──────┬──────────┐
@@ -1060,12 +1060,12 @@ alwaysApply: false
 
 **重新初始化逻辑（已有 Skill 时）：**
 
-如果 `modus/knowledge/biz-*` 下已存在业务 Skill：
+如果 `modus/knowledge_base/domain/*/code` 下已存在业务 Skill：
 
 1. 展示已有域列表及 status、最后更新时间
 2. 询问：全量重建 / 仅更新指定域（`--enhance`）/ 新增缺失域
 3. 按用户选择执行（`--force` 时默认选择「仅新增缺失域」）
-4. 无论何种选择，都更新 `modus/knowledge-catalog.md` 的时间戳
+4. 无论何种选择，都更新 `modus/knowledge_base/map.md` 的时间戳
 
 ### 防腐机制全链路图
 
@@ -1255,12 +1255,12 @@ name: modus-biz-{domain}
 
 | 文件 | 角色 | 防腐字段权威性 | 更新方式 |
 |------|------|-------------|---------|
-| `modus/knowledge/biz-{domain}/SKILL.md` | **权威源** | 所有防腐字段的唯一权威存储 | 命令直接写入 |
+| `modus/knowledge_base/domain/{domain}/code/SKILL.md` | **权威源** | 所有防腐字段的唯一权威存储 | 命令直接写入 |
 | `.claude/agents/modus-biz-{domain}.md` | 只读快照 | 仅通过 `<!-- modus:meta -->` 注释暴露核心字段 | Step 6 同步时自动更新 |
 | `.cursor/rules/modus-knowledge.mdc` | 只读快照 | 不存储防腐字段（仅路径引用） | Step 6 同步时自动更新 |
 
 **关键原则**：
-- 所有防腐机制的触发（hash 比对、衰减计算、`usage_count` 更新）**均只操作 `modus/knowledge/` 权威源文件**
+- 所有防腐机制的触发（hash 比对、衰减计算、`usage_count` 更新）**均只操作 `modus/knowledge_base/` 权威源文件**
 - 副本文件发生变更不触发防腐机制，不影响 status
 - 若副本与权威源不一致（如手动修改副本），以权威源为准，下次 Step 6 同步时强制覆盖
 
@@ -1325,7 +1325,7 @@ frontmatter 字段规范不在本区块——见 **`shared/frontmatter-spec.md`*
    - draft(fresh)：usage_count = 0（Skill 刚生成，尚未用于真实任务）
    - draft(used) ：usage_count ≥ 1（已用于至少一次开发，有反馈基础）
 
-1. 读取 modus/knowledge/biz-{domain}/SKILL.md 的 frontmatter（v3.2 Single Source of Truth）
+1. 读取 modus/knowledge_base/domain/{domain}/code/SKILL.md 的 frontmatter（v3.2 Single Source of Truth）
 
 2. 运行质量自检清单：
    □ Section 3：每个 Entity 字段均有业务含义注释？
@@ -1384,7 +1384,7 @@ frontmatter 字段规范不在本区块——见 **`shared/frontmatter-spec.md`*
 **执行逻辑：**
 
 ```
-1. 读取 modus/knowledge/biz-{domain}/SKILL.md 的 frontmatter（v3.2 Single Source of Truth）：
+1. 读取 modus/knowledge_base/domain/{domain}/code/SKILL.md 的 frontmatter（v3.2 Single Source of Truth）：
    - key_files 列表
    - last_hash（上次生成时的 SHA-1 值）
    - status（若已为 archived，询问用户是否继续）

package/templates/skills/modus-init/shared/frontmatter-spec.md

@@ -231,11 +231,11 @@ archived (需人工确认)
 
 | 文件 | 角色 | 防腐字段权威性 | 更新方式 |
 |------|------|-------------|---------|
-| `modus/knowledge/biz-{domain}/SKILL.md` | **权威源** | 所有防腐字段的唯一权威存储 | 命令直接写入 |
+| `modus/knowledge_base/domain/{domain}/code/SKILL.md` | **权威源** | 所有防腐字段的唯一权威存储 | 命令直接写入 |
 | 各平台同步副本（`.codebuddy/skills/biz-*/`、`.claude/agents/modus-biz-*.md`、`.continue/skills/biz-*/` 等） | 只读快照 | 仅通过 `<!-- modus:meta -->` 注释暴露核心字段 | Step 9 同步时自动更新 |
 
 **关键原则：**
-- 所有防腐机制的触发（hash 比对、衰减计算、`usage_count` 更新）**只操作 `modus/knowledge/` 权威源**
+- 所有防腐机制的触发（hash 比对、衰减计算、`usage_count` 更新）**只操作 `modus/knowledge_base/` 权威源**
 - 副本变更不触发防腐机制
 - 副本与权威源不一致时，以权威源为准，下次同步强制覆盖
 

package/templates/skills/modus-init/shared/stack-detection.md

@@ -108,7 +108,7 @@ primaryStack: java                # 见 PrimaryStack 类型定义
 
 ## 5. Skill frontmatter 的 `stack` 字段
 
-每个生成的业务 Skill（`modus/knowledge/biz-*/SKILL.md`）必须在 frontmatter 中包含 `stack` 字段，与 `primaryStack` 保持一致：
+每个生成的业务 Skill（`modus/knowledge_base/domain/*/code/SKILL.md`）必须在 frontmatter 中包含 `stack` 字段，与 `primaryStack` 保持一致：
 
 ```yaml
 ---

package/templates/skills/modus-init/strategies/fallback-init.md

@@ -135,7 +135,7 @@ Step 14 完成回报必须包含：
    - 升级路径：
      1. 等 Modus 后续版本支持本栈（Phase 4：go-init / python-init）
      2. 通过 /modus:platform -add 反馈需求（含范式样例）
-     3. 手动编辑 modus/knowledge/biz-*/SKILL.md 补充内容，运行 /modus:verify 升级
+     3. 手动编辑 modus/knowledge_base/domain/*/code/SKILL.md 补充内容，运行 /modus:verify 升级
 ```
 
 ---