ethan-skill 1.11.0 → 1.13.0

package/dist/skills/27-tech-debt.d.ts

@@ -0,0 +1,3 @@
+import type { SkillDefinition } from './types';
+export declare const techDebtSkill: SkillDefinition;
+//# sourceMappingURL=27-tech-debt.d.ts.map

package/dist/skills/27-tech-debt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"27-tech-debt.d.ts","sourceRoot":"","sources":["../../src/skills/27-tech-debt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,aAAa,EAAE,eAgJ3B,CAAC"}

package/dist/skills/27-tech-debt.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.techDebtSkill = void 0;
+exports.techDebtSkill = {
+    id: 'tech-debt',
+    name: '技术债追踪',
+    nameEn: 'tech_debt',
+    order: 27,
+    description: '识别、量化、排序技术债，生成偿还路线图与预防机制',
+    descriptionEn: 'Identify, quantify and prioritize technical debt, generate repayment roadmap and prevention mechanisms',
+    detailDescription: `技术债如同金融债务，越早偿还利息越低。
+本 Skill 帮助团队系统化地识别代码库中的技术债（TODO/FIXME 聚集、高圈复杂度、重复代码、高耦合模块），
+通过"影响 × 修复成本"矩阵量化优先级，生成可落地的 Sprint 偿还计划，
+并建立长效预防机制，让技术债不再悄悄累积。`,
+    triggers: [
+        '技术债',
+        'tech debt',
+        'technical debt',
+        '技术债追踪',
+        '技术债偿还',
+        'code smell',
+        '代码腐化',
+        '@ethan tech-debt',
+        '/tech-debt',
+    ],
+    steps: [
+        {
+            title: '1. 技术债识别与分类',
+            content: `扫描代码库，从以下维度识别技术债：
+
+**四大技术债类型**
+
+| 类型 | 检测手段 | 典型表现 |
+|------|---------|---------|
+| **代码债** | TODO/FIXME/HACK 注释统计 | 注释标记超过 50 个/千行 |
+| **设计债** | 圈复杂度 > 10，类长度 > 500 行 | 上帝类、面条代码、深层继承 |
+| **测试债** | 覆盖率 < 60%，测试缺失模块 | 核心模块无测试，回归靠手工 |
+| **依赖债** | 过时依赖、已弃用 API 调用 | 主版本落后 2+ 个版本 |
+
+**识别命令参考**
+\`\`\`bash
+# 统计 TODO/FIXME
+grep -rn "TODO\\|FIXME\\|HACK\\|XXX" src/ --include="*.ts" | wc -l
+
+# 查找超长文件
+find src -name "*.ts" | xargs wc -l | sort -rn | head -20
+
+# 重复代码检测（需安装 jscpd）
+npx jscpd src/ --min-lines 5 --reporters json
+\`\`\`
+
+**输出**：技术债清单（分类 + 位置 + 初步评估）`,
+        },
+        {
+            title: '2. 债务量化评估',
+            content: `用"影响度 × 修复成本"矩阵评估每项技术债的优先级：
+
+**评分维度**
+
+| 维度 | 1分（低） | 3分（中） | 5分（高） |
+|------|---------|---------|---------|
+| **业务影响** | 边缘功能 | 常用功能 | 核心链路 |
+| **出错频率** | 极少触发 | 偶尔出现 | 频繁发生 |
+| **修复成本** | < 0.5天 | 0.5~2天 | > 2天 |
+| **扩散风险** | 独立模块 | 少量依赖 | 多处依赖 |
+
+**优先级 = 影响度（业务影响 × 出错频率） ÷ 修复成本**
+
+**T恤 Size 对照**
+- 🔴 **Critical（>8分）**：阻碍新功能开发，必须本 Sprint 处理
+- 🟠 **High（5-8分）**：影响团队效率，下个 Sprint 安排
+- 🟡 **Medium（3-5分）**：纳入季度技术改进计划
+- 🟢 **Low（<3分）**：有时间再处理，记录即可
+
+**输出**：技术债优先级矩阵（标注 T恤 Size）`,
+        },
+        {
+            title: '3. 偿还路线图',
+            content: `按"高影响、低成本"优先原则，制定可落地的偿还计划：
+
+**Sprint 规划原则**
+- 每个 Sprint 分配 **15-20% 时间**用于技术债偿还（债务预算）
+- Critical 债务：独立 Story，本 Sprint 必须完成
+- High 债务：与新功能并行，2 个 Sprint 内完成
+- Medium 债务：季度 Hackathon 集中处理
+
+**路线图模板**
+\`\`\`
+Sprint N（当前）
+  🔴 [Critical] 拆分 UserService 上帝类 → 3个子服务    2天
+  🔴 [Critical] 修复登录模块 XXX 标记的并发 Bug         1天
+
+Sprint N+1
+  🟠 [High] 提升 Payment 模块测试覆盖率至 80%          2天
+  🟠 [High] 替换废弃的 axios v0.21 → v1.x              1天
+
+Q+1 季度计划
+  🟡 [Medium] 重构订单模块（圈复杂度>15的5个函数）      5天
+  🟡 [Medium] 清理 87 个 TODO 注释并创建对应 Issue     3天
+\`\`\`
+
+**输出**：按 Sprint 排期的技术债偿还路线图`,
+        },
+        {
+            title: '4. 预防机制',
+            content: `建立长效机制，让技术债不再悄悄累积：
+
+**自动化门禁（CI/CD 集成）**
+\`\`\`yaml
+# .github/workflows/debt-check.yml
+- name: 技术债扫描
+  run: |
+    # TODO 数量检查
+    TODO_COUNT=$(grep -rn "TODO\\|FIXME" src/ | wc -l)
+    if [ $TODO_COUNT -gt $TODO_THRESHOLD ]; then
+      echo "❌ TODO 数量超过阈值: $TODO_COUNT > $TODO_THRESHOLD"
+      exit 1
+    fi
+    # 圈复杂度检查（使用 complexity-report 或 ESLint）
+    npx eslint src/ --rule '{"complexity": ["error", 10]}'
+\`\`\`
+
+**团队规范**
+- **Boy Scout 原则**：离开时让代码比你来时更干净（每次 PR 消灭 1 个技术债）
+- **TODO 转 Issue**：所有 TODO 必须关联 GitHub Issue，不得孤立存在
+- **债务预算制度**：每个 Sprint 强制预留 15% 时间偿还债务
+- **月度债务评审**：每月 Review 技术债清单，更新优先级
+
+**技术债仪表盘指标**
+- TODO/FIXME 总数趋势（目标：每月下降 10%）
+- 平均圈复杂度（目标：< 8）
+- 测试覆盖率（目标：> 80%）
+- 依赖过时率（目标：0 个 Critical 漏洞）
+
+**输出**：CI 门禁配置 + 团队规范文档 + 仪表盘指标定义`,
+        },
+    ],
+    outputFormat: '技术债地图（分级清单）+ 优先级矩阵（影响×成本）+ Sprint 偿还路线图 + CI 门禁配置 + 预防规范',
+    examples: [],
+    notes: [
+        '技术债不是"坏代码"，是在特定时间压力下做出的有意识权衡，关键是要记录并计划偿还',
+        '建议在项目初期就建立债务预算制度（15-20% Sprint 时间），而不是等到债务失控再处理',
+        '优先处理"高影响低成本"的债务，避免在低价值债务上耗费资源',
+        '技术债清单应纳入项目文档，让所有成员可见，避免只有架构师知道',
+    ],
+    category: '质量侧',
+    nextSkill: 'refactoring',
+};
+//# sourceMappingURL=27-tech-debt.js.map

package/dist/skills/27-tech-debt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"27-tech-debt.js","sourceRoot":"","sources":["../../src/skills/27-tech-debt.ts"],"names":[],"mappings":";;;AAEa,QAAA,aAAa,GAAoB;IAC5C,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,0BAA0B;IACvC,aAAa,EAAE,wGAAwG;IACvH,iBAAiB,EAAE;;;sBAGC;IACpB,QAAQ,EAAE;QACR,KAAK;QACL,WAAW;QACX,gBAAgB;QAChB,OAAO;QACP,OAAO;QACP,YAAY;QACZ,MAAM;QACN,kBAAkB;QAClB,YAAY;KACb;IACD,KAAK,EAAE;QACL;YACE,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;6BAuBc;SACxB;QACD;YACE,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;4BAmBa;SACvB;QACD;YACE,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;4BAuBa;SACvB;QACD;YACE,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCA6BmB;SAC7B;KACF;IACD,YAAY,EAAE,0DAA0D;IACxE,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE;QACL,0CAA0C;QAC1C,iDAAiD;QACjD,+BAA+B;QAC/B,gCAAgC;KACjC;IACD,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,aAAa;CACzB,CAAC"}

package/dist/skills/28-api-mock.d.ts

@@ -0,0 +1,3 @@
+import type { SkillDefinition } from './types';
+export declare const apiMockSkill: SkillDefinition;
+//# sourceMappingURL=28-api-mock.d.ts.map

package/dist/skills/28-api-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"28-api-mock.d.ts","sourceRoot":"","sources":["../../src/skills/28-api-mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,YAAY,EAAE,eA2Q1B,CAAC"}

package/dist/skills/28-api-mock.js

@@ -0,0 +1,272 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiMockSkill = void 0;
+exports.apiMockSkill = {
+    id: 'api-mock',
+    name: 'API Mock 服务',
+    nameEn: 'api_mock',
+    order: 28,
+    description: '根据接口定义生成 MSW/JSON Server Mock 配置，支持动态数据与边界场景模拟',
+    descriptionEn: 'Generate MSW/JSON Server mock configs from API specs, supporting dynamic data and edge case simulation',
+    detailDescription: `前后端并行开发的核心痛点是接口未就绪时前端无法推进。
+本 Skill 帮助团队快速搭建 Mock 服务：从 OpenAPI/Swagger 或接口描述生成 MSW handlers、
+JSON Server 配置，集成 faker.js 生成真实感测试数据，并模拟网络错误、超时、边界场景，
+让前端开发完全不依赖后端进度。`,
+    triggers: [
+        'api mock',
+        'mock service',
+        'mock 服务',
+        '接口 mock',
+        'msw',
+        'json server',
+        'mock 数据',
+        '接口模拟',
+        '@ethan api-mock',
+        '/api-mock',
+    ],
+    steps: [
+        {
+            title: '1. 接口分析与 Mock 范围确定',
+            content: `分析需要 Mock 的接口，建立清单：
+
+**接口信息收集**
+- OpenAPI/Swagger 文档路径（如 \`api/swagger.json\`）
+- 手工接口描述（方法、路径、请求/响应结构）
+- 需要模拟的特殊场景（401/403/500/超时/慢响应）
+
+**Mock 范围分类**
+\`\`\`
+📋 待 Mock 接口清单
+├── 认证接口
+│   ├── POST /api/auth/login        ← 成功 / 密码错误 / 账号锁定
+│   └── POST /api/auth/refresh      ← 成功 / token 过期
+├── 用户接口
+│   ├── GET  /api/users             ← 列表 / 空列表 / 分页
+│   └── GET  /api/users/:id         ← 成功 / 404
+└── 业务接口
+    ├── POST /api/orders            ← 成功 / 库存不足 / 支付失败
+    └── GET  /api/orders?status=... ← 各状态过滤
+\`\`\`
+
+**输出**：接口 Mock 清单（含边界场景枚举）`,
+        },
+        {
+            title: '2. Mock 方案选型',
+            content: `根据项目特点选择最合适的 Mock 方案：
+
+**选型矩阵**
+
+| 方案 | 适用场景 | 优点 | 缺点 |
+|------|---------|------|------|
+| **MSW（推荐）** | React/Vue 前端项目 | 拦截真实网络请求，零侵入，支持 Jest/Vitest | 需要 Service Worker |
+| **JSON Server** | REST API 快速原型 | 零代码，自动 CRUD | 功能有限，不支持复杂逻辑 |
+| **Mirage.js** | Ember/复杂 SPA | 内置数据库，关系模型支持 | 包较大，配置复杂 |
+| **Nock** | Node.js 单元测试 | 精确控制 HTTP 请求 | 仅限 Node 环境 |
+
+**推荐组合**：
+- 开发阶段：**MSW**（浏览器端拦截）
+- 单元测试：**MSW + @mswjs/data**（内存数据库）
+- 快速原型：**JSON Server**（5分钟启动）
+
+**输出**：选型决策 + 安装命令`,
+        },
+        {
+            title: '3. MSW handlers 生成',
+            content: `生成 MSW（Mock Service Worker）拦截处理器：
+
+**安装**
+\`\`\`bash
+npm install msw --save-dev
+npx msw init public/ --save
+\`\`\`
+
+**handlers.ts 模板**
+\`\`\`typescript
+// src/mocks/handlers.ts
+import { http, HttpResponse, delay } from 'msw';
+import { faker } from '@faker-js/faker';
+
+export const handlers = [
+  // ─── 认证接口 ──────────────────────────────────────
+  http.post('/api/auth/login', async ({ request }) => {
+    const { email, password } = await request.json() as any;
+
+    // 模拟特殊场景
+    if (password === 'wrong') {
+      return HttpResponse.json(
+        { code: 401, message: '密码错误' },
+        { status: 401 }
+      );
+    }
+    if (email === 'locked@test.com') {
+      return HttpResponse.json(
+        { code: 423, message: '账号已锁定，请联系管理员' },
+        { status: 423 }
+      );
+    }
+
+    // 正常响应
+    return HttpResponse.json({
+      token: faker.string.uuid(),
+      user: { id: faker.string.uuid(), email, name: faker.person.fullName() },
+    });
+  }),
+
+  // ─── 用户列表（分页）──────────────────────────────
+  http.get('/api/users', ({ request }) => {
+    const url = new URL(request.url);
+    const page = Number(url.searchParams.get('page') ?? 1);
+    const pageSize = Number(url.searchParams.get('pageSize') ?? 10);
+
+    const total = 87;
+    const items = Array.from({ length: Math.min(pageSize, total - (page - 1) * pageSize) }, () => ({
+      id: faker.string.uuid(),
+      name: faker.person.fullName(),
+      email: faker.internet.email(),
+      createdAt: faker.date.past().toISOString(),
+    }));
+
+    return HttpResponse.json({ items, total, page, pageSize });
+  }),
+
+  // ─── 慢响应模拟 ────────────────────────────────────
+  http.get('/api/slow-endpoint', async () => {
+    await delay(3000); // 模拟 3 秒延迟
+    return HttpResponse.json({ data: 'slow response' });
+  }),
+
+  // ─── 网络错误模拟 ──────────────────────────────────
+  http.get('/api/network-error', () => {
+    return HttpResponse.error(); // 模拟网络断开
+  }),
+];
+\`\`\`
+
+**browser.ts（浏览器初始化）**
+\`\`\`typescript
+// src/mocks/browser.ts
+import { setupWorker } from 'msw/browser';
+import { handlers } from './handlers';
+export const worker = setupWorker(...handlers);
+\`\`\`
+
+**server.ts（Node.js/测试环境）**
+\`\`\`typescript
+// src/mocks/server.ts
+import { setupServer } from 'msw/node';
+import { handlers } from './handlers';
+export const server = setupServer(...handlers);
+\`\`\`
+
+**输出**：完整 handlers.ts + browser.ts + server.ts`,
+        },
+        {
+            title: '4. JSON Server 配置',
+            content: `生成 JSON Server 快速 REST Mock 配置：
+
+**安装与启动**
+\`\`\`bash
+npm install json-server --save-dev
+# 启动：json-server --watch db.json --port 3001 --routes routes.json
+\`\`\`
+
+**db.json（数据库）**
+\`\`\`json
+{
+  "users": [
+    { "id": "1", "name": "张三", "email": "zhang@test.com", "role": "admin" },
+    { "id": "2", "name": "李四", "email": "li@test.com", "role": "user" }
+  ],
+  "orders": [
+    { "id": "101", "userId": "1", "status": "pending", "amount": 299.00, "createdAt": "2024-01-15" },
+    { "id": "102", "userId": "2", "status": "completed", "amount": 599.00, "createdAt": "2024-01-16" }
+  ],
+  "products": [
+    { "id": "P001", "name": "商品A", "price": 99.00, "stock": 100 }
+  ]
+}
+\`\`\`
+
+**routes.json（路由重写）**
+\`\`\`json
+{
+  "/api/*": "/$1",
+  "/api/v1/*": "/$1",
+  "/api/users/:id/orders": "/orders?userId=:id"
+}
+\`\`\`
+
+**package.json 脚本**
+\`\`\`json
+{
+  "scripts": {
+    "mock": "json-server --watch src/mocks/db.json --port 3001 --routes src/mocks/routes.json",
+    "dev:mock": "concurrently \\"npm run mock\\" \\"npm run dev\\""
+  }
+}
+\`\`\`
+
+**输出**：db.json + routes.json + npm 脚本`,
+        },
+        {
+            title: '5. 动态数据与边界场景策略',
+            content: `用 faker.js 生成真实感数据，覆盖各类边界场景：
+
+**faker.js 常用生成器速查**
+\`\`\`typescript
+import { faker } from '@faker-js/faker/locale/zh_CN'; // 中文数据
+
+// 个人信息
+faker.person.fullName()          // 王小明
+faker.internet.email()           // user@example.com
+faker.phone.number()             // 138-1234-5678
+faker.date.birthdate()           // 生日
+
+// 地址
+faker.location.city()            // 上海
+faker.location.streetAddress()   // 延安路 123 号
+
+// 业务数据
+faker.string.uuid()              // UUID
+faker.number.int({ min:1, max:100 })  // 随机整数
+faker.helpers.arrayElement(['pending', 'active', 'closed'])  // 随机枚举
+faker.helpers.multiple(() => faker.person.fullName(), { count: 10 })  // 批量生成
+\`\`\`
+
+**边界场景 Checklist**
+- [ ] 空列表（返回 \`{ items: [], total: 0 }\`）
+- [ ] 单条数据（边界分页）
+- [ ] 超长字符串（名称 > 100 字符）
+- [ ] 特殊字符（\`<script>\`、SQL 注入字符串）
+- [ ] 极大数字（金额 = 999999999.99）
+- [ ] 时区边界（UTC+8 vs UTC）
+- [ ] 并发响应竞态（两个请求同时返回）
+- [ ] 401 token 过期 → 自动刷新
+- [ ] 503 服务不可用 → 降级 UI
+
+**测试集成（Vitest）**
+\`\`\`typescript
+// setupTests.ts
+import { beforeAll, afterEach, afterAll } from 'vitest';
+import { server } from './mocks/server';
+
+beforeAll(() => server.listen({ onUnhandledRequest: 'warn' }));
+afterEach(() => server.resetHandlers()); // 每个测试后重置
+afterAll(() => server.close());
+\`\`\`
+
+**输出**：faker 数据工厂函数 + 边界场景 handlers + 测试集成配置`,
+        },
+    ],
+    outputFormat: 'Mock 方案选型报告 + MSW handlers.ts + JSON Server db.json/routes.json + faker 数据工厂 + 边界场景 Checklist + 测试集成配置',
+    examples: [],
+    notes: [
+        'MSW 是目前最推荐的前端 Mock 方案，可在浏览器和 Node.js 两种环境无缝切换',
+        'Mock 数据应尽量真实（使用 faker.js），避免 "test"/"demo" 等无意义数据干扰开发体验',
+        '边界场景的 Mock 与正常流程同等重要，建议用命名 handler（override）覆写特定测试场景',
+        '生产环境应通过环境变量完全关闭 Mock，避免意外拦截真实请求',
+    ],
+    category: '执行侧',
+    nextSkill: 'unit-testing',
+};
+//# sourceMappingURL=28-api-mock.js.map

package/dist/skills/28-api-mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"28-api-mock.js","sourceRoot":"","sources":["../../src/skills/28-api-mock.ts"],"names":[],"mappings":";;;AAEa,QAAA,YAAY,GAAoB;IAC3C,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,gDAAgD;IAC7D,aAAa,EAAE,wGAAwG;IACvH,iBAAiB,EAAE;;;gBAGL;IACd,QAAQ,EAAE;QACR,UAAU;QACV,cAAc;QACd,SAAS;QACT,SAAS;QACT,KAAK;QACL,aAAa;QACb,SAAS;QACT,MAAM;QACN,iBAAiB;QACjB,WAAW;KACZ;IACD,KAAK,EAAE;QACL;YACE,KAAK,EAAE,oBAAoB;YAC3B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;2BAqBY;SACtB;QACD;YACE,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE;;;;;;;;;;;;;;;;mBAgBI;SACd;QACD;YACE,KAAK,EAAE,oBAAoB;YAC3B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CAsFgC;SAC1C;QACD;YACE,KAAK,EAAE,mBAAmB;YAC1B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA4CuB;SACjC;QACD;YACE,KAAK,EAAE,gBAAgB;YACvB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6CA6C8B;SACxC;KACF;IACD,YAAY,EAAE,wGAAwG;IACtH,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE;QACL,+CAA+C;QAC/C,yDAAyD;QACzD,sDAAsD;QACtD,iCAAiC;KAClC;IACD,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,cAAc;CAC1B,CAAC"}

package/dist/skills/29-data-migration.d.ts

@@ -0,0 +1,3 @@
+import type { SkillDefinition } from './types';
+export declare const dataMigrationSkill: SkillDefinition;
+//# sourceMappingURL=29-data-migration.d.ts.map

package/dist/skills/29-data-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"29-data-migration.d.ts","sourceRoot":"","sources":["../../src/skills/29-data-migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,kBAAkB,EAAE,eAsUhC,CAAC"}