speccore 6.82.0 → 6.89.0

package/dist/core/rule-loader.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * RULES 规范库加载器
+ *
+ * 负责：
+ * 1. 扫描 .speccore/RULES/ 目录下的规范定义文件
+ * 2. 根据技术栈（从 CONSTITUTION.md 解析）匹配对应的规范
+ * 3. 按优先级合并规范内容
+ * 4. 注入到代码生成 prompt 中
+ *
+ * v6.85.0+
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRulesForTechStack = resolveRulesForTechStack;
+exports.formatRulesPrompt = formatRulesPrompt;
+exports.getBuiltinRuleContents = getBuiltinRuleContents;
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const BUILTIN_RULES_DIR = (0, path_1.join)(__dirname, 'rules', 'defaults');
+/**
+ * 扫描目录下的规则文件
+ * 文件名即规则名（不含 .md），内容即规则定义
+ */
+async function scanRuleFiles(dir) {
+    if (!(await (0, fs_extra_1.pathExists)(dir)))
+        return [];
+    const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
+    const rules = [];
+    for (const e of entries) {
+        if (!e.isFile() || !e.name.endsWith('.md'))
+            continue;
+        if (e.name.startsWith('_'))
+            continue; // _INDEX.md, _TEMPLATE.md 跳过
+        const content = await (0, fs_extra_1.readFile)((0, path_1.join)(dir, e.name), 'utf-8');
+        rules.push({
+            name: e.name.replace(/\.md$/, ''),
+            content,
+        });
+    }
+    return rules;
+}
+/**
+ * 解析规则文件中的元信息
+ * 从 frontmatter 或特定章节提取 appliesTo 和 priority
+ */
+function parseRuleMeta(content) {
+    const appliesTo = [];
+    let priority = 50;
+    // 尝试从 frontmatter 解析
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n/);
+    if (frontmatterMatch) {
+        const fm = frontmatterMatch[1];
+        const appliesMatch = fm.match(/appliesTo:\s*\n((\s+-\s+.+\n)+)/);
+        if (appliesMatch) {
+            for (const line of appliesMatch[1].matchAll(/-\s+(.+)/g)) {
+                appliesTo.push(line[1].trim().toLowerCase());
+            }
+        }
+        const priorityMatch = fm.match(/priority:\s*(\d+)/);
+        if (priorityMatch)
+            priority = parseInt(priorityMatch[1], 10);
+    }
+    // 如果没有 frontmatter，尝试从标题推断 appliesTo
+    if (appliesTo.length === 0) {
+        const headingMatch = content.match(/^#\s+(.+)$/m);
+        if (headingMatch) {
+            const title = headingMatch[1].toLowerCase();
+            // 简单推断：文件名/标题中的技术关键词
+            const techKeywords = ['typescript', 'react', 'vue', 'angular', 'nodejs', 'java', 'go', 'python', 'spring', 'nestjs', 'gin', 'fastapi'];
+            for (const kw of techKeywords) {
+                if (title.includes(kw))
+                    appliesTo.push(kw);
+            }
+        }
+    }
+    return { appliesTo, priority };
+}
+/**
+ * 加载所有可用规则（内置 + 用户自定义，用户自定义覆盖）
+ */
+async function loadAllRules(projectRoot) {
+    const userRulesDir = (0, path_1.join)(projectRoot, '.speccore', 'RULES');
+    const ruleMap = new Map();
+    // 1. 加载内置默认
+    const builtinFiles = await scanRuleFiles(BUILTIN_RULES_DIR);
+    for (const f of builtinFiles) {
+        const meta = parseRuleMeta(f.content);
+        ruleMap.set(f.name, {
+            name: f.name,
+            content: f.content,
+            appliesTo: meta.appliesTo,
+            priority: meta.priority,
+        });
+    }
+    // 2. 用户自定义覆盖
+    const userFiles = await scanRuleFiles(userRulesDir);
+    for (const f of userFiles) {
+        const meta = parseRuleMeta(f.content);
+        ruleMap.set(f.name, {
+            name: f.name,
+            content: f.content,
+            appliesTo: meta.appliesTo,
+            priority: meta.priority,
+        });
+    }
+    return Array.from(ruleMap.values());
+}
+/**
+ * 根据技术栈标识符匹配适用的规则
+ *
+ * 技术栈标识符来自 CONSTITUTION.md 的解析结果，如：
+ * - 'typescript', 'react', 'nodejs', 'mysql'
+ * - 'java', 'spring-boot'
+ * - 'vue', 'pinia'
+ */
+async function resolveRulesForTechStack(techStackIdentifiers, projectRoot) {
+    const allRules = await loadAllRules(projectRoot);
+    const identifiers = techStackIdentifiers.map(s => s.toLowerCase());
+    const matched = allRules.filter(rule => {
+        // 规则匹配：任一标识符匹配即生效
+        return rule.appliesTo.some(tag => identifiers.includes(tag));
+    });
+    // 按优先级排序（高优先级在前）
+    matched.sort((a, b) => b.priority - a.priority);
+    return matched;
+}
+/**
+ * 将匹配的规则合并为单个 prompt 字符串
+ */
+function formatRulesPrompt(rules) {
+    if (rules.length === 0)
+        return '';
+    const sections = [];
+    sections.push('## 编码规范');
+    sections.push('');
+    sections.push('> 以下规范来自项目配置，必须严格遵守。');
+    sections.push('');
+    for (const rule of rules) {
+        // 只提取规则内容（去掉 frontmatter）
+        let content = rule.content;
+        content = content.replace(/^---\n[\s\S]*?\n---\n/, ''); // 移除 frontmatter
+        content = content.trim();
+        sections.push(`### ${rule.name}`);
+        sections.push('');
+        sections.push(content);
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+/**
+ * 获取内置规则的原始内容（用于 init 时复制到项目）
+ */
+async function getBuiltinRuleContents() {
+    return scanRuleFiles(BUILTIN_RULES_DIR);
+}
+//# sourceMappingURL=rule-loader.js.map

package/dist/core/rule-loader.js.map

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

package/dist/core/rules/defaults/_INDEX.md

@@ -0,0 +1,16 @@
+# RULES 注册表
+
+> 本文件列出所有可用规范及其适用的技术栈。
+> 新增规范后，在本文件中注册即可。
+
+| 规范文件 | 适用技术栈 | 优先级 | 说明 |
+|---------|-----------|--------|------|
+| typescript.md | typescript | 100 | TypeScript 类型安全与命名规范 |
+| react.md | react | 90 | React 组件设计与 Hooks 规范 |
+| vue.md | vue | 90 | Vue 组合式 API 与响应式规范 |
+| nodejs.md | nodejs, nestjs | 80 | Node.js / NestJS 服务端规范 |
+| api-design.md | api, rest, graphql | 70 | API 设计通用规范 |
+| testing.md | test, jest, vitest | 60 | 测试策略与用例规范 |
+| security.md | security | 100 | 安全编码强制规范 |
+| database.md | database, mysql, postgresql | 70 | 数据库设计与查询规范 |
+| frontend-common.md | frontend, web | 50 | 前端跨框架通用规范 |

package/dist/core/rules/defaults/api-design.md

@@ -0,0 +1,44 @@
+---
+appliesTo:
+  - api
+  - rest
+  - graphql
+priority: 70
+---
+
+# API 设计规范
+
+## 通用原则
+
+- **幂等性**：GET/PUT/DELETE 必须幂等；POST 非幂等但需防重放。
+- **版本控制**：URL 路径版本（`/api/v1/`）或 Header 版本（`Accept: application/vnd.api.v1+json`）。
+- **分页规范**：
+  ```
+  GET /api/v1/users?page=1&size=20
+  Response: { "data": [], "pagination": { "page": 1, "size": 20, "total": 100 } }
+  ```
+
+## 请求规范
+
+- **Content-Type**：JSON API 统一使用 `application/json`。
+- **字段命名**：camelCase（JavaScript/TypeScript）或 snake_case（Python/Java），全项目统一。
+- **批量操作**：使用 `POST /batch` 或 `PATCH` 批量更新，限制单次批量大小（最大 100）。
+
+## 响应规范
+
+- **成功响应**：HTTP 200 + 业务 code 0。
+- **错误响应**：HTTP 4xx/5xx + 结构化错误信息：
+  ```json
+  {
+    "code": 1001,
+    "message": "用户不存在",
+    "details": { "field": "userId", "issue": "not_found" }
+  }
+  ```
+- **空列表**：返回空数组 `[]`，不要返回 null 或 404。
+
+## 安全
+
+- **鉴权**：使用 JWT / OAuth2，Token 放在 `Authorization: Bearer <token>`。
+- **限流**：关键接口必须配置 Rate Limiting（如 100 req/min）。
+- **CORS**：显式配置允许的 Origin，禁止 `*` 在生产环境使用。

package/dist/core/rules/defaults/database.md

@@ -0,0 +1,37 @@
+---
+appliesTo:
+  - database
+  - mysql
+  - postgresql
+  - mongodb
+priority: 70
+---
+
+# 数据库规范
+
+## 命名规范
+
+- **表名**：snake_case，复数形式（如 `users`、`order_items`）。
+- **字段名**：snake_case，避免保留字。
+- **索引名**：`idx_{表名}_{字段名}`，唯一索引 `uk_{表名}_{字段名}`。
+- **外键名**：`fk_{表名}_{引用表名}`。
+
+## 表设计
+
+- **主键**：使用自增 INT/BIGINT 或 UUID，禁止业务字段做主键。
+- **时间戳**：每张表必须包含 `created_at` 和 `updated_at`。
+- **软删除**：使用 `deleted_at` 或 `is_deleted`，禁止物理删除业务数据。
+- **字段注释**：每个字段必须有注释说明用途和取值范围。
+
+## 查询规范
+
+- **SELECT 显式列名**：禁止 `SELECT *`，只查询需要的字段。
+- **索引使用**：WHERE、JOIN、ORDER BY 字段必须有索引，定期用 `EXPLAIN` 检查。
+- **大表策略**：单表超过 1000 万行必须考虑分表/分区/归档。
+- **批量操作**：IN 子句参数不超过 1000 个，大批量使用分批处理。
+
+## 迁移规范
+
+- **版本化**：所有 schema 变更通过迁移脚本执行（如 TypeORM migration、Flyway）。
+- **可回滚**：每个迁移必须有 `up()` 和 `down()`。
+- **数据安全**：生产环境迁移先备份，禁止直接 `DROP COLUMN`/`DROP TABLE`。

package/dist/core/rules/defaults/frontend-common.md

@@ -0,0 +1,38 @@
+---
+appliesTo:
+  - frontend
+  - web
+  - h5
+priority: 50
+---
+
+# 前端通用规范
+
+## 响应式设计
+
+- **移动端优先**：设计从移动端断点开始，逐步增强到桌面端。
+- **断点标准**：
+  - Mobile: < 768px
+  - Tablet: 768px - 1024px
+  - Desktop: > 1024px
+- **弹性布局**：优先使用 Flexbox / Grid，避免固定像素宽度。
+
+## 无障碍（a11y）
+
+- **语义化标签**：使用 `<header>`、`<nav>`、`<main>`、`<footer>` 等语义标签。
+- **表单关联**：`<label>` 必须通过 `for` 或嵌套关联到 `<input>`。
+- **焦点管理**：所有可交互元素必须有可见的焦点样式。
+- **ARIA**：复杂组件（如 Tabs、Modal）使用正确的 ARIA 角色和属性。
+- **颜色对比**：文本与背景对比度 ≥ 4.5:1（WCAG AA）。
+
+## 国际化（i18n）
+
+- **文本外置**：所有用户可见文本使用 i18n  key，禁止硬编码中文/英文。
+- **日期/数字**：使用 `Intl.DateTimeFormat`、`Intl.NumberFormat` 本地化。
+- **RTL**：布局支持从右到左（阿拉伯语、希伯来语）。
+
+## 性能
+
+- **图片优化**：使用 WebP/AVIF，提供响应式图片 `srcset`。
+- **代码分割**：路由级懒加载，组件级按需加载。
+- **资源缓存**：静态资源使用长期缓存（hash 文件名）。

package/dist/core/rules/defaults/nodejs.md

@@ -0,0 +1,38 @@
+---
+appliesTo:
+  - nodejs
+  - node
+  - nestjs
+  - express
+priority: 80
+---
+
+# Node.js / NestJS 服务端规范
+
+## API 设计
+
+- **RESTful 标准**：使用 HTTP 方法表达语义（GET/POST/PUT/DELETE/PATCH）。
+- **路由规范**：`/api/v{版本}/{模块}/{资源}`，如 `/api/v1/users`。
+- **状态码**：正确使用 HTTP 状态码（200/201/204/400/401/403/404/409/422/500）。
+- **统一响应格式**：
+  ```json
+  { "code": 0, "data": {}, "message": "ok" }
+  ```
+
+## 错误处理
+
+- **全局异常过滤器**：NestJS 使用 `ExceptionFilter`，Express 使用中间件。
+- **业务异常**：自定义 `BusinessException`，必须包含错误码和可读消息。
+- **不暴露内部错误**：生产环境不返回堆栈信息。
+
+## 依赖注入
+
+- **NestJS**：优先使用构造函数注入，避免 `@Inject()` 字符串令牌。
+- **分层架构**：Controller → Service → Repository，禁止跨层调用。
+- **接口隔离**：Service 层面向接口编程，便于测试和替换。
+
+## 数据访问
+
+- **ORM 优先**：使用 TypeORM / Prisma / Sequelize，禁止裸写 SQL（复杂查询除外）。
+- **事务边界**：多表操作必须使用事务，通过装饰器或显式事务管理。
+- **N+1 防护**：使用 `relations` + `select` 或 DataLoader 避免 N+1 查询。

package/dist/core/rules/defaults/react.md

@@ -0,0 +1,34 @@
+---
+appliesTo:
+  - react
+  - reactjs
+priority: 90
+---
+
+# React 组件规范
+
+## 组件设计
+
+- **函数组件优先**：所有新组件使用函数组件 + Hooks。
+- **单一职责**：一个组件只负责一个功能，超过 200 行必须拆分。
+- **Props 接口**：必须定义 `interface Props`，禁止用 `any`。
+- **默认导出**：页面级组件默认导出，业务组件命名导出。
+
+## Hooks 规范
+
+- **自定义 Hooks**：复用逻辑必须抽成自定义 Hook，以 `use` 开头。
+- **依赖数组**：`useEffect`、`useMemo`、`useCallback` 的依赖数组必须完整。
+- **禁止在循环/条件中调用 Hooks**。
+- **清理副作用**：`useEffect` 返回清理函数（订阅、定时器、事件监听）。
+
+## 状态管理
+
+- **局部状态优先**：能用 `useState` 就不用全局状态。
+- **全局状态**：使用 Context + useReducer 或 Redux/Zustand，禁止 prop drilling 超过 3 层。
+- **表单状态**：复杂表单使用 React Hook Form 或 Formik。
+
+## 性能
+
+- **.memo 使用**：仅对纯展示组件且接收复杂 props 时使用。
+- **懒加载**：路由级组件使用 `React.lazy()` + `Suspense`。
+- **避免内联对象/函数**：作为 props 传递时会导致不必要的重渲染。

package/dist/core/rules/defaults/security.md

@@ -0,0 +1,31 @@
+---
+appliesTo:
+  - security
+priority: 100
+---
+
+# 安全编码规范
+
+## 输入验证
+
+- **不信任任何输入**：所有用户输入必须校验（长度、类型、范围、格式）。
+- **白名单校验**：优先使用允许列表（白名单），而非禁止列表（黑名单）。
+- **参数化查询**：数据库查询必须使用参数化/预处理语句，禁止字符串拼接 SQL。
+
+## 认证与授权
+
+- **最小权限原则**：每个接口明确所需权限，默认拒绝。
+- **敏感操作二次确认**：资金操作、数据删除等需要额外验证（如短信/密码）。
+- **Token 安全**：JWT 设置合理过期时间（Access Token 15min，Refresh Token 7d），使用 HTTPS 传输。
+
+## 数据保护
+
+- **敏感数据加密**：密码使用 bcrypt/argon2，身份证号/银行卡号使用 AES-256 加密存储。
+- **日志脱敏**：日志中不出现明文密码、Token、身份证号。
+- **防泄漏**：错误响应不暴露堆栈、数据库结构、内部路径。
+
+## 常见漏洞防护
+
+- **XSS**：输出到 DOM 前转义，使用框架内置的 XSS 防护（React/Vue 自动转义）。
+- **CSRF**：状态变更操作使用 CSRF Token 或 SameSite Cookie。
+- **文件上传**：限制文件类型（白名单）、大小、存储路径（禁止执行权限）。

package/dist/core/rules/defaults/testing.md

@@ -0,0 +1,35 @@
+---
+appliesTo:
+  - test
+  - jest
+  - vitest
+  - testing
+priority: 60
+---
+
+# 测试规范
+
+## 测试策略
+
+- **测试金字塔**：单元测试（70%）→ 集成测试（20%）→ E2E 测试（10%）。
+- **覆盖目标**：核心业务逻辑覆盖率 ≥ 80%，分支覆盖率 ≥ 70%。
+- **测试文件名**：`{module}.test.ts` 或 `{module}.spec.ts`，与源码同目录或 `__tests__/` 下。
+
+## 单元测试
+
+- **独立性**：每个测试用例独立，不依赖执行顺序。
+- **Arrange-Act-Assert**：三段式结构清晰。
+- **Mock 外部依赖**：HTTP 请求、数据库、文件系统必须 Mock。
+- **命名规范**：`should {预期行为} when {条件}`，如 `should return 401 when token is expired`。
+
+## 集成测试
+
+- **真实依赖**：使用测试数据库（如 SQLite 内存 / TestContainers）。
+- **环境隔离**：每个测试套件前清理数据，后回滚事务。
+- **API 契约**：验证请求/响应格式符合 OpenAPI 定义。
+
+## 禁止
+
+- 不在测试中写逻辑（如 if/for），只调用和断言。
+- 不测试第三方库（如测试 `lodash` 的 `debounce`）。
+- 不提交 `.only`、`.skip` 到主分支。

package/dist/core/rules/defaults/typescript.md

@@ -0,0 +1,36 @@
+---
+appliesTo:
+  - typescript
+  - ts
+priority: 100
+---
+
+# TypeScript 编码规范
+
+## 类型安全
+
+- **禁止 `any`**：除非与第三方库交互，否则不使用 `any`。使用 `unknown` + 类型守卫替代。
+- **禁止 `@ts-ignore`**：必须使用 `@ts-expect-error` 并附注释说明原因。
+- **严格模式**：项目必须开启 `strict: true`。
+- **显式返回类型**：公共 API 函数必须声明返回类型。
+
+## 命名规范
+
+- 类型/接口：`PascalCase`（如 `UserProfile`）
+- 变量/函数：`camelCase`（如 `getUserName`）
+- 常量：`UPPER_SNAKE_CASE`（如 `MAX_RETRY_COUNT`）
+- 枚举：`PascalCase`，成员 `UPPER_SNAKE_CASE`
+- 布尔变量：使用 `is`、`has`、`should` 前缀（如 `isLoading`）
+
+## 模块组织
+
+- 一个文件一个核心导出（类/函数/组件）
+- 工具函数按领域分组（`utils/validation.ts`、`utils/date.ts`）
+-  barrel export 使用 `index.ts` 统一暴露模块公共 API
+- 禁止循环依赖
+
+## 异步规范
+
+- 优先使用 `async/await`，避免回调地狱
+- Promise 链必须有 `.catch()` 或 `try/catch`
+- 并行请求使用 `Promise.all()`，但注意错误处理

package/dist/core/skill-loader.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SKILLS 可复用技能库加载器
+ *
+ * 负责：
+ * 1. 扫描 .speccore/SKILLS/ 目录下的技能定义文件
+ * 2. 根据任务类型/关键词匹配对应的技能
+ * 3. 注入到代码生成 prompt 中
+ *
+ * v6.88.0+
+ */
+export interface SkillDefinition {
+    name: string;
+    content: string;
+    tags: string[];
+}
+/**
+ * 根据任务关键词匹配适用的技能
+ */
+export declare function resolveSkillsForTask(taskKeywords: string[], projectRoot: string): Promise<SkillDefinition[]>;
+/**
+ * 将匹配的技能合并为 prompt 字符串
+ */
+export declare function formatSkillsPrompt(skills: SkillDefinition[]): string;
+export declare function getBuiltinSkillContents(): Promise<{
+    name: string;
+    content: string;
+}[]>;
+//# sourceMappingURL=skill-loader.d.ts.map

package/dist/core/skill-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/core/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AA0DD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,EAAE,CAAC,CAS5B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAqBpE;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAE5F"}

package/dist/core/skill-loader.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * SKILLS 可复用技能库加载器
+ *
+ * 负责：
+ * 1. 扫描 .speccore/SKILLS/ 目录下的技能定义文件
+ * 2. 根据任务类型/关键词匹配对应的技能
+ * 3. 注入到代码生成 prompt 中
+ *
+ * v6.88.0+
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSkillsForTask = resolveSkillsForTask;
+exports.formatSkillsPrompt = formatSkillsPrompt;
+exports.getBuiltinSkillContents = getBuiltinSkillContents;
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const BUILTIN_SKILLS_DIR = (0, path_1.join)(__dirname, 'skills', 'defaults');
+async function scanSkillFiles(dir) {
+    if (!(await (0, fs_extra_1.pathExists)(dir)))
+        return [];
+    const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
+    const skills = [];
+    for (const e of entries) {
+        if (!e.isFile() || !e.name.endsWith('.md'))
+            continue;
+        if (e.name.startsWith('_'))
+            continue;
+        const content = await (0, fs_extra_1.readFile)((0, path_1.join)(dir, e.name), 'utf-8');
+        skills.push({
+            name: e.name.replace(/\.md$/, ''),
+            content,
+        });
+    }
+    return skills;
+}
+function parseSkillMeta(content) {
+    const tags = [];
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n/);
+    if (frontmatterMatch) {
+        const fm = frontmatterMatch[1];
+        const tagsMatch = fm.match(/tags:\s*\n((\s+-\s+.+\n)+)/);
+        if (tagsMatch) {
+            for (const line of tagsMatch[1].matchAll(/-\s+(.+)/g)) {
+                tags.push(line[1].trim().toLowerCase());
+            }
+        }
+    }
+    return { tags };
+}
+async function loadAllSkills(projectRoot) {
+    const userSkillsDir = (0, path_1.join)(projectRoot, '.speccore', 'SKILLS');
+    const skillMap = new Map();
+    const builtinFiles = await scanSkillFiles(BUILTIN_SKILLS_DIR);
+    for (const f of builtinFiles) {
+        const meta = parseSkillMeta(f.content);
+        skillMap.set(f.name, { name: f.name, content: f.content, tags: meta.tags });
+    }
+    const userFiles = await scanSkillFiles(userSkillsDir);
+    for (const f of userFiles) {
+        const meta = parseSkillMeta(f.content);
+        skillMap.set(f.name, { name: f.name, content: f.content, tags: meta.tags });
+    }
+    return Array.from(skillMap.values());
+}
+/**
+ * 根据任务关键词匹配适用的技能
+ */
+async function resolveSkillsForTask(taskKeywords, projectRoot) {
+    const allSkills = await loadAllSkills(projectRoot);
+    const keywords = taskKeywords.map(s => s.toLowerCase());
+    const matched = allSkills.filter(skill => {
+        return skill.tags.some(tag => keywords.some(kw => kw.includes(tag) || tag.includes(kw)));
+    });
+    return matched;
+}
+/**
+ * 将匹配的技能合并为 prompt 字符串
+ */
+function formatSkillsPrompt(skills) {
+    if (skills.length === 0)
+        return '';
+    const sections = [];
+    sections.push('## 可复用技能参考');
+    sections.push('');
+    sections.push('> 以下技能指南供参考，按需应用。');
+    sections.push('');
+    for (const skill of skills) {
+        let content = skill.content;
+        content = content.replace(/^---\n[\s\S]*?\n---\n/, '');
+        content = content.trim();
+        sections.push(`### ${skill.name}`);
+        sections.push('');
+        sections.push(content);
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+async function getBuiltinSkillContents() {
+    return scanSkillFiles(BUILTIN_SKILLS_DIR);
+}
+//# sourceMappingURL=skill-loader.js.map

package/dist/core/skill-loader.js.map

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

package/dist/core/skills/defaults/caching.md

@@ -0,0 +1,33 @@
+---
+tags:
+  - cache
+  - redis
+  - performance
+  - memoization
+---
+
+# 缓存技能
+
+## 缓存策略
+
+| 策略 | 适用场景 | 缺点 |
+|------|---------|------|
+| Cache-Aside | 读多写少 | 首次读取慢 |
+| Write-Through | 强一致性要求 | 写延迟增加 |
+| Write-Behind | 高写入吞吐量 | 数据丢失风险 |
+| Read-Through | 简化应用逻辑 | 缓存 miss 时延迟高 |
+
+## Redis 最佳实践
+
+1. **Key 命名空间**：`service:entity:id:field`，如 `user:profile:1234:email`
+2. **TTL 设置**：根据数据变化频率设置合理过期时间
+3. **序列化**：使用 JSON 或 MessagePack，避免存储对象引用
+4. **连接池**：使用连接池管理 Redis 连接
+5. **缓存穿透**：对不存在 key 设置空值缓存（短 TTL）
+6. **缓存雪崩**：设置随机 TTL 偏移量
+
+## 本地缓存
+
+- Node.js：使用 `lru-cache` 或 `node-cache`
+- 前端：使用 `React.memo`、`useMemo`、`useCallback`
+- 限制：本地缓存仅存放热点数据，大小不超过 100MB