code-abyss 1.5.1

package/skills/devops/testing.md

@@ -0,0 +1,186 @@
+---
+name: testing
+description: 软件测试。单元测试、集成测试、TDD、测试框架。当用户提到测试、单元测试、pytest、Jest、mock、TDD时使用。
+---
+
+# 🔧 炼器秘典 · 软件测试
+
+
+## 测试金字塔
+
+```
+        /\
+       /  \     E2E 测试 (少)
+      /----\
+     /      \   集成测试 (中)
+    /--------\
+   /          \ 单元测试 (多)
+  --------------
+```
+
+## Python (pytest)
+
+```python
+import pytest
+from myapp import calculate, UserService
+
+# 基础测试
+def test_add():
+    assert calculate.add(1, 2) == 3
+
+# 参数化
+@pytest.mark.parametrize("a,b,expected", [
+    (1, 2, 3),
+    (0, 0, 0),
+    (-1, 1, 0),
+])
+def test_add_params(a, b, expected):
+    assert calculate.add(a, b) == expected
+
+# Fixture
+@pytest.fixture
+def user_service():
+    service = UserService()
+    yield service
+    service.cleanup()
+
+def test_create_user(user_service):
+    user = user_service.create("test")
+    assert user.name == "test"
+
+# Mock
+from unittest.mock import Mock, patch
+
+@patch('myapp.requests.get')
+def test_fetch(mock_get):
+    mock_get.return_value.json.return_value = {"id": 1}
+    result = fetch_user(1)
+    assert result["id"] == 1
+
+# 异步测试
+@pytest.mark.asyncio
+async def test_async_fetch():
+    result = await async_fetch()
+    assert result is not None
+```
+
+### 运行命令
+```bash
+pytest                      # 运行所有
+pytest test_file.py         # 指定文件
+pytest -k "test_add"        # 匹配名称
+pytest -v                   # 详细输出
+pytest --cov=myapp          # 覆盖率
+pytest -x                   # 失败即停
+```
+
+## JavaScript (Jest/Vitest)
+
+```javascript
+import { describe, it, expect, vi } from 'vitest';
+
+// 基础测试
+describe('add', () => {
+  it('should add two numbers', () => {
+    expect(add(1, 2)).toBe(3);
+  });
+
+  it.each([
+    [1, 2, 3],
+    [0, 0, 0],
+    [-1, 1, 0],
+  ])('add(%i, %i) = %i', (a, b, expected) => {
+    expect(add(a, b)).toBe(expected);
+  });
+});
+
+// Mock
+vi.mock('./api', () => ({
+  getUser: vi.fn().mockResolvedValue({ id: 1, name: 'test' })
+}));
+
+it('should fetch user', async () => {
+  const user = await fetchUser(1);
+  expect(user.name).toBe('test');
+});
+
+// Spy
+const spy = vi.spyOn(console, 'log');
+doSomething();
+expect(spy).toHaveBeenCalledWith('message');
+```
+
+## Go (testing)
+
+```go
+package main
+
+import (
+    "testing"
+    "github.com/stretchr/testify/assert"
+)
+
+func TestAdd(t *testing.T) {
+    result := Add(1, 2)
+    assert.Equal(t, 3, result)
+}
+
+// 表驱动测试
+func TestAddTable(t *testing.T) {
+    tests := []struct {
+        name     string
+        a, b     int
+        expected int
+    }{
+        {"positive", 1, 2, 3},
+        {"zero", 0, 0, 0},
+        {"negative", -1, 1, 0},
+    }
+
+    for _, tt := range tests {
+        t.Run(tt.name, func(t *testing.T) {
+            assert.Equal(t, tt.expected, Add(tt.a, tt.b))
+        })
+    }
+}
+
+// Benchmark
+func BenchmarkAdd(b *testing.B) {
+    for i := 0; i < b.N; i++ {
+        Add(1, 2)
+    }
+}
+```
+
+## 测试原则
+
+```yaml
+FIRST:
+  - Fast: 快速执行
+  - Independent: 相互独立
+  - Repeatable: 可重复
+  - Self-validating: 自验证
+  - Timely: 及时编写
+
+AAA:
+  - Arrange: 准备数据
+  - Act: 执行操作
+  - Assert: 验证结果
+
+原则:
+  - 每个测试只验证一件事
+  - 测试边界条件
+  - 测试异常情况
+  - 避免测试实现细节
+```
+
+## TDD 流程
+
+```
+红 → 绿 → 重构
+
+1. 红: 写一个失败的测试
+2. 绿: 写最少代码让测试通过
+3. 重构: 优化代码，保持测试通过
+```
+

package/skills/gen-docs/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: gen-docs
+description: 文档生成器。自动分析模块结构，生成 README.md 和 DESIGN.md 骨架。当魔尊提到生成文档、创建README、创建DESIGN、文档骨架、文档模板时使用。在新建模块开始时自动触发。
+user-invocable: true
+disable-model-invocation: false
+allowed-tools: Bash, Read, Write, Glob
+argument-hint: <模块路径> [--force]
+---
+
+# 📝 造典关卡 · 文档生成器
+
+
+## 核心原则
+
+```
+无文档不成模块
+文档是模块的身份证
+没有身份证的模块不允许上线
+```
+
+## 自动生成
+
+运行文档生成脚本（跨平台）：
+
+```bash
+# 在 skill 目录下运行
+python scripts/doc_generator.py <模块路径>
+python scripts/doc_generator.py <模块路径> --force  # 强制覆盖已存在的文档
+python scripts/doc_generator.py <模块路径> --json   # JSON 输出
+```
+
+## 生成内容
+
+### README.md 骨架
+
+自动生成的 README.md 包含：
+
+- **模块名称** — 从目录名提取
+- **描述** — 从代码文档字符串提取（如有）
+- **特性列表** — 待填充
+- **依赖** — 从 requirements.txt/pyproject.toml 提取
+- **使用方法** — 基础模板
+- **API 概览** — 从代码提取类和函数列表
+- **目录结构** — 自动扫描生成
+
+### DESIGN.md 骨架
+
+自动生成的 DESIGN.md 包含：
+
+- **设计概述** — 目标与非目标模板
+- **架构设计** — 架构图占位符
+- **核心组件** — 从代码提取类列表
+- **设计决策** — 决策记录表格模板
+- **技术选型** — 自动检测语言和依赖
+- **权衡取舍** — 已知限制和技术债务模板
+- **安全考量** — 威胁模型和安全措施模板
+- **变更历史** — 初始版本记录
+
+## 智能分析
+
+### 支持的语言
+
+| 语言 | 分析能力 |
+|------|----------|
+| **Python** | 类、函数、文档字符串、依赖 |
+| **Go** | 目录结构、依赖 |
+| **TypeScript** | 目录结构、依赖 |
+| **Rust** | 目录结构、依赖 |
+| **其他** | 基础目录结构 |
+
+### 提取的信息
+
+- 模块名称（目录名）
+- 主要编程语言
+- 代码文件列表
+- 类和函数定义（Python）
+- 文档字符串（Python）
+- 依赖列表
+- 入口点文件
+
+## 自动触发时机
+
+| 场景 | 触发条件 |
+|------|----------|
+| 新建模块 | 模块创建开始时 |
+| 缺失文档 | 检测到模块缺少文档时 |
+
+## 使用流程
+
+```
+1. 运行 doc_generator.py 生成骨架
+2. 填充 TODO 标记的内容
+3. 补充设计决策和理由
+4. 添加使用示例
+5. 运行 /verify-module 校验完整性
+```
+
+## 生成后检查清单
+
+### README.md
+
+- [ ] 填充模块描述
+- [ ] 补充特性列表
+- [ ] 添加使用示例
+- [ ] 确认依赖完整
+
+### DESIGN.md
+
+- [ ] 明确设计目标
+- [ ] 记录设计决策
+- [ ] 说明技术选型理由
+- [ ] 列出已知限制
+
+---