ethan-skill 1.7.0 → 1.8.0

package/dist/skills/16-unit-testing.js

@@ -0,0 +1,298 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unitTestingSkill = void 0;
+exports.unitTestingSkill = {
+    id: 'unit-testing',
+    name: '单元测试',
+    nameEn: 'unit_testing',
+    order: 16,
+    category: '质量侧',
+    description: '运用 AAA 模式和 TDD 工作流编写高质量单元测试，建立覆盖率目标和 Mock 策略',
+    descriptionEn: 'Write high-quality unit tests using AAA pattern, TDD workflow, mocking strategies, and coverage goals',
+    detailDescription: `系统指导单元测试的设计与实现，涵盖 AAA（Arrange-Act-Assert）模式、TDD 红绿重构循环、
+Mock/Stub/Spy 策略选择、覆盖率目标制定和测试命名规范，帮助团队建立可维护、有效的测试体系。`,
+    triggers: [
+        '单元测试',
+        'unit test',
+        '写测试',
+        'write tests',
+        'TDD',
+        '测试设计',
+        'test design',
+        'mock 策略',
+        'mocking',
+        '测试覆盖率',
+        'coverage',
+        '@ethan test',
+        '@ethan unit-testing',
+    ],
+    steps: [
+        {
+            title: '1. 明确测试目标与范围',
+            content: `在编写测试前，先明确测什么：
+
+**测试金字塔**
+\`\`\`
+        ┌───────────┐
+        │  E2E 测试  │  (少量，慢，高置信)
+       ┌┴───────────┴┐
+       │  集成测试    │  (适量，中速)
+      ┌┴─────────────┴┐
+      │  单元测试      │  (大量，快，低成本)
+      └───────────────┘
+\`\`\`
+
+**单元测试应该覆盖**
+- ✅ 纯函数的各种输入输出（含边界）
+- ✅ 类/模块的公共方法逻辑
+- ✅ 条件分支（if/switch/三元）
+- ✅ 错误处理路径（throw/catch）
+- ✅ 异步操作（Promise/async-await）
+
+**不应该单元测试**
+- ❌ 简单的 getter/setter（无逻辑）
+- ❌ 第三方库内部实现
+- ❌ 框架本身（如 React 渲染机制）
+- ❌ 私有方法（通过公共方法间接测试）`,
+        },
+        {
+            title: '2. AAA 模式编写测试用例',
+            content: `每个测试用例遵循 **Arrange → Act → Assert** 三段式结构：
+
+**基础示例（JavaScript/TypeScript with Vitest/Jest）**
+\`\`\`typescript
+describe('calculateDiscount', () => {
+  it('should apply 20% discount for premium users', () => {
+    // Arrange（准备：设置测试数据和依赖）
+    const user = { type: 'premium', cart: [{ price: 100 }, { price: 50 }] };
+    const expectedTotal = 120;  // 150 * 0.8
+
+    // Act（执行：调用被测函数）
+    const result = calculateDiscount(user);
+
+    // Assert（断言：验证结果）
+    expect(result.total).toBe(expectedTotal);
+    expect(result.discountRate).toBe(0.2);
+  });
+});
+\`\`\`
+
+**测试命名规范（Given-When-Then）**
+\`\`\`typescript
+// 格式: should <expected behavior> when <condition>
+it('should return null when user is not found')
+it('should throw AuthError when token is expired')
+it('should apply 20% discount when user has premium status')
+
+// 或使用 Given-When-Then 风格
+it('given empty cart, when checkout, then throws EmptyCartError')
+\`\`\`
+
+**边界条件测试清单**
+\`\`\`typescript
+describe('parseAge', () => {
+  // 正常值
+  it('should parse valid age 25')
+  // 边界值
+  it('should accept minimum age 0')
+  it('should accept maximum age 150')
+  // 非法值
+  it('should throw when age is negative')
+  it('should throw when age exceeds 150')
+  // 类型边界
+  it('should throw when age is not a number')
+  it('should throw when age is null or undefined')
+  it('should handle decimal by flooring to integer')
+});
+\`\`\``,
+        },
+        {
+            title: '3. TDD 工作流（红-绿-重构）',
+            content: `**TDD 循环步骤**
+
+\`\`\`
+🔴 Red   → 写一个失败的测试（先设计接口）
+🟢 Green → 写最少代码让测试通过（不过度设计）
+🔵 Refactor → 在测试保护下重构代码
+\`\`\`
+
+**实践示例：用 TDD 实现邮箱验证**
+
+\`\`\`typescript
+// Step 1 🔴 先写测试（此时 validateEmail 还不存在）
+describe('validateEmail', () => {
+  it('should return true for valid email', () => {
+    expect(validateEmail('user@example.com')).toBe(true);
+  });
+  it('should return false for missing @', () => {
+    expect(validateEmail('userexample.com')).toBe(false);
+  });
+  it('should return false for empty string', () => {
+    expect(validateEmail('')).toBe(false);
+  });
+});
+
+// Step 2 🟢 写最简实现让测试通过
+export function validateEmail(email: string): boolean {
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+}
+
+// Step 3 🔵 重构：提取正则为常量，添加类型注释
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+export function validateEmail(email: string): boolean {
+  if (!email) return false;
+  return EMAIL_REGEX.test(email);
+}
+\`\`\`
+
+**TDD 适用场景**
+- 明确需求的业务逻辑函数
+- 工具库/SDK 开发
+- Bug 修复（先写复现测试再修复）
+
+**不强制 TDD 的场景**
+- 探索性开发阶段
+- UI 组件（先实现再补测试）`,
+        },
+        {
+            title: '4. Mock / Stub / Spy 策略',
+            content: `**三种测试替身的区别**
+
+| 类型 | 用途 | 验证方式 |
+|------|------|---------|
+| **Stub** | 替换外部依赖，控制返回值 | 只验证输出 |
+| **Mock** | 验证函数是否被正确调用 | 验证调用行为 |
+| **Spy** | 监听真实函数的调用情况 | 包装真实实现 |
+
+**Vitest/Jest 实践**
+\`\`\`typescript
+import { vi, describe, it, expect, beforeEach } from 'vitest';
+
+// Stub: 控制外部 API 返回值
+vi.mock('../api/user', () => ({
+  fetchUser: vi.fn().mockResolvedValue({ id: 1, name: 'Alice' }),
+}));
+
+// Mock: 验证函数被调用
+it('should call sendEmail when user registers', async () => {
+  const sendEmail = vi.fn();
+  await registerUser({ email: 'test@test.com' }, { sendEmail });
+  expect(sendEmail).toHaveBeenCalledOnce();
+  expect(sendEmail).toHaveBeenCalledWith('test@test.com', expect.objectContaining({ subject: 'Welcome' }));
+});
+
+// Spy: 包装真实函数监听
+it('should log error when fetch fails', async () => {
+  const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+  vi.mocked(fetchUser).mockRejectedValue(new Error('Network Error'));
+  await loadUserProfile(1);
+  expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('Network Error'));
+  consoleSpy.mockRestore();
+});
+\`\`\`
+
+**Mock 黄金法则**
+- 只 Mock 跨边界的依赖（网络、数据库、文件系统、时间）
+- 不要 Mock 被测单元的内部实现
+- 每次测试后还原 Mock（使用 \`beforeEach(() => vi.clearAllMocks())\`）`,
+        },
+        {
+            title: '5. 覆盖率目标与质量保障',
+            content: `**覆盖率类型与目标**
+
+| 覆盖率类型 | 说明 | 建议目标 |
+|----------|------|---------|
+| 语句覆盖（Statements） | 执行的语句比例 | ≥ 80% |
+| 分支覆盖（Branches） | if/else 分支比例 | ≥ 75% |
+| 函数覆盖（Functions） | 调用的函数比例 | ≥ 80% |
+| 行覆盖（Lines） | 执行的代码行比例 | ≥ 80% |
+
+**Vitest 覆盖率配置**
+\`\`\`typescript
+// vitest.config.ts
+export default defineConfig({
+  test: {
+    coverage: {
+      provider: 'v8',  // 或 'istanbul'
+      reporter: ['text', 'html', 'lcov'],
+      thresholds: {
+        statements: 80,
+        branches: 75,
+        functions: 80,
+        lines: 80,
+      },
+      exclude: [
+        'node_modules/',
+        'src/types/',
+        '**/*.config.*',
+        '**/*.d.ts',
+      ],
+    },
+  },
+});
+\`\`\`
+
+**覆盖率反模式（要避免）**
+\`\`\`typescript
+// ❌ 为了覆盖率写无意义断言
+it('does something', () => {
+  expect(doSomething()).toBeDefined();  // 没有验证具体行为
+});
+
+// ✅ 验证真实业务逻辑
+it('should return correct discounted price', () => {
+  expect(calculatePrice(100, 0.1)).toBe(90);
+});
+\`\`\`
+
+**CI 集成**
+\`\`\`yaml
+# .github/workflows/test.yml
+- name: Run tests with coverage
+  run: npm run test -- --coverage
+
+- name: Comment coverage on PR
+  uses: MishaKav/jest-coverage-comment@main
+  with:
+    coverage-summary-path: ./coverage/coverage-summary.json
+\`\`\``,
+        },
+    ],
+    outputFormat: 'Markdown 测试方案文档，含测试用例设计（AAA 格式）、Mock 策略说明、覆盖率目标和 CI 配置示例',
+    examples: [
+        {
+            input: '帮我为这个 calculateTax 函数写单元测试',
+            output: `## 单元测试方案：calculateTax
+
+\`\`\`typescript
+describe('calculateTax', () => {
+  describe('standard rate (20%)', () => {
+    it('should apply 20% tax to positive amount', () => {
+      expect(calculateTax(100, 'standard')).toBe(20);
+    });
+    it('should return 0 tax for zero amount', () => {
+      expect(calculateTax(0, 'standard')).toBe(0);
+    });
+  });
+
+  describe('error cases', () => {
+    it('should throw when amount is negative', () => {
+      expect(() => calculateTax(-1, 'standard')).toThrow('Amount must be positive');
+    });
+    it('should throw for unknown tax category', () => {
+      expect(() => calculateTax(100, 'unknown' as any)).toThrow('Unknown tax category');
+    });
+  });
+});
+\`\`\``,
+        },
+    ],
+    notes: [
+        '测试应该是自文档化的，好的测试名称比注释更有价值',
+        '避免测试实现细节，测试行为而非内部结构，有助于重构时测试不频繁失败',
+        '不要追求 100% 覆盖率，关注核心业务逻辑的质量覆盖',
+        '测试代码同样需要维护，避免过度复杂的测试辅助函数',
+    ],
+    nextSkill: 'system-design',
+};
+//# sourceMappingURL=16-unit-testing.js.map

package/dist/skills/16-unit-testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"16-unit-testing.js","sourceRoot":"","sources":["../../src/skills/16-unit-testing.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAoB;IAC/C,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,8CAA8C;IAC3D,aAAa,EAAE,uGAAuG;IACtH,iBAAiB,EAAE;qDACgC;IACnD,QAAQ,EAAE;QACR,MAAM;QACN,WAAW;QACX,KAAK;QACL,aAAa;QACb,KAAK;QACL,MAAM;QACN,aAAa;QACb,SAAS;QACT,SAAS;QACT,OAAO;QACP,UAAU;QACV,aAAa;QACb,qBAAqB;KACtB;IACD,KAAK,EAAE;QACL;YACE,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;qBAwBM;SAChB;QACD;YACE,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+CR;SACF;QACD;YACE,KAAK,EAAE,oBAAoB;YAC3B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4CE;SACZ;QACD;YACE,KAAK,EAAE,yBAAyB;YAChC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4DAsC6C;SACvD;QACD;YACE,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyDR;SACF;KACF;IACD,YAAY,EACV,0DAA0D;IAC5D,QAAQ,EAAE;QACR;YACE,KAAK,EAAE,4BAA4B;YACnC,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;OAsBP;SACF;KACF;IACD,KAAK,EAAE;QACL,0BAA0B;QAC1B,mCAAmC;QACnC,6BAA6B;QAC7B,0BAA0B;KAC3B;IACD,SAAS,EAAE,eAAe;CAC3B,CAAC"}

package/dist/skills/17-system-design.d.ts

@@ -0,0 +1,3 @@
+import type { SkillDefinition } from './types';
+export declare const systemDesignSkill: SkillDefinition;
+//# sourceMappingURL=17-system-design.d.ts.map

package/dist/skills/17-system-design.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"17-system-design.d.ts","sourceRoot":"","sources":["../../src/skills/17-system-design.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,iBAAiB,EAAE,eAkS/B,CAAC"}

package/dist/skills/17-system-design.js

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.systemDesignSkill = void 0;
+exports.systemDesignSkill = {
+    id: 'system-design',
+    name: '系统设计',
+    nameEn: 'system_design',
+    order: 17,
+    category: '执行侧',
+    description: '从需求澄清到架构设计全流程，完成高并发分布式系统的方案设计与权衡分析',
+    descriptionEn: 'Full system design process from requirement clarification to architecture with scalability and availability tradeoffs',
+    detailDescription: `系统性指导大型系统设计流程，涵盖需求澄清与非功能指标量化、容量估算、高层架构选型、
+核心组件设计、数据库模型与扩展性分析，帮助在面试或实际项目中输出结构清晰、考量全面的系统设计方案。`,
+    triggers: [
+        '系统设计',
+        'system design',
+        '架构设计',
+        'architecture design',
+        '高并发系统',
+        '分布式系统',
+        'distributed system',
+        '容量估算',
+        'capacity estimation',
+        '扩展性设计',
+        'scalability',
+        '@ethan design',
+        '@ethan system-design',
+    ],
+    steps: [
+        {
+            title: '1. 需求澄清与范围界定',
+            content: `在动手设计前，花 5 分钟澄清需求：
+
+**功能需求（Functional Requirements）**
+- 系统的核心用例是什么？（写出 3-5 个最关键的）
+- 哪些功能在 scope 内，哪些明确 out of scope？
+- 用户角色有哪些？各自的主要操作是什么？
+
+**非功能需求（Non-Functional Requirements）**
+
+| 维度 | 问题 | 示例指标 |
+|------|------|---------|
+| 规模 | 用户量 / DAU / QPS 是多少？ | 1亿用户，1000万 DAU |
+| 性能 | 读写延迟要求？P99 是多少？ | P99 < 100ms |
+| 可用性 | 允许多少停机时间？ | 99.9%（每年 8.7h） |
+| 一致性 | 强一致 or 最终一致？ | 最终一致（可接受） |
+| 持久性 | 数据丢失容忍度？ | RPO = 0（不允许丢失） |
+
+**明确边界的示例问题**
+\`\`\`
+Q: 设计一个 Twitter
+A（先澄清）:
+- 只需要发推/关注/Feed 功能吗？（排除私信、广告）
+- 用户规模：3亿用户，1亿 DAU？
+- 读写比例：推文读多写少，100:1？
+- 媒体文件：支持图片/视频吗？
+- 全球分发还是单地区？
+\`\`\``,
+        },
+        {
+            title: '2. 容量估算（Back-of-Envelope）',
+            content: `快速估算系统规模，为架构决策提供数据依据：
+
+**常用基准数字**
+\`\`\`
+内存访问：    ~100ns
+SSD 访问：    ~100μs
+HDD 访问：    ~10ms
+网络往返（同数据中心）：~0.5ms
+网络往返（跨地区）：    ~100ms
+
+1 MB = 10^6 bytes
+1 GB = 10^9 bytes
+1 TB = 10^12 bytes
+\`\`\`
+
+**估算示例：设计微博（Twitter-like）**
+\`\`\`
+用户数据：
+- DAU: 1亿
+- 每用户每天发1条推文 → 写 QPS = 100M / 86400 ≈ 1160 QPS
+- 每用户每天读100条 → 读 QPS = 100 × 1160 = 116,000 QPS
+
+存储估算：
+- 单条推文: 140字 × 2字节(UTF-16) = 280字节 ≈ 300字节
+- 元数据(user_id, timestamp等): 100字节
+- 每条推文总计: ~400字节
+- 每日新增: 1.16K QPS × 400字节 × 86400 = ~40 GB/天
+- 5年存储: 40GB × 365 × 5 ≈ 73 TB
+
+带宽估算：
+- 写带宽: 1160 × 400字节 = ~450 KB/s
+- 读带宽: 116K × 400字节 = ~45 MB/s
+\`\`\`
+
+**结论：** 读多写少（100:1），需要读缓存；存储量大需分库分表；单机无法支撑读 QPS 需多副本。`,
+        },
+        {
+            title: '3. 高层架构设计',
+            content: `从整体入手，画出系统的核心模块和数据流：
+
+**通用分层架构**
+\`\`\`
+客户端 (Web/Mobile/API Consumer)
+         │
+         ▼
+   DNS + CDN (静态资源 / 地理路由)
+         │
+         ▼
+   Load Balancer (L4/L7, 负载均衡 + SSL 终止)
+    ┌────┴────┐
+    ▼         ▼
+ API Srv   API Srv   (无状态，水平扩展)
+    │
+    ├──→ Cache (Redis: 热数据)
+    ├──→ Message Queue (Kafka: 异步解耦)
+    ├──→ Primary DB (写操作)
+    └──→ Read Replica (读操作)
+         │
+         ▼
+   Object Storage (S3: 文件/媒体)
+   Search Engine (Elasticsearch)
+\`\`\`
+
+**架构选型决策点**
+
+| 场景 | 选型建议 |
+|------|---------|
+| 读多写少 | 读写分离 + 缓存层 |
+| 高写入吞吐 | 异步消息队列削峰 |
+| 数据量超百亿行 | 分库分表 / NoSQL |
+| 强一致性 | 单主 / Paxos / Raft |
+| 最终一致性 | 多主 / CRDT |
+| 低延迟全球访问 | CDN + 多地域部署 |
+| 复杂查询 | 专用搜索引擎 |
+
+**微服务 vs 单体 决策**
+- 团队 < 10人，初创期：单体优先（避免过度工程）
+- 明确的服务边界、独立扩展需求：拆分微服务
+- 拆分原则：按业务边界（DDD 限界上下文），而非技术层`,
+        },
+        {
+            title: '4. 核心组件深度设计',
+            content: `针对最关键的 2-3 个组件进行深入设计：
+
+**数据库 Schema 设计**
+\`\`\`sql
+-- 示例：推文表设计
+CREATE TABLE tweets (
+  id          BIGINT PRIMARY KEY,      -- Snowflake ID（分布式唯一ID）
+  user_id     BIGINT NOT NULL,
+  content     VARCHAR(280) NOT NULL,
+  created_at  TIMESTAMP DEFAULT NOW(),
+  like_count  INT DEFAULT 0,
+  retweet_count INT DEFAULT 0,
+  INDEX idx_user_created (user_id, created_at DESC)  -- 用户时间线查询
+);
+
+-- Fan-out 策略：预写 vs 拉取
+-- 方案A: Push（写扩散）: 发推时写入所有粉丝的 Feed 表
+-- 方案B: Pull（读扩散）: 读取时聚合关注者的推文
+-- 混合方案: 普通用户 Push，大V（粉丝>100万）Pull
+\`\`\`
+
+**缓存策略**
+\`\`\`
+Cache-Aside（旁路缓存）- 最通用
+读: 查缓存 → miss → 查DB → 写缓存 → 返回
+写: 更新DB → 删除缓存（避免双写不一致）
+
+Write-Through（写穿）- 一致性高
+写: 同时写DB和缓存
+
+Write-Behind（写回）- 高性能
+写: 先写缓存，异步批量写DB（风险：缓存宕机丢数据）
+
+缓存 Key 设计示例:
+user:{userId}:profile      → 用户资料
+user:{userId}:feed:page:{n} → 用户 Feed 分页
+tweet:{tweetId}            → 单条推文
+\`\`\`
+
+**API 接口设计**
+\`\`\`
+POST /tweets              发布推文
+GET  /users/{id}/feed     获取 Feed (cursor分页)
+POST /tweets/{id}/like    点赞
+GET  /tweets/{id}         获取单条推文
+
+分页策略: cursor-based > offset-based（大数据量场景）
+cursor: base64(created_at + tweet_id)
+\`\`\``,
+        },
+        {
+            title: '5. 可扩展性与可用性权衡',
+            content: `**CAP 定理实践**
+\`\`\`
+C（一致性）+ A（可用性）+ P（分区容错）三选二
+网络分区不可避免 → 通常是 CP 或 AP 的选择
+
+CP 系统: ZooKeeper, HBase（金融交易、库存扣减）
+AP 系统: Cassandra, DynamoDB（社交Feed、购物车）
+\`\`\`
+
+**水平扩展策略**
+
+| 层次 | 策略 |
+|------|------|
+| 无状态应用层 | 直接水平扩展 + 负载均衡 |
+| 有状态缓存 | 一致性哈希分片（Redis Cluster） |
+| 数据库水平 | 分库分表（按 user_id % N） |
+| 数据库垂直 | 主从复制，读写分离 |
+
+**单点故障（SPOF）消除清单**
+- [ ] Load Balancer 双活/主备
+- [ ] 数据库主从 + 自动故障转移（MHA/Orchestrator）
+- [ ] 缓存集群（Redis Sentinel / Cluster）
+- [ ] 消息队列多副本（Kafka Replication Factor ≥ 3）
+- [ ] 跨可用区部署（Multi-AZ）
+
+**限流与熔断**
+\`\`\`
+限流: Token Bucket（突发流量友好）
+     Sliding Window（精准限流）
+     分级限流: 用户级 → 接口级 → 全局
+
+熔断: Closed → Open（失败率>50%）→ Half-Open（探测恢复）
+工具: Resilience4j（Java）/ hystrix-go / Polly(.NET)
+\`\`\``,
+        },
+        {
+            title: '6. 输出系统设计文档',
+            content: `整理为结构化设计文档：
+
+\`\`\`markdown
+## 系统设计方案：[系统名称]
+
+### 1. 需求概述
+**功能需求**（核心功能列表）
+**非功能需求**（QPS / 延迟 / 可用性 / 存储）
+
+### 2. 容量估算
+| 指标 | 估算值 |
+|------|-------|
+| DAU | X 万 |
+| 写 QPS | X |
+| 读 QPS | X |
+| 存储（5年） | X TB |
+
+### 3. 系统架构图
+[ASCII 图或 Mermaid 图]
+
+### 4. 核心组件设计
+- **数据库 Schema**：[关键表设计]
+- **缓存策略**：[策略选择与理由]
+- **API 设计**：[关键接口]
+
+### 5. 扩展性方案
+- **瓶颈点**：[识别的瓶颈]
+- **解决方案**：[具体方案]
+
+### 6. 权衡与风险
+[已知权衡和设计风险]
+\`\`\``,
+        },
+    ],
+    outputFormat: 'Markdown 系统设计文档，含需求澄清结果、容量估算数据、架构图、核心组件设计方案和扩展性权衡分析',
+    examples: [
+        {
+            input: '设计一个短链接服务（如 bit.ly）',
+            output: `## 短链接服务设计
+
+**规模**：每天 1 亿次创建，10 亿次访问（10:1 读写比）
+**写 QPS**：~1160，**读 QPS**：~11600，存储5年：~40TB
+
+**核心架构**：Web → LB → API Server → Redis（热门短链缓存）→ Cassandra（主存储）
+
+**短链生成**：Base62 编码 7位（62^7 ≈ 3500亿，够用）
+- 方案A: 预生成随机串存DB（无冲突）
+- 方案B: ID自增 → Base62编码（简单高效，推荐）
+
+**重定向**：301（永久，浏览器缓存，减少服务压力）vs 302（临时，可统计点击）
+**数据库**：Cassandra（key-value 访问模式完美匹配，易扩展）`,
+        },
+    ],
+    notes: [
+        '系统设计没有标准答案，重点展示思考过程和权衡意识',
+        '先画出高层架构，再逐步深入细节，避免一开始陷入细节',
+        '主动提出设计中的权衡和不足，展示对复杂度的认知',
+        '数量级估算误差在 10x 以内即可，重要的是数量级概念',
+    ],
+    nextSkill: 'database-optimize',
+};
+//# sourceMappingURL=17-system-design.js.map

package/dist/skills/17-system-design.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"17-system-design.js","sourceRoot":"","sources":["../../src/skills/17-system-design.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAoB;IAChD,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,eAAe;IACvB,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,oCAAoC;IACjD,aAAa,EAAE,uHAAuH;IACtI,iBAAiB,EAAE;kDAC6B;IAChD,QAAQ,EAAE;QACR,MAAM;QACN,eAAe;QACf,MAAM;QACN,qBAAqB;QACrB,OAAO;QACP,OAAO;QACP,oBAAoB;QACpB,MAAM;QACN,qBAAqB;QACrB,OAAO;QACP,aAAa;QACb,eAAe;QACf,sBAAsB;KACvB;IACD,KAAK,EAAE;QACL;YACE,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BR;SACF;QACD;YACE,KAAK,EAAE,2BAA2B;YAClC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDAkCuC;SACjD;QACD;YACE,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAwCe;SACzB;QACD;YACE,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgDR;SACF;QACD;YACE,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCR;SACF;QACD;YACE,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BR;SACF;KACF;IACD,YAAY,EACV,qDAAqD;IACvD,QAAQ,EAAE;QACR;YACE,KAAK,EAAE,qBAAqB;YAC5B,MAAM,EAAE;;;;;;;;;;;;0CAY4B;SACrC;KACF;IACD,KAAK,EAAE;QACL,0BAA0B;QAC1B,2BAA2B;QAC3B,yBAAyB;QACzB,6BAA6B;KAC9B;IACD,SAAS,EAAE,mBAAmB;CAC/B,CAAC"}

package/dist/skills/18-database-optimize.d.ts

@@ -0,0 +1,3 @@
+import type { SkillDefinition } from './types';
+export declare const databaseOptimizeSkill: SkillDefinition;
+//# sourceMappingURL=18-database-optimize.d.ts.map

package/dist/skills/18-database-optimize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"18-database-optimize.d.ts","sourceRoot":"","sources":["../../src/skills/18-database-optimize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,qBAAqB,EAAE,eAkSnC,CAAC"}