@modus-ai/modus 0.2.4 → 0.2.5

package/dist/utils/config.js

@@ -5,7 +5,7 @@ import { fileExists, readFile, writeFile } from './file-system.js';
 const DEFAULT_CONFIG = {
     version: '1',
     commands: {
-        enabled: ['init', 'vibe', 'plan', 'spec', 'harness'],
+        enabled: ['init', 'vibe', 'plan', 'spec', 'auto', 'harness'],
     },
 };
 export function getConfigPath(projectRoot) {
@@ -30,7 +30,15 @@ export function loadConfig(projectRoot) {
     if (!fileExists(configPath))
         return { ...DEFAULT_CONFIG };
     const raw = readFile(configPath);
-    return yaml.load(raw);
+    const parsed = yaml.load(raw);
+    // Defensive: ensure required nested fields exist to prevent runtime crashes
+    if (!parsed.commands) {
+        parsed.commands = { ...DEFAULT_CONFIG.commands };
+    }
+    else if (!Array.isArray(parsed.commands.enabled)) {
+        parsed.commands.enabled = [...DEFAULT_CONFIG.commands.enabled];
+    }
+    return parsed;
 }
 export function saveConfig(projectRoot, config) {
     const configPath = getConfigPath(projectRoot);

package/dist/utils/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA8CnE,MAAM,cAAc,GAAgB;IAClC,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE;QACR,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;KACrD;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,MAAmB;IACjE,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACtD,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAgFnE,MAAM,cAAc,GAAgB;IAClC,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE;QACR,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;KAC7D;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,CAAC;IAC7C,4EAA4E;IAC5E,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,CAAC,QAAQ,GAAG,EAAE,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC;IACnD,CAAC;SAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,MAAmB;IACjE,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACtD,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/dist/utils/file-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../src/utils/file-system.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGjE;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAMjE;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAG9D;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAG5D"}
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../src/utils/file-system.ts"],"names":[],"mappings":"AAIA,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGjE;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAMjE;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAG9D;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAG5D"}

package/dist/utils/file-system.js

@@ -1,5 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 export function ensureDir(dirPath) {
     fs.mkdirSync(dirPath, { recursive: true });
 }
@@ -35,7 +36,7 @@ export function findBizSkillDirs(projectRoot) {
 }
 /** Read a template file bundled with the package */
 export function readTemplate(templateRelPath) {
-    const templateBase = new URL('../../templates/', import.meta.url).pathname;
+    const templateBase = fileURLToPath(new URL('../../templates/', import.meta.url));
     return readFile(path.join(templateBase, templateRelPath));
 }
 //# sourceMappingURL=file-system.js.map

package/dist/utils/file-system.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-system.js","sourceRoot":"","sources":["../../src/utils/file-system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IACzD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACpD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,GAAY;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAC7D,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IACjE,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,YAAY,CAAC,eAAuB;IAClD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC3E,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"file-system.js","sourceRoot":"","sources":["../../src/utils/file-system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IACzD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACpD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,GAAY;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAC7D,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IACjE,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,YAAY,CAAC,eAAuB;IAClD,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACjF,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/package.json

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

package/schemas/knowledge-schema.yaml

@@ -4,6 +4,49 @@
 name: knowledge
 description: 知识体系 schema — 知识目录索引、Skill frontmatter、知识条目类型
 
+# ─────────────────────────────────────────
+# config.yaml scanRules 结构
+# ─────────────────────────────────────────
+scan_rules:
+  description: |
+    /modus:init Step 2 执行代码扫描时的规则配置，遵循公式：
+    最终扫描文件 = (include_extensions 匹配的文件) - (exclude_patterns 排除的路径)
+    各规则来源叠加计算（类似 .gitignore 的分层覆盖机制）。
+  location: "modus/config.yaml → scanRules 字段"
+  fields:
+    - name: include_extensions
+      type: list[string]
+      description: 要扫描的文件后缀名列表。默认值覆盖主流后端/前端语言。
+      default: [".java", ".kt", ".py", ".ts", ".tsx", ".js", ".go", ".rs", ".php", ".rb", ".swift", ".scala"]
+
+    - name: exclude_patterns
+      type: list[string]
+      description: |
+        glob 格式的排除模式，支持 ** 通配符。
+        默认已排除：构建产物（target/、build/、dist/）、IDE 配置（.idea/、.vscode/）、
+        依赖目录（node_modules/）、生成代码（generated/、*Generated.java）。
+        用户可在 config.yaml 中追加项目特有的排除模式。
+      default:
+        - "target/**"
+        - "build/**"
+        - "dist/**"
+        - "node_modules/**"
+        - ".idea/**"
+        - ".vscode/**"
+        - "generated/**"
+        - "**/*Generated.java"
+        - "*.lock"
+
+    - name: include_paths
+      type: list[string]
+      required: false
+      description: 额外需要扫描的目录，默认扫描项目 src/ 下全部内容。用于将 plugins/、extensions/ 等非标准目录纳入扫描。
+
+    - name: exclude_domain_patterns
+      type: list[string]
+      required: false
+      description: 强制排除的包名 glob 模式（如 "com.example.legacy.**"），用于将不希望被 modus 管理的历史代码排除在域识别之外。
+
 # ─────────────────────────────────────────
 # knowledge-catalog.md 结构
 # ─────────────────────────────────────────
@@ -94,6 +137,38 @@ skill_frontmatter:
       description: 知识层级（仅 team-conventions 和 tech-wiki 需要填写）
       values: ["0-T", "1"]
 
+    - name: upstream_skills
+      type: list
+      required: false
+      description: |
+        本 Skill 依赖的上游 Skill 列表（仅填写直接依赖，不递归填写传递依赖）。
+        当上游 Skill 的 last_hash 发生变化或 maturity 降级时，本 Skill 的 stale_cascade 自动置为 true。
+        格式：["modus-biz-order", "modus-biz-user"]
+      default: []
+
+    - name: stale_cascade
+      type: boolean
+      required: false
+      description: |
+        联动失效标记。当任一 upstream_skills 中的 Skill 发生 hash 变更或 maturity 降级时，
+        由 vibe/plan 的防腐机制自动将此字段置为 true。
+        置为 true 后，引用本 Skill 前须先执行 /modus:refresh 验证依赖链是否仍然有效，
+        确认无误后由 skill-creator 模式 B 将此字段重置为 false。
+      default: false
+
+    - name: external_deps
+      type: map
+      required: false
+      description: |
+        本 Skill 的规范依赖外部库的版本范围。当 pom.xml / package.json 中对应库发生
+        跨大版本升级（major version 变化）时，自动触发 stale 降级。
+        格式：key 为库名，value 为 semver 范围（如 "~2.7"、">=3.0 <4.0"）
+      example:
+        spring-boot: "~2.7"
+        mybatis-plus: ">=3.5"
+        dubbo: "~3.1"
+      default: {}
+
 # ─────────────────────────────────────────
 # 知识条目类型（五类 MECE）
 # ─────────────────────────────────────────
@@ -147,10 +222,45 @@ maturity_lifecycle:
     verified_decay:
       condition: "verified 且距 last_referenced 超过 6 个月"
       action: "降为 draft，追加注释 ⚠️ 6个月未引用，可能已过时"
+    upstream_cascade_decay:
+      condition: "upstream_skills 中任一 Skill 的 last_hash 发生变化，或其 maturity 降级"
+      action: "将本 Skill 的 stale_cascade 置为 true，在 knowledge-catalog 中标注 ⚠️ 上游变更待验证"
+    external_dep_decay:
+      condition: "pom.xml 或 package.json 中，external_deps 里某库的 major version 发生变化"
+      action: "将本 Skill maturity 降为 stale，追加注释 ⚠️ 外部依赖 {lib} 升级（{old} → {new}），规范需验证"
 
   decay_check_trigger:
-    - "00-skills-builder 模式 D 执行时"
+    - "modus-skill-creator（SubAgent 00）模式 D 执行时"
     - "可手动触发：/modus:init --lint"
+    - "vibe/plan Step 3 防腐检查时（仅检查 stale_cascade，不全量扫描）"
+    - "modus-init 执行后自动扫描 pom.xml/package.json 版本变化触发 external_dep_decay"
+
+# ─────────────────────────────────────────
+# external_deps 自动提取规范
+# ─────────────────────────────────────────
+external_deps_extraction:
+  description: |
+    /modus:init 生成 Skill 时，自动从构建文件中提取该域依赖的外部库版本，
+    写入 Skill frontmatter 的 external_deps 字段。
+  source_files:
+    java: "pom.xml（根目录 + 各 module 级别）"
+    node: "package.json（各包目录）"
+    python: "pyproject.toml / requirements.txt"
+  extraction_logic: |
+    1. 扫描该域 key_files 中的 import/require 语句
+    2. 提取引用了 pom.xml/package.json 中声明的第三方库（排除标准库）
+    3. 按引用频次排序，取前 5 个高频库
+    4. 从构建文件中读取对应库的当前版本，转为 semver 范围（固定 major.minor，不锁 patch）
+    5. 写入 frontmatter: external_deps: {lib: version-range}
+  version_range_format:
+    example_input: "spring-boot-starter 2.7.14"
+    example_output: "spring-boot: \"~2.7\""
+    rule: "major.minor 相同则用 ~minor，跨 minor 用 >=min <max"
+  decay_detection: |
+    modus update / /modus:init --lint 执行时：
+    1. 重新读取 pom.xml/package.json 中 external_deps 列出的库的当前版本
+    2. 比对 major version：若发生变化（如 2.x → 3.x），触发 external_dep_decay
+    3. 将受影响的 Skill 降级为 stale，在 knowledge-catalog 中标注 ⚠️
 
 # ─────────────────────────────────────────
 # HANDOFF 块格式（Harness 产物交接协议）

package/templates/behavior-guard.md

@@ -0,0 +1,165 @@
+# Modus Behavior Guard
+
+> 安装位置：`modus/behavior-guard.md`（由 `/modus:init` 创建）  
+> 加载时机：所有 Modus 命令 Step 0 读取，与 `modus/config.yaml` 同级  
+> 来源：直接借鉴 [Andrej Karpathy's LLM coding guidelines](https://x.com/karpathy/status/2015883857489522876)，适配 Modus/Java 上下文
+
+---
+
+这是对所有 Modus SubAgent 生效的**全局行为约束**。优先级低于 `constitution.hard_rules`（项目技术规则），高于任何 Skill 中的建议。
+
+**权衡声明：** 这些原则偏向谨慎而非速度。对于显然的单步操作，使用判断力。
+
+---
+
+## 1. Think Before Coding
+
+**不假设。不隐藏困惑。暴露权衡。**
+
+开始实现前：
+- 明确说出你的假设。如果不确定，问。
+- 如果存在多种解读，呈现它们，不要静默选择。
+- 如果有更简单的方案，说出来。该推回时推回。
+- 如果有不清楚的地方，停下来。说明困惑是什么。问。
+
+**modus 场景示例：**
+
+❌ 错误：直接按猜测的域开始生成代码
+✅ 正确：`[已匹配 order 域 · 置信度 92%]` → 继续；或展示候选列表等待确认
+
+❌ 错误：用户说「做个导出功能」，直接生成完整导出模块
+✅ 正确：
+```
+「导出功能」可能意味着：
+  A. 接口返回分页 JSON（最简，当前 Skill 中无导出相关记录）
+  B. 后台任务生成文件+邮件通知（需新 MQ Topic）
+  C. 前端直接下载 CSV（需 Facade 层新接口）
+哪种更符合你的期望？
+```
+
+---
+
+## 2. Simplicity First
+
+**最少代码解决问题。没有投机性内容。**
+
+- 不实现未被要求的功能。
+- 单次使用的代码不抽象。
+- 未被要求的"灵活性"或"可配置性"不加。
+- 不可能发生的场景不做错误处理。
+- 如果写了 200 行但 50 行能做到，重写。
+
+自我检验：「资深工程师会说这过于复杂吗？」如果是，简化。
+
+**modus 场景示例：**
+
+❌ 错误：用户说「加个状态校验」，生成了 Strategy 模式 + 枚举工厂 + 抽象类体系
+✅ 正确：在 Service 方法头加一行 `if (!order.canTransit(targetStatus)) throw new BizException(...);`
+
+❌ 错误：modus-init 对 50 个文件的项目也跑 5 轮全量扫描 + SubAgent 并行
+✅ 正确：先读目录结构，按实际发现的域数量决定深度
+
+---
+
+## 3. Surgical Changes
+
+**只动必须动的地方。只清理自己的垃圾。**
+
+修改已有代码时：
+- 不「顺手优化」相邻代码、注释或格式。
+- 不重构未损坏的东西。
+- 匹配现有代码风格，即使你会选择不同方式。
+- 发现无关的死代码，提及——不删除。
+
+你的改动产生孤儿时：
+- 删除**你的改动**让其变得无用的 import/变量/方法。
+- 不删除原本就存在的死代码，除非被要求。
+
+检验标准：每一行改动都必须能追溯到用户的请求。
+
+**modus 场景示例：**
+
+❌ 错误：用户让修一个 NPE bug，顺便把整个方法改成 Optional 链式 + 加了 log + 补了注释
+✅ 正确：只加 `if (order == null) throw new BizException(ORDER_NOT_FOUND);`，其余不动
+
+❌ 错误：vibe 编码完成后自动更新 Skill 文件（用户没要求更新文档）
+✅ 正确：缓冲到 pending-knowledge.yaml，等 git commit 时统一沉淀
+
+---
+
+## 4. Goal-Driven Execution
+
+**定义成功标准。循环直到验证通过。**
+
+将任务转化为可验证的目标：
+- 「加个校验」→「为无效输入写测试，然后让测试通过」
+- 「修这个 bug」→「写出能复现的测试，然后让它通过」
+- 「重构 X」→「确保重构前后测试都通过」
+
+多步骤任务，先陈述简短计划：
+```
+1. [步骤] → 验证：[检查项]
+2. [步骤] → 验证：[检查项]
+3. [步骤] → 验证：[检查项]
+```
+
+强成功标准让 Agent 独立循环完成。弱标准（「让它能跑」）需要反复澄清。
+
+**modus 场景示例：**
+
+❌ 错误：`/modus:vibe 加批量审批` → 直接开始写代码，没有说明"完成"意味着什么
+✅ 正确：
+```
+任务目标：实现批量审批接口，支持最多 50 条订单同时审批
+完成标准：
+  · mvn test -Dtest=BatchApproveServiceTest 通过
+  · 并发场景下不产生重复审批（分布式锁验证）
+  · 影响范围：仅 OrderService + OrderFacade，不触及其他文件
+```
+
+---
+
+---
+
+## 5. Token Budget Guard
+
+**有意识地使用 token。大操作前声明预算。**
+
+Token 是 AI 工作流的核心成本约束。每次命令执行前，应在内部估算本次的 token 消耗范围，避免不必要的全量加载。
+
+**Modus 各步骤 token 预算参考：**
+
+| 操作 | 估算 token | 说明 |
+|------|-----------|------|
+| Level 1：读 knowledge-catalog | ~200 | 仅目录索引，所有命令必须执行 |
+| Level 2：读 1 个业务 Skill | ~3,000 | 按需加载，不相关的域不读 |
+| Level 3：读 1 个实际代码文件 | ~500–2,000 | 仅在编码时按需读取 |
+| 全量加载（8 个业务 Skill） | ~24,000 | 应避免——三级加载 vs 全量差约 **10×** |
+| behavior-guard + config.yaml | ~500 | Step 0 固定成本 |
+| Design Brief（Simple） | ~200 | 内联生成，不读额外文件 |
+| Design Brief（Medium/Complex） | ~1,000 | 调用 design-brief Skill |
+
+**决策规则：**
+- 若任务只涉及 1 个域 → 只读该域 Skill（Level 2 成本 = ~3,000 tokens）
+- 若置信度 < 85% 涉及多域 → 先确认再加载，不预先全量加载
+- 若 Skill 已加载但任务无关 → 不重复读取，复用上下文中已有的内容
+
+自我检验：「本次操作有没有读了不必要的文件？」如果有，下次先匹配域再加载。
+
+**modus 场景示例：**
+
+❌ 错误：vibe 任务只涉及 order 域，但读了全部 8 个业务 Skill（~24,000 tokens）
+✅ 正确：Level 1 读目录 → 匹配 order 域 → Level 2 仅读 order Skill（~3,200 tokens）
+
+❌ 错误：连续 3 次 vibe 都重新读 behavior-guard.md 和 config.yaml
+✅ 正确：同一 session 中，Step 0 内容已在上下文，不重复读取
+
+---
+
+## 这些原则生效时的表现
+
+- **diff 中没有多余改动** — 只有被请求的变更
+- **第一次就写简单代码** — 不因过度设计而返工
+- **澄清问题在实现前提出** — 不是在出错后
+- **干净的 PR，没有顺手重构** — 每行改动都有来源
+- **token 消耗在合理范围** — 三级加载优于全量加载，同 session 不重复读取

package/templates/commands/auto.md

@@ -15,7 +15,9 @@ Read and follow the skill at `.codebuddy/skills/modus-auto/SKILL.md` to execute
 5. Show recommendation with reasoning + comparison table of other options
 6. Wait for human mode selection
 7. Show parameter confirmation window (second confirmation step)
-8. Auto-launch the selected mode with TAPD context pre-filled
+8. Auto-launch the selected mode with TAPD context pre-filled:
+   - **plan** mode: appends `[AUTO_MODE: questions_confirmed]` + confirmed key info summary to the prompt; modus-plan Step 3 will skip interactive clarification when it detects this marker
+   - **vibe** / **spec** / **harness** modes: pass TAPD context directly without this marker
 
 ## Usage
 

package/templates/commands/commit.md

@@ -0,0 +1,63 @@
+# /modus:commit
+
+Knowledge-aware git commit. Drains pending knowledge from `modus/sessions/pending-knowledge.yaml` into the corresponding business Skill files, then executes the actual git commit.
+
+## Instructions
+
+Read and follow the steps below to execute this command.
+
+## What It Does
+
+During `/modus:vibe` sessions, newly discovered knowledge (new enum values, business rules, pitfalls) is buffered to `modus/sessions/pending-knowledge.yaml` rather than written directly to Skill files. This prevents exploratory or incomplete sessions from polluting the knowledge base.
+
+`/modus:commit` is the trigger that drains this buffer at the right moment — when code is confirmed ready to commit.
+
+## Execution Steps
+
+1. **Check pending knowledge buffer:**  
+   Read `modus/sessions/pending-knowledge.yaml` (if it exists).  
+   If empty or absent → skip to Step 4 and execute a normal git commit.
+
+2. **Show pending entries for confirmation:**
+   ```
+   📚 发现 {N} 条待沉淀知识（来自最近 {K} 次 vibe 会话）：
+   
+     · [pitfall] order 域：批量操作超 50 条需分批处理
+       证据: OrderService.java:142
+     · [guideline] order 域：新增审批流必须记录审批人 ID 到日志
+       证据: OrderManager.java:89
+     · [model] payment 域：PayStatus 新增 REFUNDING 枚举值
+       证据: PayStatus.java:15
+   
+   是否将以上知识写入对应 Skill 文件？[Y/n]
+   ```
+
+3. **Write back to Skills (if confirmed):**  
+   For each entry in `pending-knowledge.yaml`:
+   - Call `modus-skill-creator` Mode C to append the entry to the corresponding `modus-biz-{domain}/SKILL.md`
+   - Mark the entry as `settled: true` in `pending-knowledge.yaml`
+   - Output per-entry status: `✓ [pitfall] → modus-biz-order 已写入`
+
+   After all entries processed:
+   - Remove settled entries from `pending-knowledge.yaml` (keep only `settled: false` entries)
+   - Update `modus/knowledge-catalog.md` if any Skill version changed
+
+4. **Execute git commit:**  
+   Run the standard git commit flow:
+   ```bash
+   git add .
+   git commit
+   ```
+   (Opens editor for commit message or accepts message from user input)
+
+5. **Output summary:**
+   ```
+   ✅ 知识沉淀完成（{N} 条已写入 Skill）
+   ✅ Git commit 执行完成
+   ```
+
+## Notes
+
+- If the user skips knowledge write-back (answer `n`), the entries remain in `pending-knowledge.yaml` for the next `/modus:commit` call.
+- Entries with `settled: false` that are older than 30 days will be highlighted with `⚠️ 较旧` to prompt cleanup.
+- This command only handles knowledge write-back for `/modus:vibe` sessions. Knowledge from `/modus:plan`, `/modus:spec`, and `/modus:harness` is written back immediately (not buffered).

package/templates/commands/harness.md

@@ -11,10 +11,14 @@ Read and follow the skill at `.codebuddy/skills/modus-harness/SKILL.md` to execu
 1. Check for business Skills — if absent, strongly recommend running `/modus:init` first
 2. Accept TAPD Story URL as input
 3. Create working directory: `modus/plans/active/{story-id}/`
-4. Run the Harness Orchestrator which coordinates 7 SubAgents:
+4. Run the Harness Orchestrator which coordinates up to 9 SubAgents (00–07 + 01.5):
 
 **Loop 1 (sequential):**
+- SubAgent 00: Knowledge injection (Skill update/creation)
 - SubAgent 01: Requirements analysis → `01-analysis.md`
+- Gate A0: Validate `01-analysis.md` HANDOFF gate_status = "passed"
+- SubAgent 01.5: Design brief generation ⏸️ (human architecture decision confirmation) → `01.5-design-brief.md`
+- Gate A0.5: Validate `01.5-design-brief.md` HANDOFF gate_status ∈ {passed, warning}
 - SubAgent 02: Code development → `02-sprint-contract.md` + code changes
 - Gate A: Build compilation check
 - SubAgent 03/04/05 (parallel): Tests + Performance audit + Security audit
@@ -26,19 +30,22 @@ Read and follow the skill at `.codebuddy/skills/modus-harness/SKILL.md` to execu
 - Gate C: No P1/P2 → proceed
 - SubAgent 07: Deployment verification → `07-deploy-status.md`
 
+**Step Final:** SubAgent 00 (Mode D) — ARCHIVE knowledge extraction
+
 5. Final Review: human confirms before merging
 
 ## Working Directory
 
 ```
 modus/plans/active/{story-id}/
-├── 01-analysis.md
-├── 02-sprint-contract.md
-├── 03-test-report.md
-├── 04-perf-report.md
-├── 05-security-report.md
-├── cr-report.md
-└── 07-deploy-status.md
+├── 01-analysis.md          ← SubAgent 01 产出，含 HANDOFF 块
+├── 01.5-design-brief.md    ← SubAgent 01.5 产出，含架构决策
+├── 02-sprint-contract.md   ← SubAgent 02 产出，含代码变更清单
+├── 03-test-report.md       ← SubAgent 03 产出
+├── 04-perf-report.md       ← SubAgent 04 产出
+├── 05-security-report.md   ← SubAgent 05 产出
+├── cr-report.md            ← SubAgent 06 产出，含 HANDOFF.issues
+└── 07-deploy-status.md     ← SubAgent 07 产出
 ```
 
 ## Resume Support

package/templates/commands/vibe.md

@@ -16,7 +16,7 @@ Read and follow the skill at `.codebuddy/skills/modus-vibe/SKILL.md` to execute
 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
+9. **Buffer new knowledge** (silent): if new knowledge discovered (new enums, pitfalls, rule changes), append to `modus/sessions/pending-knowledge.yaml`; show one-line `[缓冲 {N} 条新知识 → 将在 /modus:commit 时沉淀到 Skill]`; if nothing new, stay silent. **Do NOT write to Skill files directly** — run `/modus:commit` to persist buffered knowledge.
 10. Append session log to `modus/sessions/vibe-log.md`
 
 **Degraded mode** (no business Skills): proceed without domain context, note quality may be lower, show `[降级模式：无业务上下文，建议先运行 /modus:init]`.

package/templates/knowledge-catalog.md

@@ -1,53 +1,82 @@
 # Modus 知识全景目录
 # 所有 Modus 命令启动时先读此文件（Level 1 加载，~200 tokens）
-# 按需再读完整 SKILL.md（Level 2），或直接读代码文件（Level 3）
-#
-# maturity: draft → verified → proven
-# 衰减：proven 12个月未引用→verified；verified 6个月未引用→draft
+# 按需再读完整 SKILL.md（Level 2，~3000 tokens/个）
+# 或直接读 Skill 引用的实际代码文件（Level 3，按需）
 
 updated: {YYYY-MM-DD}
 
+## 全局行为守卫 (Layer 0-G)
+# 所有命令 Step 0 加载，优先级：低于 constitution.hard_rules，高于 Skill 建议
+- **behavior-guard**: `modus/behavior-guard.md` — 五条全局行为约束
+  (Think Before Coding · Simplicity First · Surgical Changes · Goal-Driven Execution · Token Budget Guard)
+  [由 /modus:init 生成，不随项目代码变化，手动维护]
+
 ## 团队约定 (Layer 0-T)
-- **modus-team-conventions**: 代码规范/提交规范/硬性约束 [maturity: draft] 更新: {日期}
+- **modus-team-conventions**: 代码规范/提交规范/最佳实践
+  [status: draft] [format: v2/14节] [upstream: -]
+  更新: {日期}
 
 ## 技术知识 (Layer 1)
-- **modus-tech-wiki**: 跨项目架构决策/反模式库/性能优化 [maturity: draft] 更新: {日期}
+- **modus-tech-wiki**: 跨项目技术经验（反模式、架构决策、性能优化）
+  [status: draft] [format: v2/14节] [upstream: -]
+  更新: {日期}
 
 ## 业务知识 (Layer 2)
 <!-- 由 /modus:init 生成，由各模式工作流自动更新 -->
-- **modus-biz-{domain}**: {中文域名} — {核心职责一句话} [maturity: draft] 最近引用: {日期}
+- **modus-biz-{domain}**: {中文域名} — {核心职责一句话}
+  [status: draft] [format: v3/17节] [upstream: {依赖域列表，无则写-}]
+  更新: {日期}  hash: {last_hash 前8位}
+
+## 域依赖图 (Dependency Graph)
+<!--
+  格式：{下游域} --> {上游域1}, {上游域2}
+  含义：下游域的 Skill 中 upstream_skills 声明了对上游域的依赖。
+  当上游域 hash 变更时，下游域的 stale_cascade 自动置为 true（在 ⚠️ 标注处可见）。
+  由 /modus:init 自动生成，可手动补充跨域调用关系。
+-->
+<!-- example:
+  payment --> order, user
+  notification --> order, payment
+  report --> order, payment, user
+-->
+<!-- 当前依赖关系（/modus:init 扫描后填入）：
+  {待填入}
+-->
 
 ## 渐进加载说明
+
 启动任意 Modus 命令时的加载顺序：
-  Level 1（必须，~200 tokens）: 读本文件，了解有哪些知识可用
-  Level 2（按需，~3000 tokens/个）: 根据任务匹配相关域，读对应 SKILL.md
-  Level 3（按需，无上限）: 执行任务时读 Skill 引用的实际代码文件
+  Level 1（必须，~200 tokens）:  读本文件，了解有哪些知识可用
+  Level 2（按需，~3000 tokens）: 根据任务匹配相关域，读对应 SKILL.md
+  Level 3（按需，无上限）:       执行任务时读 Skill 引用的实际代码文件
 
 目标：不相关的 Skill 不加载，大幅降低 token 消耗。
 
-## Skill 状态生命周期
+## Skill status 生命周期
 
-### 成熟度状态（基于 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** → 域已废弃，不再维护
+| status    | 含义                    | 升级方式                          |
+|-----------|-------------------------|-----------------------------------|
+| draft     | 初始生成，未经验证       | 运行 /modus:verify 且满足四项条件  |
+| verified  | 经至少 1 次真实使用验证  | usage_count ≥ 2 且不同工作流       |
+| proven    | 经 ≥2 个不同工作流验证  | -                                  |
+| stale     | hash 不匹配或衰减超期   | 运行 /modus:refresh 后回到 draft   |
+| archived  | 域已废弃，不再维护       | -（禁止引用）                      |
 
-### 衰减规则（基于 last_referenced）
-- proven  + 距 last_referenced 超过 12 个月 → verified
-- verified + 距 last_referenced 超过 6 个月 → stale
-- stale   + 距 last_referenced 超过 stale_after_days → archived（需人工二次确认）
+## 衰减规则（活跃度感知，基于 last_referenced + usage_count）
+
+衰减阈值根据 usage_count 动态调整：
+- 活跃域（usage_count ≥ 10）：verified → stale 12个月 / proven → verified 24个月
+- 正常域（usage_count 3-9）：verified → stale 6个月 / proven → verified 12个月
+- 冷门域（usage_count ≤ 2）：verified → stale 3个月 / proven → verified 6个月
+- stale + 超过 stale_after_days 天 → archived（需人工二次确认）
+
+## 防腐机制核心字段
 
-### 防腐机制核心字段
 每个 Skill frontmatter 必须包含以下字段，缺一不可：
-- **last_referenced**: 最后引用时间（用于衰减计算）
-- **usage_count**: 使用次数（用于成熟度升级）
-- **last_hash**: key_files 内容 SHA-1 哈希（用于检测代码变更，初始留空）
-- **key_files**: 关键源文件列表（最多20个，用于 hash 计算）
-
-缺少任一防腐字段将导致：
-- 无法自动检测代码变更
-- 无法触发 Skill 更新
-- 无法计算知识衰减
-- 防腐机制完全失效
+- **last_referenced**: 最后引用时间（每次被命令加载时更新）
+- **usage_count**: 使用次数（每次完成真实开发任务后 +1）
+- **last_hash**: 全局 SHA-1（对每个文件单独计算 SHA-1，将「路径:SHA-1」对按文件路径字母序排序后拼接，再整体计算 SHA-1，禁止内容直接拼接）；引用时快速比对，不一致则展开 file_hashes 逐文件定位
+- **file_hashes**: 文件级 hash map（`{路径: SHA-1}`）；全局 hash 不一致时使用，精准输出变更文件清单
+- **key_files**: 关键源文件列表（最多 20 个，用于 hash 计算）
+
+详细说明见：modus/templates/skills/modus-init/SKILL.md「防腐机制总览」章节