@modus-ai/modus 0.2.2 → 0.2.4

package/dist/generators/cursor.js

@@ -1,70 +1,51 @@
 import path from 'node:path';
 import { writeFile, readTemplate, fileExists, readFile } from '../utils/file-system.js';
+const SKILLS_BASE = path.join('.cursor', 'skills');
 const RULES_BASE = path.join('.cursor', 'rules');
 const MCP_PATH = path.join('.cursor', 'mcp.json');
 // ---------------------------------------------------------------------------
-// Framework Skills → individual .mdc rules
-// ---------------------------------------------------------------------------
-const SKILL_RULES = [
-    {
-        id: 'modus-init',
-        templatePath: 'skills/modus-init/SKILL.md',
-        description: 'Run /modus:init to scan the codebase and build Business Skills for each domain',
-    },
-    {
-        id: 'modus-vibe',
-        templatePath: 'skills/modus-vibe/SKILL.md',
-        description: 'Run /modus:vibe to start context-aware vibe coding with business Skill preloading',
-    },
-    {
-        id: 'modus-plan',
-        templatePath: 'skills/modus-plan/SKILL.md',
-        description: 'Run /modus:plan to create structured feature proposals with complexity grading',
-    },
-    {
-        id: 'modus-spec',
-        templatePath: 'skills/modus-spec/SKILL.md',
-        description: 'Run /modus:spec for OpenSpec-driven development with delta specs and GIVEN/WHEN/THEN scenarios',
-    },
-    {
-        id: 'modus-auto',
-        templatePath: 'skills/modus-auto/SKILL.md',
-        description: 'Run /modus:auto with a TAPD story URL to get AI-recommended mode (vibe/plan/spec/harness)',
-    },
-    {
-        id: 'modus-harness',
-        templatePath: 'skills/modus-harness/SKILL.md',
-        description: 'Run /modus:harness to execute the full dual-loop multi-agent development pipeline',
-    },
+// Framework command skills → .cursor/skills/modus-{cmd}/SKILL.md
+// ---------------------------------------------------------------------------
+const COMMAND_SKILLS = [
+    { id: 'modus-init', templatePath: 'skills/modus-init/SKILL.md' },
+    { id: 'modus-vibe', templatePath: 'skills/modus-vibe/SKILL.md' },
+    { id: 'modus-plan', templatePath: 'skills/modus-plan/SKILL.md' },
+    { id: 'modus-spec', templatePath: 'skills/modus-spec/SKILL.md' },
+    { id: 'modus-auto', templatePath: 'skills/modus-auto/SKILL.md' },
+    { id: 'modus-harness', templatePath: 'skills/modus-harness/SKILL.md' },
 ];
-// Harness sub-agent templates to merge into the single harness rule
-const HARNESS_SUB_AGENT_TEMPLATES = [
-    { id: '00-skills-builder', templatePath: 'skills/modus-harness-agents/00-skills-builder/SKILL.md' },
-    { id: '01-analysis', templatePath: 'skills/modus-harness-agents/01-analysis/SKILL.md' },
-    { id: '02-dev', templatePath: 'skills/modus-harness-agents/02-dev/SKILL.md' },
-    { id: '03-test', templatePath: 'skills/modus-harness-agents/03-test/SKILL.md' },
-    { id: '04-perf', templatePath: 'skills/modus-harness-agents/04-perf/SKILL.md' },
-    { id: '05-security', templatePath: 'skills/modus-harness-agents/05-security/SKILL.md' },
-    { id: '06-review', templatePath: 'skills/modus-harness-agents/06-review/SKILL.md' },
-    { id: '07-deploy', templatePath: 'skills/modus-harness-agents/07-deploy/SKILL.md' },
+// ---------------------------------------------------------------------------
+// Harness SubAgent skills → .cursor/skills/modus-harness-{id}/SKILL.md
+// Cursor uses the Task tool for real parallel SubAgent dispatching.
+// ---------------------------------------------------------------------------
+const HARNESS_AGENT_SKILLS = [
+    { id: 'modus-skill-creator', templatePath: 'skills/modus-agents/skill-creator/SKILL.md' },
+    { id: 'modus-analyst', templatePath: 'skills/modus-agents/analyst/SKILL.md' },
+    { id: 'modus-designer', templatePath: 'skills/modus-agents/designer/SKILL.md' },
+    { id: 'modus-developer', templatePath: 'skills/modus-agents/developer/SKILL.md' },
+    { id: 'modus-tester', templatePath: 'skills/modus-agents/tester/SKILL.md' },
+    { id: 'modus-perf-auditor', templatePath: 'skills/modus-agents/perf-auditor/SKILL.md' },
+    { id: 'modus-security-auditor', templatePath: 'skills/modus-agents/security-auditor/SKILL.md' },
+    { id: 'modus-reviewer', templatePath: 'skills/modus-agents/reviewer/SKILL.md' },
+    { id: 'modus-deployer', templatePath: 'skills/modus-agents/deployer/SKILL.md' },
 ];
 // ---------------------------------------------------------------------------
 // Main entry
 // ---------------------------------------------------------------------------
 export function generateCursorFiles(projectRoot, config, _opts = {}) {
-    generateCursorSkillRules(projectRoot, config);
-    generateCursorHarnessRule(projectRoot);
+    generateCursorCommandSkills(projectRoot, config);
+    generateCursorHarnessAgentSkills(projectRoot);
     generateCursorConstitution(projectRoot, config);
     generateCursorAutoVibe(projectRoot);
     generateCursorMcp(projectRoot, config);
 }
 // ---------------------------------------------------------------------------
-// Individual skill rules
+// Command skills → .cursor/skills/modus-{cmd}/SKILL.md
+// These are loaded by Cursor when the user types /modus:* commands.
 // ---------------------------------------------------------------------------
-function generateCursorSkillRules(projectRoot, config) {
+function generateCursorCommandSkills(projectRoot, config) {
     const enabled = new Set(config.commands.enabled);
-    for (const skill of SKILL_RULES) {
-        // Only generate command-backed skills if the command is enabled
+    for (const skill of COMMAND_SKILLS) {
         const cmdId = skill.id.replace('modus-', '');
         if (['init', 'vibe', 'plan', 'spec', 'auto', 'harness'].includes(cmdId) && !enabled.has(cmdId)) {
             continue;
@@ -76,25 +57,18 @@ function generateCursorSkillRules(projectRoot, config) {
         catch {
             continue;
         }
-        const content = buildMdcFile(skill.description, false, body);
-        writeFile(path.join(projectRoot, RULES_BASE, `${skill.id}.mdc`), content);
+        const destPath = path.join(projectRoot, SKILLS_BASE, skill.id, 'SKILL.md');
+        writeFile(destPath, body);
     }
 }
 // ---------------------------------------------------------------------------
-// Harness rule — single-agent degradation
+// Harness SubAgent skills → .cursor/skills/modus-harness-{id}/SKILL.md
+// The Harness orchestrator uses Cursor's Task tool to dispatch these agents
+// in parallel (SA03/04/05) or sequentially (SA01 → SA02 → SA06 → SA07).
+// No single-agent degradation — full dual-loop multi-agent mode is supported.
 // ---------------------------------------------------------------------------
-function generateCursorHarnessRule(projectRoot) {
-    const sections = [
-        '# Modus Harness — Single-Agent Mode',
-        '',
-        '> **Note:** Cursor does not support native Sub-Agents. The Harness pipeline runs in',
-        '> single-agent mode: the orchestrator executes each step sequentially within one context.',
-        '> For full parallel Sub-Agent support, use CodeBuddy or Claude Code.',
-        '',
-        '## Pipeline Steps (sequential)',
-        '',
-    ];
-    for (const agent of HARNESS_SUB_AGENT_TEMPLATES) {
+function generateCursorHarnessAgentSkills(projectRoot) {
+    for (const agent of HARNESS_AGENT_SKILLS) {
         let body;
         try {
             body = readTemplate(agent.templatePath);
@@ -102,13 +76,13 @@ function generateCursorHarnessRule(projectRoot) {
         catch {
             continue;
         }
-        sections.push(`### Step ${agent.id}`, '', body, '', '---', '');
+        const destPath = path.join(projectRoot, SKILLS_BASE, agent.id, 'SKILL.md');
+        writeFile(destPath, body);
     }
-    const content = buildMdcFile('Modus Harness orchestration steps (single-agent mode for Cursor)', false, sections.join('\n'));
-    writeFile(path.join(projectRoot, RULES_BASE, 'modus-harness-agents.mdc'), content);
 }
 // ---------------------------------------------------------------------------
-// Constitution rule
+// Constitution rule — alwaysApply: true
+// Injects project hard rules into every Cursor conversation.
 // ---------------------------------------------------------------------------
 function generateCursorConstitution(projectRoot, config) {
     const any = config;
@@ -147,7 +121,8 @@ function generateCursorConstitution(projectRoot, config) {
     writeFile(path.join(projectRoot, RULES_BASE, 'modus-constitution.mdc'), content);
 }
 // ---------------------------------------------------------------------------
-// Auto-vibe — always-on rule that activates vibe behavior automatically
+// Auto-vibe rule — alwaysApply: true
+// Loads business context automatically at the start of each conversation.
 // ---------------------------------------------------------------------------
 function generateCursorAutoVibe(projectRoot) {
     const body = [
@@ -211,7 +186,8 @@ function buildMdcFile(description, alwaysApply, body) {
 // ---------------------------------------------------------------------------
 /**
  * Sync a single business Skill to Cursor format.
- * Creates a rule at .cursor/rules/modus-biz-{domain}.mdc
+ * Business Skills are stored as rules (.cursor/rules/modus-biz-{domain}.mdc)
+ * so they can be injected as context when the relevant domain is active.
  */
 export function syncBizSkillToCursor(projectRoot, domain, skillContent) {
     const content = buildMdcFile(`Business rules and conventions for the ${domain} domain`, false, skillContent);

package/dist/generators/cursor.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/generators/cursor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/generators/cursor.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modus-ai/modus",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Modus — Business-grounded AI coding accelerator for CodeBuddy IDE",
   "keywords": [
     "ai",

package/schemas/harness-schema.yaml

@@ -5,14 +5,14 @@ description: 双 Loop 多智能体 Harness — 全自动需求分析、开发、
 
 subAgents:
   - id: "01"
-    skill: modus-harness-01-analysis
+    skill: modus-analyst
     name: 需求分析
     generates: 01-analysis.md
     requires: []
     loop: 1
 
   - id: "02"
-    skill: modus-harness-02-dev
+    skill: modus-developer
     name: 代码开发
     generates: 02-sprint-contract.md
     requires: ["01"]
@@ -20,7 +20,7 @@ subAgents:
     gateAfter: compile  # Gate A: 编译验证
 
   - id: "03"
-    skill: modus-harness-03-test
+    skill: modus-tester
     name: 代码测试
     generates: 03-test-report.md
     requires: ["02"]
@@ -28,7 +28,7 @@ subAgents:
     parallel: ["03", "04", "05"]  # 与 04/05 并行
 
   - id: "04"
-    skill: modus-harness-04-perf
+    skill: modus-perf-auditor
     name: 性能审计
     generates: 04-perf-report.md
     requires: ["02"]
@@ -36,7 +36,7 @@ subAgents:
     parallel: ["03", "04", "05"]
 
   - id: "05"
-    skill: modus-harness-05-security
+    skill: modus-security-auditor
     name: 安全审计
     generates: 05-security-report.md
     requires: ["02"]
@@ -44,14 +44,14 @@ subAgents:
     parallel: ["03", "04", "05"]
 
   - id: "06"
-    skill: modus-harness-06-review
+    skill: modus-reviewer
     name: 代码评审
     generates: cr-report.md
     requires: ["03", "04", "05"]  # Gate B: 等待 03/04/05 全部完成
     loop: 2
 
   - id: "07"
-    skill: modus-harness-07-deploy
+    skill: modus-deployer
     name: 部署发布
     generates: 07-deploy-status.md
     requires: ["06"]

package/schemas/knowledge-schema.yaml

@@ -69,6 +69,18 @@ skill_frontmatter:
       type: date
       required: true
       description: 最近一次被工作流引用的日期，用于衰减计算
+      
+    - name: last_hash
+      type: string
+      required: true
+      description: key_files 内容的 SHA-1 哈希值，用于检测代码变更。初始值为空字符串，首次使用时自动计算
+      default: ""
+      
+    - name: key_files
+      type: list
+      required: true
+      description: 关键源文件路径列表（最多20个），用于计算 last_hash。按优先级选取：Service/Manager/Mapper/Entity（必选），Enum/Exception（强烈建议），MQ/Config（有则加入）
+      default: []
 
     - name: usage_count
       type: integer

package/templates/agents/{modus-harness-01-analysis.md → modus-analyst.md}

@@ -1,5 +1,5 @@
 ---
-name: modus-harness-01-analysis
+name: modus-analyst
 description: Use this agent when the Harness orchestrator needs to perform requirements analysis for a TAPD Story. Fetches the story content, identifies affected business domains and code files at method level, assesses risk level, and produces 01-analysis.md with a machine-readable HANDOFF block. Triggered as the first sequential step in Harness Loop 1 after knowledge injection.
 agentMode: agentic
 tools: Read, Write, Glob, WebFetch
@@ -7,7 +7,7 @@ enabledAutoRun: true
 enabled: true
 ---
 
-读取并严格遵循 `.codebuddy/skills/modus-harness-01-analysis/SKILL.md` 中的执行规范。
+读取并严格遵循 `.codebuddy/skills/modus-analyst/SKILL.md` 中的执行规范。
 
 产出物路径：`modus/plans/active/{story-id}/01-analysis.md`
 

package/templates/agents/{modus-harness-07-deploy.md → modus-deployer.md}

@@ -1,5 +1,5 @@
 ---
-name: modus-harness-07-deploy
+name: modus-deployer
 description: Use this agent when the Harness orchestrator needs to verify deployment after Gate C passes (cr-report has no P1/P2 issues). Monitors CI/CD pipeline status, validates service health across environments (dev→uat→pre→prd), executes smoke tests on P0 interfaces, monitors ERROR log volume for 30 minutes post-deployment, and produces 07-deploy-status.md. prd environment requires manual confirmation.
 agentMode: agentic
 tools: Read, Write, Glob, Bash, WebFetch
@@ -7,7 +7,7 @@ enabledAutoRun: false
 enabled: true
 ---
 
-读取并严格遵循 `.codebuddy/skills/modus-harness-07-deploy/SKILL.md` 中的执行规范。
+读取并严格遵循 `.codebuddy/skills/modus-deployer/SKILL.md` 中的执行规范。
 
 输入依赖：`cr-report.md`（HANDOFF.gate_status = passed）+ `02-sprint-contract.md`。
 

package/templates/agents/{modus-harness-01-5-design.md → modus-designer.md}

@@ -1,10 +1,10 @@
-# modus-harness-01-5-design
+# modus-designer
 
-SubAgent 01.5 — 设计方案生成。
+SubAgent — 技术方案设计。
 
 ## Instructions
 
-Read and follow the skill at `.codebuddy/skills/modus-harness-agents/01-5-design/SKILL.md` to execute this SubAgent.
+Read and follow the skill at `.codebuddy/skills/modus-designer/SKILL.md` to execute this SubAgent.
 
 ## Quick Summary
 

package/templates/agents/{modus-harness-02-dev.md → modus-developer.md}

@@ -1,5 +1,5 @@
 ---
-name: modus-harness-02-dev
+name: modus-developer
 description: Use this agent when the Harness orchestrator needs to implement code based on 01-analysis.md. Implements changes layer by layer (data → service → orchestration → interface), runs build compilation as Gate A check, and produces 02-sprint-contract.md. Also triggered during Loop 2 re-entry to fix P1/P2 issues identified in cr-report.md.
 agentMode: agentic
 tools: Read, Write, Glob, Bash
@@ -7,7 +7,7 @@ enabledAutoRun: true
 enabled: true
 ---
 
-读取并严格遵循 `.codebuddy/skills/modus-harness-02-dev/SKILL.md` 中的执行规范。
+读取并严格遵循 `.codebuddy/skills/modus-developer/SKILL.md` 中的执行规范。
 
 输入依赖：`modus/plans/active/{story-id}/01-analysis.md` 的 HANDOFF 块 + 相关业务 Skill 内容（由 Orchestrator 传入）。
 

package/templates/agents/{modus-harness-04-perf.md → modus-perf-auditor.md}

@@ -1,5 +1,5 @@
 ---
-name: modus-harness-04-perf
+name: modus-perf-auditor
 description: Use this agent when the Harness orchestrator needs to perform static performance audit on code changes after Gate A passes. Detects N+1 queries (DB calls inside loops), missing batch operations, unbounded large data fetches without pagination protection, ES queries missing fetchSource/trackTotalHits, and deep pagination risks. Runs in parallel with SubAgents 03 and 05.
 agentMode: agentic
 tools: Read, Write, Glob
@@ -7,7 +7,7 @@ enabledAutoRun: true
 enabled: true
 ---
 
-读取并严格遵循 `.codebuddy/skills/modus-harness-04-perf/SKILL.md` 中的执行规范。
+读取并严格遵循 `.codebuddy/skills/modus-perf-auditor/SKILL.md` 中的执行规范。
 
 输入依赖：`modus/plans/active/{story-id}/02-sprint-contract.md` 的 HANDOFF 块 + 代码变更文件。
 

package/templates/agents/{modus-harness-06-review.md → modus-reviewer.md}

@@ -1,5 +1,5 @@
 ---
-name: modus-harness-06-review
+name: modus-reviewer
 description: Use this agent when the Harness orchestrator needs comprehensive code review after all audit reports are ready (Gate B passed). Reviews all artifacts (01-analysis.md through 05-security-report.md) plus actual code changes, grades issues as P1/P2/P3, and produces cr-report.md. If P1/P2 issues exist, orchestrator triggers Loop 2 re-entry into SubAgent 02.
 agentMode: agentic
 tools: Read, Write, Glob
@@ -7,7 +7,7 @@ enabledAutoRun: true
 enabled: true
 ---
 
-读取并严格遵循 `.codebuddy/skills/modus-harness-06-review/SKILL.md` 中的执行规范。
+读取并严格遵循 `.codebuddy/skills/modus-reviewer/SKILL.md` 中的执行规范。
 
 输入依赖：全部产出物（01-analysis.md 至 05-security-report.md）的 HANDOFF 块 + 代码变更。
 

package/templates/agents/{modus-harness-05-security.md → modus-security-auditor.md}

@@ -1,5 +1,5 @@
 ---
-name: modus-harness-05-security
+name: modus-security-auditor
 description: Use this agent when the Harness orchestrator needs to perform security audit on code changes after Gate A passes. Checks multi-tenant data isolation (tenantId source), missing @UserAuthorization on Facade layer, sensitive data logging (bank card/ID/phone), SQL injection via ${} concatenation, and bypass interfaces lacking tenantId protection. Runs in parallel with SubAgents 03 and 04.
 agentMode: agentic
 tools: Read, Write, Glob
@@ -7,7 +7,7 @@ enabledAutoRun: true
 enabled: true
 ---
 
-读取并严格遵循 `.codebuddy/skills/modus-harness-05-security/SKILL.md` 中的执行规范。
+读取并严格遵循 `.codebuddy/skills/modus-security-auditor/SKILL.md` 中的执行规范。
 
 输入依赖：`modus/plans/active/{story-id}/02-sprint-contract.md` 的 HANDOFF 块 + 代码变更文件。
 

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

@@ -1,5 +1,5 @@
 ---
-name: modus-harness-00-skills-builder
+name: modus-skill-creator
 description: Use this agent when any Modus workflow needs to create, update, or extract knowledge to/from Business Skill files. Examples: - Harness orchestrator calls this during INIT phase to refresh business Skills before analysis. - /modus:plan calls this for pre/post Skill update. - /modus:init calls this to generate initial Business Skill files from codebase scan. - Harness ARCHIVE phase calls this to extract decision/guideline/pitfall from artifacts into Skills.
 agentMode: agentic
 tools: Read, Write, Glob, Bash
@@ -7,6 +7,6 @@ enabledAutoRun: true
 enabled: true
 ---
 
-读取并严格遵循 `.codebuddy/skills/modus-harness-00-skills-builder/SKILL.md` 中的执行规范和五种工作模式（A: 新建 Skill / B: 增量更新 / C: 知识回写 / D: Harness 归档提取 / E: 基础 Skill 初始化）。
+读取并严格遵循 `.codebuddy/skills/modus-skill-creator/SKILL.md` 中的执行规范和五种工作模式（A: 新建 Skill / B: 增量更新 / C: 知识回写 / D: Harness 归档提取 / E: 基础 Skill 初始化）。
 
 调用方必须在 prompt 中明确指定工作模式（A/B/C/D/E）和目标业务域列表。

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

@@ -1,5 +1,5 @@
 ---
-name: modus-harness-03-test
+name: modus-tester
 description: Use this agent when the Harness orchestrator needs to generate unit tests for code changes after Gate A passes. Covers Happy Path, boundary conditions (null/empty/max), exception paths (lock failure, transaction rollback, auth check), and concurrency scenarios using @MockBean to isolate dependencies. Runs in parallel with SubAgents 04 and 05.
 agentMode: agentic
 tools: Read, Write, Glob, Bash
@@ -7,7 +7,7 @@ enabledAutoRun: true
 enabled: true
 ---
 
-读取并严格遵循 `.codebuddy/skills/modus-harness-03-test/SKILL.md` 中的执行规范。
+读取并严格遵循 `.codebuddy/skills/modus-tester/SKILL.md` 中的执行规范。
 
 输入依赖：`modus/plans/active/{story-id}/02-sprint-contract.md` 的 HANDOFF 块 + 代码变更文件。
 

package/templates/commands/vibe.md

@@ -1,6 +1,6 @@
 # /modus:vibe
 
-Context-aware vibe coding. Load relevant business Skills before coding so AI works as a knowledgeable project member.
+Context-aware vibe coding. Intelligently loads relevant business Skills, auto-syncs stale knowledge, and applies rule-driven clarification before coding so AI works as a knowledgeable project member.
 
 ## Instructions
 
@@ -8,11 +8,15 @@ Read and follow the skill at `.codebuddy/skills/modus-vibe/SKILL.md` to execute
 
 ## Quick Summary
 
-1. Check if `.codebuddy/skills/modus-biz-*` directories exist
-   - If not: offer to run `/modus:init` or continue in degraded mode
-2. Match user's prompt to relevant business domains
-3. Confirm domain selection with user
-4. Load the selected Skill files as context
-5. Execute the coding task with business context
+1. Read `modus/config.yaml` for hard constraints (constitution)
+2. Load `modus/knowledge-catalog.md` (Level 1, ~200 tokens)
+3. **Smart Analysis Engine**: auto-match domains (confidence ≥ 85% → auto-confirm, no user input needed), assess task complexity (Simple / Medium / Complex), detect ambiguity
+4. **Conditional Skill Pre-sync** (silent): check if matched Skills are stale via hash; update if needed; show one-line status `[已同步 {domain} 域知识]`
+5. **Rule-driven AskUserQuestion**: check 5 ambiguity rules (R1–R5); skip entirely for clear tasks; ask at most 2 questions when rules are hit
+6. Load matched Skill files as context (Level 2, ~3000 tokens each)
+7. **Adaptive Design Brief**: Simple tasks → 3-section inline brief; Medium/Complex → full 9-section brief
+8. Execute the coding task with business context (Level 3 on-demand file reads)
+9. **Auto Skill write-back** (silent): if new knowledge discovered, call skill-creator Mode C to persist; show one-line `[已更新 {domain} 域知识: ...]`; if nothing new, stay silent
+10. Append session log to `modus/sessions/vibe-log.md`
 
-**Degraded mode** (no business Skills): proceed without domain context, but note that code quality may be lower without project-specific knowledge.
+**Degraded mode** (no business Skills): proceed without domain context, note quality may be lower, show `[降级模式：无业务上下文，建议先运行 /modus:init]`.

package/templates/knowledge-catalog.md

@@ -24,3 +24,30 @@ updated: {YYYY-MM-DD}
   Level 3（按需，无上限）: 执行任务时读 Skill 引用的实际代码文件
 
 目标：不相关的 Skill 不加载，大幅降低 token 消耗。
+
+## Skill 状态生命周期
+
+### 成熟度状态（基于 usage_count）
+- **draft**    → 初始生成，未经验证（usage_count = 0）
+- **verified** → 经至少1次真实使用验证（usage_count ≥ 1，运行 `/modus:verify` 升级）
+- **proven**   → 经≥2个不同工作流验证有效（usage_count ≥ 2）
+- **stale**    → last_hash 不匹配或距 last_referenced 超过 stale_after_days，需更新（禁止直接引用）
+- **archived** → 域已废弃，不再维护
+
+### 衰减规则（基于 last_referenced）
+- proven  + 距 last_referenced 超过 12 个月 → verified
+- verified + 距 last_referenced 超过 6 个月 → stale
+- stale   + 距 last_referenced 超过 stale_after_days → archived（需人工二次确认）
+
+### 防腐机制核心字段
+每个 Skill frontmatter 必须包含以下字段，缺一不可：
+- **last_referenced**: 最后引用时间（用于衰减计算）
+- **usage_count**: 使用次数（用于成熟度升级）
+- **last_hash**: key_files 内容 SHA-1 哈希（用于检测代码变更，初始留空）
+- **key_files**: 关键源文件列表（最多20个，用于 hash 计算）
+
+缺少任一防腐字段将导致：
+- 无法自动检测代码变更
+- 无法触发 Skill 更新
+- 无法计算知识衰减
+- 防腐机制完全失效

package/templates/skills/{modus-harness-agents/01-analysis → modus-agents/analyst}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: modus-harness-01-analysis
+name: modus-analyst
 description: Use this skill when the Harness orchestrator needs to perform TAPD Story requirements analysis. Reads the TAPD story, extracts business intent, identifies affected code scope at method level, and generates 01-analysis.md with HANDOFF block. Triggered automatically by modus-harness orchestrator as the first step in Loop 1.
 allowed-tools: Read, Write, Glob, WebFetch
 disable: false
 ---
 
-# modus-harness-01-analysis（需求分析 SubAgent）
+# modus-analyst（需求分析 SubAgent）
 
 **调用方：** Harness Orchestrator（`modus-harness`）  
 **输入：** TAPD Story URL + 相关业务 Skill 内容  

package/templates/skills/{modus-harness-agents/07-deploy → modus-agents/deployer}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: modus-harness-07-deploy
+name: modus-deployer
 description: Use this skill when the Harness orchestrator needs to verify deployment after code review passes (no P1/P2 issues). Monitors CI/CD pipeline status, validates service health across environments (dev→uat→pre→prd), runs smoke tests on P0 interfaces, and generates 07-deploy-status.md. Triggered by modus-harness after Gate C passes.
 allowed-tools: Read, Write, Glob, Bash, WebFetch
 disable: false
 ---
 
-# modus-harness-07-deploy（部署发布 SubAgent）
+# modus-deployer（部署发布 SubAgent）
 
 **调用方：** Harness Orchestrator（Gate C 通过后触发）  
 **输入：** `cr-report.md`（无 P1/P2）+ `02-sprint-contract.md`  

package/templates/skills/{modus-harness-agents/01-5-design → modus-agents/designer}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: modus-harness-01-5-design
+name: modus-designer
 description: Use this skill when the Harness orchestrator needs to generate a design-brief between requirements analysis (01-analysis.md) and code development (02-dev). Reads 01-analysis.md and business Skills, asks architecture clarification questions, and produces 01.5-design-brief.md with HANDOFF block. Triggered automatically by modus-harness after SubAgent 01 completes.
 allowed-tools: Read, Write, Glob
 disable: false
 ---
 
-# modus-harness-01-5-design（设计方案 SubAgent）
+# modus-designer（技术方案设计 SubAgent）
 
 **调用方：** Harness Orchestrator（`modus-harness`）  
 **输入：** `modus/plans/active/{story-id}/01-analysis.md` + 相关业务 Skill + constitution  

package/templates/skills/{modus-harness-agents/02-dev → modus-agents/developer}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: modus-harness-02-dev
+name: modus-developer
 description: Use this skill when the Harness orchestrator needs to implement code changes based on the requirements analysis (01-analysis.md). Implements code layer by layer (data → service → orchestration → interface), runs build compilation, and generates 02-sprint-contract.md. Triggered by modus-harness after SubAgent 01 completes or during Loop 2 re-entry for P1/P2 fixes.
 allowed-tools: Read, Write, Glob, Bash
 disable: false
 ---
 
-# modus-harness-02-dev（代码开发 SubAgent）
+# modus-developer（代码开发 SubAgent）
 
 **调用方：** Harness Orchestrator  
 **输入：** `01-analysis.md` + 相关业务 Skill  

package/templates/skills/{modus-harness-agents/04-perf → modus-agents/perf-auditor}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: modus-harness-04-perf
+name: modus-perf-auditor
 description: Use this skill when the Harness orchestrator needs to perform static performance audit on code changes. Detects N+1 queries, missing batch operations, unbounded data fetches, deep pagination risks, and ES query issues. Generates 04-perf-report.md. Triggered by modus-harness in parallel with SubAgents 03 and 05 after Gate A passes.
 allowed-tools: Read, Write, Glob
 disable: false
 ---
 
-# modus-harness-04-perf（性能审计 SubAgent）
+# modus-perf-auditor（性能审计 SubAgent）
 
 **调用方：** Harness Orchestrator（与 03/05 并行启动）  
 **输入：** `02-sprint-contract.md` + 代码变更  

package/templates/skills/{modus-harness-agents/06-review → modus-agents/reviewer}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: modus-harness-06-review
+name: modus-reviewer
 description: Use this skill when the Harness orchestrator needs to perform comprehensive code review after all audit reports are ready. Evaluates all artifacts (01-analysis.md through 05-security-report.md), grades issues as P1/P2/P3, and generates cr-report.md with HANDOFF block. Gate C: if P1/P2 issues found, triggers Loop 2 re-entry. Triggered by modus-harness after Gate B passes.
 allowed-tools: Read, Write, Glob
 disable: false
 ---
 
-# modus-harness-06-review（代码评审 SubAgent）
+# modus-reviewer（代码评审 SubAgent）
 
 **调用方：** Harness Orchestrator（Gate B 通过后触发）  
 **输入：** 全部产出物（01-analysis.md 至 05-security-report.md）+ 代码变更  

package/templates/skills/{modus-harness-agents/05-security → modus-agents/security-auditor}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: modus-harness-05-security
+name: modus-security-auditor
 description: Use this skill when the Harness orchestrator needs to perform security audit on code changes. Checks multi-tenant data isolation, missing authorization annotations, sensitive data logging, SQL injection risks, and bypass interface protection. Generates 05-security-report.md. Triggered by modus-harness in parallel with SubAgents 03 and 04 after Gate A passes.
 allowed-tools: Read, Write, Glob
 disable: false
 ---
 
-# modus-harness-05-security（安全审计 SubAgent）
+# modus-security-auditor（安全审计 SubAgent）
 
 **调用方：** Harness Orchestrator（与 03/04 并行启动）  
 **输入：** `02-sprint-contract.md` + 代码变更