@winspan/claude-forge 8.41.0 → 8.51.0

package/dist/skills/invocation-guard.d.ts

@@ -5,6 +5,7 @@
  * - 单会话总调用次数（默认 10）
  * - 单会话调用深度（默认 3）
  * - 同 session 同 skill 幂等（避免重复调用）
+ * - TTL 机制：会话状态 30 分钟后自动过期
  *
  * 状态为进程内存，进程重启会清空；调用链路通常集中在单个会话内，
  * 重启后重建状态是可接受的。
@@ -13,6 +14,7 @@ export interface SessionInvocations {
     total: number;
     depth: number;
     calledSkills: Set<string>;
+    lastAccessTime: number;
 }
 export interface InvocationCheckResult {
     allowed: boolean;
@@ -20,6 +22,8 @@ export interface InvocationCheckResult {
 }
 export declare class InvocationGuard {
     private sessions;
+    private cleanupTimer;
+    constructor();
     /**
      * 检查是否允许调用。
      * 不修改状态；调用方决定是否继续后调用 record()。
@@ -41,5 +45,21 @@ export declare class InvocationGuard {
      * 获取会话统计（调试/观测用）。
      */
     getStats(sessionId: string): SessionInvocations | null;
+    /**
+     * 清理过期会话（TTL 机制）。
+     */
+    private cleanupExpiredSessions;
+    /**
+     * 启动自动清理定时器。
+     */
+    private startCleanupTimer;
+    /**
+     * 停止自动清理定时器（用于测试或进程关闭）。
+     */
+    stopCleanupTimer(): void;
+    /**
+     * 获取当前会话数量（用于监控）。
+     */
+    getSessionCount(): number;
 }
 //# sourceMappingURL=invocation-guard.d.ts.map

package/dist/skills/invocation-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invocation-guard.d.ts","sourceRoot":"","sources":["../../src/skills/invocation-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAyC;IAEzD;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,qBAAqB;IA+BhE;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAYhD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOjC;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;CAGvD"}
+{"version":3,"file":"invocation-guard.d.ts","sourceRoot":"","sources":["../../src/skills/invocation-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,YAAY,CAA+B;;IAOnD;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,qBAAqB;IAsChE;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAchD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQjC;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAItD;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAOxB;;OAEG;IACH,eAAe,IAAI,MAAM;CAG1B"}

package/dist/skills/invocation-guard.js

@@ -5,14 +5,22 @@
  * - 单会话总调用次数（默认 10）
  * - 单会话调用深度（默认 3）
  * - 同 session 同 skill 幂等（避免重复调用）
+ * - TTL 机制：会话状态 30 分钟后自动过期
  *
  * 状态为进程内存，进程重启会清空；调用链路通常集中在单个会话内，
  * 重启后重建状态是可接受的。
  */
 const MAX_INVOCATIONS_PER_SESSION = 10;
 const MAX_INVOCATION_DEPTH = 3;
+const SESSION_TTL_MS = 30 * 60 * 1000; // 30 minutes
+const CLEANUP_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
 export class InvocationGuard {
     sessions = new Map();
+    cleanupTimer = null;
+    constructor() {
+        // Start automatic cleanup timer
+        this.startCleanupTimer();
+    }
     /**
      * 检查是否允许调用。
      * 不修改状态；调用方决定是否继续后调用 record()。
@@ -22,7 +30,13 @@ export class InvocationGuard {
             total: 0,
             depth: 0,
             calledSkills: new Set(),
+            lastAccessTime: Date.now(),
         };
+        // Check if session has expired
+        if (Date.now() - session.lastAccessTime > SESSION_TTL_MS) {
+            this.sessions.delete(sessionId);
+            return { allowed: true }; // Expired session, allow new invocation
+        }
         if (session.total >= MAX_INVOCATIONS_PER_SESSION) {
             return {
                 allowed: false,
@@ -51,10 +65,12 @@ export class InvocationGuard {
             total: 0,
             depth: 0,
             calledSkills: new Set(),
+            lastAccessTime: Date.now(),
         };
         session.total += 1;
         session.depth += 1;
         session.calledSkills.add(skillId);
+        session.lastAccessTime = Date.now(); // Update access time
         this.sessions.set(sessionId, session);
     }
     /**
@@ -64,6 +80,7 @@ export class InvocationGuard {
         const session = this.sessions.get(sessionId);
         if (session) {
             session.depth = Math.max(0, session.depth - 1);
+            session.lastAccessTime = Date.now(); // Update access time
         }
     }
     /**
@@ -78,5 +95,51 @@ export class InvocationGuard {
     getStats(sessionId) {
         return this.sessions.get(sessionId) ?? null;
     }
+    /**
+     * 清理过期会话（TTL 机制）。
+     */
+    cleanupExpiredSessions() {
+        const now = Date.now();
+        const expiredSessions = [];
+        for (const [sessionId, session] of this.sessions.entries()) {
+            if (now - session.lastAccessTime > SESSION_TTL_MS) {
+                expiredSessions.push(sessionId);
+            }
+        }
+        for (const sessionId of expiredSessions) {
+            this.sessions.delete(sessionId);
+        }
+        if (expiredSessions.length > 0) {
+            // Use console.log instead of logger to avoid circular dependency
+            console.log(`[InvocationGuard] Cleaned up ${expiredSessions.length} expired sessions`);
+        }
+    }
+    /**
+     * 启动自动清理定时器。
+     */
+    startCleanupTimer() {
+        if (this.cleanupTimer)
+            return;
+        this.cleanupTimer = setInterval(() => {
+            this.cleanupExpiredSessions();
+        }, CLEANUP_INTERVAL_MS);
+        // Prevent timer from keeping process alive
+        this.cleanupTimer.unref();
+    }
+    /**
+     * 停止自动清理定时器（用于测试或进程关闭）。
+     */
+    stopCleanupTimer() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+    /**
+     * 获取当前会话数量（用于监控）。
+     */
+    getSessionCount() {
+        return this.sessions.size;
+    }
 }
 //# sourceMappingURL=invocation-guard.js.map

package/dist/skills/invocation-guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"invocation-guard.js","sourceRoot":"","sources":["../../src/skills/invocation-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,2BAA2B,GAAG,EAAE,CAAC;AACvC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAa/B,MAAM,OAAO,eAAe;IAClB,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEzD;;;OAGG;IACH,KAAK,CAAC,SAAiB,EAAE,OAAe;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI;YAC9C,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,YAAY,EAAE,IAAI,GAAG,EAAU;SAChC,CAAC;QAEF,IAAI,OAAO,CAAC,KAAK,IAAI,2BAA2B,EAAE,CAAC;YACjD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,wCAAwC,2BAA2B,GAAG;aAC/E,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,IAAI,oBAAoB,EAAE,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,iCAAiC,oBAAoB,GAAG;aACjE,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,UAAU,OAAO,sDAAsD;aAChF,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAe;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI;YAC9C,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,YAAY,EAAE,IAAI,GAAG,EAAU;SAChC,CAAC;QACF,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACnB,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACnB,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAiB;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAiB;QACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IAC9C,CAAC;CACF"}
+{"version":3,"file":"invocation-guard.js","sourceRoot":"","sources":["../../src/skills/invocation-guard.ts"],"names":[],"mappings":"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"}

package/dist/skills/matcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/skills/matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAoBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,GAAG,WAAW,GAAG,IAAI,CA4C3F;AA0CD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAG9E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnF"}
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/skills/matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAoBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,GAAG,WAAW,GAAG,IAAI,CAsD3F;AA0CD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAG9E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnF"}

package/dist/skills/matcher.js

@@ -41,11 +41,20 @@ export function calculateMatchScore(skill, context) {
     // 3. Context bonus (max 30 points)
     const contextBonus = calculateContextBonus(skill, context);
     score += contextBonus;
+    // 4. Fuzzy matching: partial keyword match for longer prompts
+    if (matchedKeywords.length === 0 && prompt.length > 50) {
+        for (const kw of skill.keywords) {
+            if (kw.length >= 3 && allText.toLowerCase().includes(kw.toLowerCase().slice(0, 3))) {
+                score = Math.max(score, 25);
+                matchedKeywords.push(`~${kw}`);
+                break;
+            }
+        }
+    }
     // Normalize to 0-100
     const confidence = Math.min(100, score);
-    // Lower threshold: >= 40% confidence and at least 1 keyword match
-    // This is more lenient than the old "2 keywords" rule but still filters noise
-    if (confidence < 40 || matchedKeywords.length < 1) {
+    // Threshold: >= 20% confidence is enough to surface a match
+    if (confidence < 20) {
         return null;
     }
     return {

package/dist/skills/matcher.js.map

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

package/dist/skills/official/code-simplifier.md

@@ -0,0 +1,16 @@
+---
+name: code-simplifier
+description: Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Focuses on recently modified code unless instructed otherwise.
+model: opus
+---
+
+You are an expert code simplification specialist focused on enhancing code clarity, consistency, and maintainability while preserving exact functionality. Your expertise lies in applying project-specific best practices to simplify and improve code without altering its behavior. You prioritize readable, explicit code over overly compact solutions. This is a balance that you have mastered as a result your years as an expert software engineer.
+
+You will analyze recently modified code and apply refinements that:
+
+1. **Preserve Functionality**: Never change what the code does - only how it does it. All original features, outputs, and behaviors must remain intact.
+
+2. **Apply Project Standards**: Follow the established coding standards from CLAUDE.md including:
+
+   - Use ES modules with proper import sorting and extensions
+   - Prefer `

package/dist/skills/official/find-skills.md

@@ -0,0 +1,23 @@
+---
+name: find-skills
+description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
+---
+
+# Find Skills
+
+This skill helps you discover and install skills from the open agent skills ecosystem.
+
+## When to Use This Skill
+
+Use this skill when the user:
+
+- Asks "how do I do X" where X might be a common task with an existing skill
+- Says "find a skill for X" or "is there a skill for X"
+- Asks "can you do X" where X is a specialized capability
+- Expresses interest in extending agent capabilities
+- Wants to search for tools, templates, or workflows
+- Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)
+
+## What is the Skills CLI?
+
+The Skills CLI (`

package/dist/skills/official/official-api-design.md

@@ -0,0 +1,17 @@
+---
+name: official-api-design
+version: 1.0.0
+description: "API 设计规范：RESTful/RPC 接口设计最佳实践"
+tags: [api, rest, design, backend]
+---
+
+# API 设计规范
+
+## 设计顺序
+1. 先定义资源和操作（不要先想 URL）
+2. 写 OpenAPI/Protobuf 规格
+3. 用 mock 验证调用方能用
+4. 再实现
+
+## RESTful 规范
+- URL 用名词复数：`

package/dist/skills/official/official-architecture-decision.md

@@ -0,0 +1,20 @@
+---
+name: official-architecture-decision
+version: 1.0.0
+description: "架构决策记录（ADR）：结构化记录重要技术决策"
+tags: [architecture, adr, design, decision]
+---
+
+# 架构决策记录（ADR）
+
+每个重要的技术决策都应该留下可追溯的记录。
+
+## 何时写 ADR
+- 技术选型（框架、数据库、消息队列）
+- 系统边界划分
+- 接口协议选择
+- 影响超过 1 个模块的设计决策
+
+## ADR 模板
+
+`

package/dist/skills/official/official-bmad.md

@@ -0,0 +1,118 @@
+---
+name: official-bmad
+version: 1.0.1
+description: "BMAD 方法论：四角色敏捷协作指南（完整四阶段流程）"
+tags: [bmad, agile, four-role, collaboration]
+---
+
+# BMAD 方法论（Four-Role Agile）
+
+BMAD 是一种四角色敏捷协作模式，适用于复杂功能开发和端到端的用户故事实现。
+
+## 核心理念
+
+通过明确的角色划分和阶段流程，确保需求、设计、实现和评审的质量。
+
+## 四个角色
+
+1. **Business（业务/产品经理）**：定义需求和验收标准
+2. **Maker（实现者/开发者）**：编写代码和实现功能
+3. **Architect（架构师）**：设计系统结构和接口
+4. **Developer（开发/集成者）**：集成和测试
+
+---
+
+## 阶段 1：分析（Analyze）
+
+**角色**：Business + Architect
+
+**目标**：澄清需求，识别技术约束和依赖。
+
+**步骤**：
+1. 澄清需求（用户故事、验收标准）
+2. 识别技术约束和依赖
+3. 评估风险和可行性
+4. 定义输入输出和边界条件
+
+**输出**：需求文档（requirements document）
+
+**建议**：调用 `researcher` 或 `planner` Agent
+
+---
+
+## 阶段 2：设计（Design）
+
+**角色**：Architect + Developer
+
+**目标**：设计技术方案和模块结构。
+
+**步骤**：
+1. 设计模块划分和接口
+2. 选择技术栈和工具
+3. 制定实施计划
+4. 设计数据流和架构图
+5. 定义模块间的接口契约
+
+**输出**：设计文档（design document）
+
+**建议**：调用 `planner` Agent
+
+---
+
+## 阶段 3：实现（Implement）
+
+**角色**：Maker + Developer
+
+**目标**：按设计编写代码并集成。
+
+**步骤**：
+1. 按设计编写代码
+2. 编写单元测试
+3. 遵循编码规范
+4. 集成到主分支
+5. 编写清晰、可维护的代码
+
+**输出**：可运行的代码和测试
+
+**建议**：调用 `coder` 或 `feature-developer` Agent
+
+---
+
+## 阶段 4：评审（Review）
+
+**角色**：全员（Tech Lead 主导）
+
+**目标**：确保代码质量、安全性和可维护性。
+
+**步骤**：
+1. Code review（检查代码质量）
+2. 功能验收（Business 验证是否满足需求）
+3. 技术债评估（Architect 审查架构合理性）
+4. 安全性检查
+5. 性能评估
+
+**输出**：评审报告（review report）
+
+**建议**：调用 `reviewer` Agent
+
+---
+
+## 何时使用
+
+- 跨职能团队协作
+- 复杂功能需要多角色参与
+- 需要明确的职责划分
+- 用户故事级别的完整功能开发
+- Sprint 迭代开发
+- 端到端（end-to-end）功能实现
+
+## 决策规则
+
+- **简单功能**（complexity: simple）：只需实现阶段
+- **中等功能**（complexity: moderate）：设计 + 实现 + 评审
+- **复杂功能**（complexity: complex）：完整四阶段流程
+
+## 参考
+
+- BMAD Framework: https://bmad.dev
+- Four-Role Agile Development Methodology

package/dist/skills/official/official-db-schema-design.md

@@ -0,0 +1,16 @@
+---
+name: official-db-schema-design
+version: 1.0.0
+description: "数据库 Schema 设计：建模、迁移和演进最佳实践"
+tags: [database, schema, sql, migration]
+---
+
+# 数据库 Schema 设计
+
+## 设计原则
+- 先建模（ER 图），再建表
+- 每张表只表达一个实体
+- 外键约束在数据库层面强制
+
+## 命名规范
+- 表名：snake_case 复数（`

package/dist/skills/official/official-debug.md

@@ -0,0 +1,17 @@
+---
+name: official-debug
+version: 1.2.0
+description: "系统化调试工作流：复现、隔离、修复、验证"
+tags: [debug, troubleshooting]
+---
+
+# 系统化调试
+
+## 步骤
+
+1. **复现** — 确认 bug 可稳定复现
+   - 记录：环境、输入、期望行为、实际行为
+
+2. **隔离** — 缩小根因范围
+   - 二分法排查代码路径
+   - 检查近期变更（`

package/dist/skills/official/official-doc-driven.md

@@ -0,0 +1,31 @@
+---
+name: official-doc-driven
+version: 1.0.0
+description: "文档驱动开发：先写文档再写代码，保持文档与代码同步"
+tags: [documentation, doc-driven, readme]
+---
+
+# 文档驱动开发
+
+## 核心理念
+如果你无法清晰地写出来，说明你还没想清楚。先写文档，逼自己想清楚再动手。
+
+## 步骤
+
+1. **写 README 先于代码**
+   - 描述模块是什么、解决什么问题
+   - 写出使用示例（即使 API 还不存在）
+   - 示例写起来别扭 = 设计有问题
+
+2. **接口文档先于实现**
+   - 函数签名 + JSDoc/注释先写
+   - 参数、返回值、异常都要说明
+
+3. **保持同步**
+   - 代码变更时同步更新文档
+   - PR 模板加入"文档是否已更新"检查项
+
+## 文档层级
+- README：模块概述 + 快速开始
+- ARCHITECTURE.md：系统设计和关键决策
+- 代码注释：解释"为什么"，不解释"是什么"

package/dist/skills/official/official-harness-engineering.md

@@ -0,0 +1,108 @@
+---
+name: official-harness-engineering
+version: 2.0.1
+description: "Harness Engineering：为遗留代码建立测试防护网再安全修改（四阶段完整指南）"
+tags: [harness, testing, legacy, refactor]
+---
+
+# Harness Engineering 方法论
+
+当需要重构遗留代码（尤其是缺少测试的代码）时，按以下四阶段推进。
+
+## 核心理念
+
+在修改任何现有代码前，先建立测试防护网（harness），确保改动不破坏现有行为。
+
+## 与 TDD 的区别
+- TDD 用于新功能开发（先测试后实现）
+- Harness Engineering 用于改动现有代码（先理解后保护再修改）
+
+---
+
+## 阶段 1：理解现有实现（Understand）
+
+**目标**：深入理解代码的当前行为和依赖关系。
+
+**步骤**：
+1. 阅读目标代码，识别关键逻辑和边界条件
+2. 绘制依赖关系图（哪些模块依赖这段代码）
+3. 识别潜在的副作用和隐藏依赖
+4. 找到所有入口点和输出点
+5. 记录边界条件和隐含假设
+
+**输出**：行为文档（behavior document），记录当前实际行为
+
+**建议**：调用 `researcher` Agent 进行深度分析
+
+---
+
+## 阶段 2：建立特征测试（Characterize）
+
+**目标**：为现有行为建立测试"安全网"。
+
+**步骤**：
+1. 编写特征测试（Characterization Tests）— 记录当前行为，无论对错
+2. 覆盖所有已知的输入输出组合
+3. 覆盖所有主要代码路径
+4. 确保测试全绿（即使代码有 bug，先记录现状）
+5. 目标覆盖率 > 80%
+
+**关键原则**：
+- 测试描述"代码现在做什么"，不是"应该做什么"
+- 全部通过后才能继续下一阶段
+
+**建议**：调用 `tester` Agent 编写测试
+
+---
+
+## 阶段 3：安全重构（Refactor）
+
+**目标**：在测试保护下进行重构。
+
+**步骤**：
+1. 小步重构（每次改动后立即运行测试）
+2. 消除重复代码、提取函数、改善命名
+3. 保持测试全绿
+4. 每次只改一处，改完立即运行 harness
+5. 测试失败 = 立即回滚，不要积累未验证的变更
+
+**重构优先级**：
+- 消除重复代码
+- 提取函数和模块
+- 改善命名和注释
+- 简化复杂逻辑
+
+**建议**：调用 `refactor-specialist` Agent 执行重构
+
+---
+
+## 阶段 4：验证重构结果（Verify）
+
+**目标**：确认重构没有破坏功能。
+
+**步骤**：
+1. 运行完整测试套件
+2. 手动验证关键路径
+3. Code review
+4. 对比原始行为文档，确认行为一致性
+5. 逐步替换：新行为用新测试覆盖，旧 harness 逐步退役
+
+---
+
+## 何时使用
+
+- 遗留代码缺少测试
+- 代码复杂度高，不敢直接改
+- 需要大规模重构但风险高
+- 接手不熟悉的代码库
+- 修改高风险核心模块
+
+## 决策规则
+
+- **简单重构**（complexity: simple）：跳过理解阶段，直接建立特征测试
+- **中等重构**（complexity: moderate）：完整四阶段流程
+- **复杂迁移**（complexity: complex）：完整四阶段流程，额外谨慎
+
+## 参考
+
+- Michael Feathers, *Working Effectively with Legacy Code*

package/dist/skills/official/official-performance-optimization.md

@@ -0,0 +1,30 @@
+---
+name: official-performance-optimization
+version: 1.0.0
+description: "性能优化工作流：先度量再优化，数据驱动"
+tags: [performance, optimization, profiling]
+---
+
+# 性能优化
+
+## 黄金法则
+**永远先度量，再优化。** 没有数据的优化是猜测。
+
+## 步骤
+
+1. **建立基线** — 用真实数据测量当前性能
+   - 定义指标：延迟（P50/P95/P99）、吞吐量、内存
+
+2. **找瓶颈** — Profile，不要猜
+   - CPU：火焰图；内存：heap 分析；I/O：慢查询日志
+
+3. **优化** — 从收益最大的瓶颈开始
+   - 算法复杂度 > 减少 I/O > 缓存 > 并发
+
+4. **验证** — 对比基线，功能测试全部通过
+
+## 常见优化方向（按收益排序）
+- 数据库：索引、消除 N+1、连接池
+- 缓存：热点数据、计算结果
+- 异步化：I/O 密集型操作
+- 批处理：替代逐条处理

package/dist/skills/official/official-pr-review.md

@@ -0,0 +1,35 @@
+---
+name: official-pr-review
+version: 1.2.0
+description: "结构化 PR 审查：覆盖正确性、安全性和可维护性"
+tags: [review, pr, quality]
+---
+
+# Pull Request 审查
+
+## 审查顺序（重要性从高到低）
+
+### 1. 正确性
+- [ ] 逻辑在所有边界条件下正确
+- [ ] 错误处理恰当，异常不被静默吞掉
+- [ ] 无竞态条件或并发问题
+
+### 2. 安全性
+- [ ] 无注入漏洞（SQL、命令、XSS、SSRF）
+- [ ] 敏感数据未被日志记录或暴露
+- [ ] 权限检查在正确的层级
+
+### 3. 性能
+- [ ] 无 N+1 查询
+- [ ] 大数据量场景有分页或流式处理
+
+### 4. 可维护性
+- [ ] 代码可读，命名自文档化
+- [ ] 单一职责，函数不超过 40 行
+
+### 5. 测试
+- [ ] 新功能有对应测试
+- [ ] 边界条件有测试覆盖
+
+## 输出格式
+**[BLOCKER|MAJOR|MINOR]** `