@modus-ai/modus 0.2.2 → 0.2.4

package/templates/skills/{modus-harness-agents/00-skills-builder → modus-agents/skill-creator}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: modus-harness-00-skills-builder
+name: modus-skill-creator
 description: Use this skill when building, updating, or extracting knowledge to/from Business Skill files. Called by /modus:init (Mode A: new), /modus:plan and /modus:spec pre/post update (Mode B/C), Harness ARCHIVE phase (Mode D), and baseline Skill initialization (Mode E). Trigger when any Modus workflow needs to create or refresh .codebuddy/skills/modus-biz-*/SKILL.md or knowledge-catalog.md.
 allowed-tools: Read, Write, Glob, Bash
 disable: false
 ---
 
-# modus-harness-00-skills-builder（Skills Builder SubAgent）
+# modus-skill-creator（Skill 创建与知识管理 SubAgent）
 
 **调用方：** `/modus:init` / `/modus:plan` 前置更新 / `/modus:spec` 前置更新 / Harness 后置更新 / Harness ARCHIVE 阶段  
 **输入：** 业务域信息 + 项目代码  
@@ -230,7 +230,7 @@ shasum -a 1 {key_files...} | awk '{print $1}' | sort | shasum -a 1 | awk '{print
 
 注释汇总统计（Step 1 完成后输出）：
   发现 TODO {N}条 | FIXME {M}条 | WARN/注意 {W}条 | HACK {H}条 | @deprecated {D}条
-  → TODO > 3 条时：触发知识空白标记，供 modus-init Step 3.5 访谈问卷生成使用
+  → TODO > 3 条时：触发知识空白标记，供 modus-init Step 4 访谈问卷生成使用
 ```
 
 ---
@@ -324,7 +324,7 @@ Step 2C-4：构建完整转换矩阵（含禁止转换，不允许留空）：
   | PAID    | COMPLETED | 确认收货 | completeOrder() | @Transactional | - |
   | COMPLETED | CANCELLED | - | - | - | ❌ 抛 InvalidTransitionException |
 
-  孤立状态（无入/出转换的枚举值）→ 标记为 ⚠️「孤立状态，触发 Step 3.5 访谈」
+  孤立状态（无入/出转换的枚举值）→ 标记为 ⚠️「孤立状态，触发 Step 4 访谈」
 ```
 
 #### 2D. 自定义校验器扫描
@@ -522,7 +522,7 @@ Step 2C-4：构建完整转换矩阵（含禁止转换，不允许留空）：
 1. **2A if/else 推断结果** → 将所有 `[invariant]` 标签条目写入本节，标注来源行号
 2. **2D 自定义校验器** → 将 isValid()/validate() 中的判断逻辑转为不变量条目
 3. **Step 1.4 代码注释挖掘** → 将 `//WARN / //注意 / //重要` 注释写入本节（标注来源）
-4. **Step 3.5 人工访谈回答** → 将用户补充的业务约束写入本节（标注 `[人工补充: {日期}]`）
+4. **Step 4 人工访谈回答** → 将用户补充的业务约束写入本节（标注 `[人工补充: {日期}]`）
 
 每条不变量必含：不变量描述、验证位置（类名:行号或方法名）、违反后果（异常类或错误码）、来源标注
 
@@ -537,7 +537,7 @@ Step 2C-4：构建完整转换矩阵（含禁止转换，不允许留空）：
 2. Domain/Entity 类的类级 Javadoc → 实体中文含义与边界说明
 3. Service/Manager 方法 Javadoc 中出现的业务专名词（如「结算」「对账」「预授权」「防重」）
 4. Step 1.4 代码注释中出现的业务术语（`// 注意：此处的"XX"指的是...` 类注释）
-5. Step 3.5 人工访谈中用户提及的专业术语（标注 `[人工补充]`）
+5. Step 4 人工访谈中用户提及的专业术语（标注 `[人工补充]`）
 
 每个术语必含：术语名、定义（1-2句）、与通用概念的区别（若无区别可省略）
 
@@ -737,7 +737,7 @@ last_verified_by: ""        # 最后 verified 确认人（运行 /modus:verify
 domain_confidence: 0        # 域置信度评分（0-10），来自 modus-init Step 2 评分矩阵
 invariant_count: 0          # Section 15 业务不变量条目数（由 Skills Builder 自动统计）
 glossary_size: 0            # Section 16 领域词汇表条目数（由 Skills Builder 自动统计）
-hidden_knowledge_rate: 0    # 隐性知识补全率（0-100），来自 modus-init Step 3.5 访谈问卷
+hidden_knowledge_rate: 0    # 隐性知识补全率（0-100），来自 modus-init Step 4 访谈问卷
 upstream_skills:            # 本 Skill 在 Section 10 中依赖的其他域 Skill（由 Step 4 双向同步维护）
   - modus-biz-payment
 downstream_skills:          # 依赖本域的其他 Skill（由被依赖方的 Step 4 双向同步维护）
@@ -907,7 +907,7 @@ stateDiagram-v2
 
 ## 15. 业务不变量 [invariant]
 
-（无条件生成。来源：2A if/else 推断 + 2D 自定义校验器 + Step 1.4 注释挖掘 + Step 3.5 人工访谈。）
+（无条件生成。来源：2A if/else 推断 + 2D 自定义校验器 + Step 1.4 注释挖掘 + Step 4 人工访谈。）
 
 | 不变量描述 | 验证位置 | 违反后果 | 来源 |
 |---------|---------|---------|------|
@@ -917,7 +917,7 @@ stateDiagram-v2
 
 ## 16. 领域词汇表 [model]
 
-（无条件生成。来源：枚举描述 + Javadoc + 代码注释 + Step 3.5 人工访谈。）
+（无条件生成。来源：枚举描述 + Javadoc + 代码注释 + Step 4 人工访谈。）
 
 | 术语 | 定义 | 与通用概念的区别 |
 |------|------|----------------|

package/templates/skills/{modus-harness-agents/03-test → modus-agents/tester}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: modus-harness-03-test
+name: modus-tester
 description: Use this skill when the Harness orchestrator needs to generate unit tests for code changes. Covers Happy Path, boundary conditions, exception paths, and concurrency scenarios. Generates 03-test-report.md. Triggered by modus-harness in parallel with SubAgents 04 and 05 after Gate A passes.
 allowed-tools: Read, Write, Glob, Bash
 disable: false
 ---
 
-# modus-harness-03-test（代码测试 SubAgent）
+# modus-tester（代码测试 SubAgent）
 
 **调用方：** Harness Orchestrator（与 04/05 并行启动）  
 **输入：** `02-sprint-contract.md` + 代码变更  

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

@@ -321,4 +321,4 @@ constitution: {constitution 字段内容}
 
 ### harness 模式调用方式
 
-由 SubAgent 01.5 独立执行（见 `modus-harness-agents/01-5-design/SKILL.md`），输入为 `01-analysis.md`，输出为 `01.5-design-brief.md` 含 HANDOFF 块。
+由 SubAgent 01.5 独立执行（见 `modus-agents/designer/SKILL.md`），输入为 `01-analysis.md`，输出为 `01.5-design-brief.md` 含 HANDOFF 块。

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

@@ -21,15 +21,15 @@ disable: false
 
 | ID | Skill 路径 | 职责 | 产出物 | 知识查询预算 |
 |----|-----------|------|--------|------------|
-| 00 | `modus-harness-00-skills-builder` | Skills 更新/知识提取 | Skill 文件 + catalog | 无限制 |
-| 01 | `modus-harness-01-analysis` | 需求分析 | `01-analysis.md` | ≤ 3 个 Skill 文件 |
-| 01.5 | `modus-harness-01-5-design` | 设计方案生成 | `01.5-design-brief.md` | ≤ 3 个 Skill 文件 |
-| 02 | `modus-harness-02-dev` | 代码开发 | `02-sprint-contract.md` | ≤ 5 个 Skill 文件 + ≤ 10 个代码文件 |
-| 03 | `modus-harness-03-test` | 代码测试 | `03-test-report.md` | ≤ 2 个 Skill 文件 |
-| 04 | `modus-harness-04-perf` | 性能审计 | `04-perf-report.md` | ≤ 2 个 Skill 文件 |
-| 05 | `modus-harness-05-security` | 安全审计 | `05-security-report.md` | ≤ 2 个 Skill 文件 |
-| 06 | `modus-harness-06-review` | 代码评审 | `cr-report.md` | ≤ 1 个团队约定 Skill |
-| 07 | `modus-harness-07-deploy` | 部署发布 | `07-deploy-status.md` | ≤ 1 个 Skill 文件 |
+| 00 | `modus-skill-creator` | Skills 更新/知识提取 | Skill 文件 + catalog | 无限制 |
+| 01 | `modus-analyst` | 需求分析 | `01-analysis.md` | ≤ 3 个 Skill 文件 |
+| 01.5 | `modus-designer` | 设计方案生成 | `01.5-design-brief.md` | ≤ 3 个 Skill 文件 |
+| 02 | `modus-developer` | 代码开发 | `02-sprint-contract.md` | ≤ 5 个 Skill 文件 + ≤ 10 个代码文件 |
+| 03 | `modus-tester` | 代码测试 | `03-test-report.md` | ≤ 2 个 Skill 文件 |
+| 04 | `modus-perf-auditor` | 性能审计 | `04-perf-report.md` | ≤ 2 个 Skill 文件 |
+| 05 | `modus-security-auditor` | 安全审计 | `05-security-report.md` | ≤ 2 个 Skill 文件 |
+| 06 | `modus-reviewer` | 代码评审 | `cr-report.md` | ≤ 1 个团队约定 Skill |
+| 07 | `modus-deployer` | 部署发布 | `07-deploy-status.md` | ≤ 1 个 Skill 文件 |
 
 **预算原则：** SubAgent 超出预算时，应优先读 maturity 更高的 Skill；若 catalog 中某 Skill 标注 `⚠️` 可能过时，优先读最新代码而非该 Skill。
 
@@ -240,13 +240,13 @@ feat: {业务摘要}
 
 | 如果发现自己在做… | 立即停止，转交给… |
 |----------------|----------------|
-| 修改任何业务代码 | SubAgent 02 |
-| 分析 TAPD 需求内容 | SubAgent 01 |
-| 生成设计方案或询问架构决策 | SubAgent 01.5 |
-| 对代码质量发表意见 | SubAgent 06 |
-| 执行测试或验证逻辑 | SubAgent 03/04/05 |
-| 操作部署流程 | SubAgent 07 |
-| 更新 Skill 文件 | SubAgent 00 |
+| 修改任何业务代码 | `modus-developer` |
+| 分析 TAPD 需求内容 | `modus-analyst` |
+| 生成设计方案或询问架构决策 | `modus-designer` |
+| 对代码质量发表意见 | `modus-reviewer` |
+| 执行测试或验证逻辑 | `modus-tester` / `modus-perf-auditor` / `modus-security-auditor` |
+| 操作部署流程 | `modus-deployer` |
+| 更新 Skill 文件 | `modus-skill-creator` |
 
 ---
 

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

@@ -92,9 +92,9 @@ disable: false
 
 ---
 
-### Step 2：项目扫描与业务分类（4 轮全量扫描）
+### Step 2：项目扫描与业务分类（5 轮全量扫描）
 
-启动一个「项目分析 SubAgent」，执行以下 **4 轮结构化扫描**（替代原有的简单目录读取）：
+启动一个「项目分析 SubAgent」，执行以下 **5 轮结构化扫描**（替代原有的简单目录读取）：
 
 #### 轮次 1：模块发现
 
@@ -272,7 +272,7 @@ disable: false
 请指定每个小包的处理方式（合并/独立/重命名）或回复「保持原样」：
 ```
 
-**严禁自动决策**：必须在一次交互中等待用户对「域归属确认 + 小包合并决策」全部回复后，才能进入 Step 3.5。
+**严禁自动决策**：必须在一次交互中等待用户对「域归属确认 + 小包合并决策」全部回复后，才能进入 Step 4。
 
 #### 3.2 大域反向拆分保护
 
@@ -297,9 +297,9 @@ disable: false
 
 ---
 
-### Step 3.5：结构化访谈问卷（隐性知识捕获）
+### Step 4：结构化访谈问卷（隐性知识捕获）
 
-**触发时机：** 用户确认域列表后、Step 4 启动前执行。
+**触发时机：** 用户确认域列表后、Step 5 启动前执行。
 
 **核心目的：** 代码扫描只能获得「显性结构知识」，此步骤通过动态生成的针对性问题，补全代码中无法推断的**隐性业务知识**（口口相传的规则、历史决策、业务背景）。
 
@@ -362,9 +362,9 @@ disable: false
 
 ---
 
-### Step 4：生成业务 Skill（Layer 2）—— 并行执行
+### Step 5：生成业务 Skill（Layer 2）—— 并行执行
 
-用户确认后，**同时**为每个业务域启动独立的「Skills Builder SubAgent」（`modus-harness-00-skills-builder` Skill，模式 A），并行生成所有业务 Skill 文件。各域之间完全独立，无需等待彼此完成。
+用户确认后，**同时**为每个业务域启动独立的「Skills Builder SubAgent」（`modus-skill-creator` Skill，模式 A），并行生成所有业务 Skill 文件。各域之间完全独立，无需等待彼此完成。
 
 **目标路径：** `.codebuddy/skills/modus-biz-{domain}/SKILL.md`
 
@@ -446,7 +446,7 @@ SubAgent-3 (user域)    ──► 扫描用户全量文件（含Enum/MQ/Config
   payment.downstream_skills = [order, refund]
 ```
 
-### Step 5：多平台同步（Business Skills）
+### Step 6：多平台同步（Business Skills）
 
 Business Skills 全部生成后，读取 `modus/config.yaml` 的 `platforms` 字段，将每个业务 Skill 同步到其他已选平台。
 
@@ -516,7 +516,7 @@ alwaysApply: false
 
 ---
 
-### Step 6：生成团队约定 Skill（Layer 0-T）
+### Step 7：生成团队约定 Skill（Layer 0-T）
 
 调用「Skills Builder SubAgent」（模式 E：团队约定初始化）：
 
@@ -541,7 +541,7 @@ alwaysApply: false
 > 原始文件保持不变，Modus 仅在此处做统一索引。
 ```
 
-### Step 7：生成技术知识 Skill（Layer 1）
+### Step 8：生成技术知识 Skill（Layer 1）
 
 调用「Skills Builder SubAgent」（模式 E：技术知识初始化），初始化技术知识骨架：
 
@@ -554,7 +554,7 @@ alwaysApply: false
 2. 从构建文件提取的技术栈（`pom.xml` → Spring Boot 版本、`package.json` → 框架版本等）
 3. 占位符章节（反模式库、架构决策、跨项目经验——待后续工作流积累）
 
-### Step 8：生成知识全景目录（knowledge-catalog.md）
+### Step 9：生成知识全景目录（knowledge-catalog.md）
 
 在 `modus/knowledge-catalog.md` 创建全景索引，使用升级后的条目格式：
 
@@ -599,7 +599,7 @@ Skill status 生命周期（统一使用 status 字段）：
 - stale   + 超过 stale_after_days → archived（需人工二次确认）
 ```
 
-### Step 9：初始化 modus/config.yaml（若不存在）
+### Step 10：初始化 modus/config.yaml（若不存在）
 
 若项目尚无 `modus/config.yaml`，生成默认配置：
 
@@ -626,7 +626,7 @@ constitution:
 
 提示用户填写 `constitution` 字段，以便后续命令无需重复说明项目约束。
 
-### Step 10：完成回报
+### Step 11：完成回报
 
 所有业务 Skill 生成完毕后，回复用户：
 
@@ -716,25 +716,54 @@ constitution:
 
 ---
 
-### Step 4 补充：生成 Business Skill 时必须填写 key_files 和质量评分字段
-
-在生成每个业务 Skill（`.codebuddy/skills/modus-biz-{domain}/SKILL.md`）时，**必须**在 frontmatter 中填写以下字段：
-
-**key_files 填写规则：**
+### Step 5 补充：生成 Business Skill 时必须填写完整 frontmatter（防腐机制核心）
+
+在生成每个业务 Skill（`.codebuddy/skills/modus-biz-{domain}/SKILL.md`）时，**必须**在 frontmatter 中填写以下**完整字段清单**。这些字段是知识防腐机制的核心，缺一不可：
+
+#### 一、基础元数据字段（必填）
+- `name`: Skill 唯一标识符（与目录名一致）
+- `description`: 一句话描述，必须包含 `[MODUS:BIZ]` 标记
+- `version`: 语义化版本号（初始 1.0.0）
+- `updated`: 最后更新日期（YYYY-MM-DD）
+- `status`: 成熟度状态（初始 draft）
+- `format_version`: 节结构版本（当前 v3）
+- `stale_after_days`: 过期天数阈值（默认 90）
+
+#### 二、防腐机制核心字段（必填，缺少则无法检测代码变更）
+- **`last_referenced`**: 最后引用时间（初始值 = `updated` 日期）
+  - 用途：计算知识衰减，超过 `stale_after_days` 自动降级
+- **`usage_count`**: 使用次数（初始值 = 0）
+  - 用途：成熟度升级判定（draft→verified→proven）
+- **`last_hash`**: key_files 内容 SHA-1 哈希值（初始值 = ""，留空）
+  - 用途：检测代码变更，触发 Skill 更新
+  - 计算时机：首次被 plan/spec/harness 引用时自动计算并写入
+- **`last_verified_by`**: 最后确认人（初始值 = ""，留空）
+  - 用途：记录人工验证信息，升为 verified 时填写
+
+#### 三、key_files 填写规则（最多 20 个，用于 hash 检测）
 - 上限 **20 个**文件（覆盖全部 10 类文件类型）
 - 按以下优先级选取（满 20 个时从后往前截断）：
-  - 优先级 1（必选）：Service、Manager、Mapper/DAO、Domain/Entity
-  - 优先级 2（强烈建议）：Enum/Constant（状态/类型枚举）、Exception/ErrorCode
-  - 优先级 3（有则加入）：MQ Consumer/Producer、@Configuration
-- 这些文件将用于后续 plan/spec/harness 的「前置 Skill 更新 hash 检查」
-- `last_hash` 初始留空（`""`），下次 plan/spec/harness 触发前置更新时自动计算并填入
+  - **优先级 1（必选）**：Service、Manager、Mapper/DAO、Domain/Entity
+  - **优先级 2（强烈建议）**：Enum/Constant（状态/类型枚举）、Exception/ErrorCode
+  - **优先级 3（有则加入）**：MQ Consumer/Producer、@Configuration
+- 这些文件的内容拼接后计算 SHA-1 得到 `last_hash`
 - 确保 Enum/MQ/ErrorCode/Config 的变化能被 hash 检查感知
 
-**质量评分字段（新增，必须填写）：**
-- `domain_confidence`: 本域的置信度评分（0-10），来自 Step 2 置信度评分矩阵
-- `invariant_count`: 生成的业务不变量条目数（Section 15）
-- `glossary_size`: 领域词汇表条目数（Section 16）
-- `hidden_knowledge_rate`: 隐性知识补全率（已回答问卷数 / 总问卷数，0-100）
+#### 四、质量评分字段（必填，用于知识库质量报告）
+- **`domain_confidence`**: 本域的置信度评分（0-10），来自 Step 2 置信度评分矩阵
+- **`invariant_count`**: 生成的业务不变量条目数（Section 15）
+- **`glossary_size`**: 领域词汇表条目数（Section 16）
+- **`hidden_knowledge_rate`**: 隐性知识补全率（0-100，来自 Step 4 访谈问卷）
+
+#### 五、跨域依赖字段（由 Section 10 回写阶段自动填入）
+- **`upstream_skills`**: 本域依赖的其他域 Skill 列表
+- **`downstream_skills`**: 依赖本域的其他域 Skill 列表
+
+**重要提示：** 如果 frontmatter 缺少上述任一防腐字段（特别是 `last_referenced`、`usage_count`、`last_hash`、`key_files`），将导致：
+- 无法自动检测代码变更
+- 无法触发 Skill 更新
+- 无法计算知识衰减
+- 防腐机制完全失效
 
 ---
 
@@ -756,7 +785,7 @@ last_verified_by: ""        # 最后确认人（升为 verified 时填写）
 domain_confidence: 0        # 域置信度评分（0-10），来自 Step 2 评分矩阵
 invariant_count: 0          # Section 15 业务不变量条目数
 glossary_size: 0            # Section 16 领域词汇表条目数
-hidden_knowledge_rate: 0    # 隐性知识补全率（0-100），来自 Step 3.5 访谈问卷
+hidden_knowledge_rate: 0    # 隐性知识补全率（0-100），来自 Step 4 访谈问卷
 upstream_skills:            # 本 Skill 在 Section 10 中依赖的其他域 Skill
   - modus-biz-payment
   - modus-biz-user

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

@@ -149,7 +149,7 @@ shasum -a 1 {file1} {file2} ... | awk '{print $1}' | sort | shasum -a 1 | awk '{
 
 #### 4-4：完整前置更新（仅在 hash 不匹配时执行）
 
-启动「Skill 更新 SubAgent」（`modus-harness-00-skills-builder` 模式 B），执行：
+启动「Skill 更新 SubAgent」（`modus-skill-creator` 模式 B），执行：
 
 1. **Level 2 加载**：读取完整 SKILL.md 文件
 2. 扫描该域相关的最新代码文件（近期变更的文件）

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

@@ -126,7 +126,7 @@ shasum -a 1 {file1} {file2} ... | awk '{print $1}' | sort | shasum -a 1 | awk '{
 
 #### Step 4d：完整前置更新（仅在 hash 不匹配时执行）
 
-调用 `modus-harness-00-skills-builder` 模式 B，执行：
+调用 `modus-skill-creator` 模式 B，执行：
 
 1. **Level 2 加载**：读取完整 SKILL.md 文件
 2. 扫描该域相关的最新代码文件（近期变更的文件）
@@ -373,7 +373,7 @@ grep -l "### Requirement:" modus/specs/{domain}/spec.md 2>/dev/null
 
 ### Step 8：后置 Skill 更新（知识提取与回写）
 
-归档完成后，调用 `modus-harness-00-skills-builder` 模式 C，从 delta specs 中系统性提取知识：
+归档完成后，调用 `modus-skill-creator` 模式 C，从 delta specs 中系统性提取知识：
 
 1. `## ADDED Requirements` 中的新业务流程 → `[process]` 追加到业务 Skill
 2. 新增实体/字段/枚举 → `[model]` 追加到业务 Skill