ethan-skill 1.7.0 → 1.8.0

package/README.md

@@ -14,18 +14,20 @@
 
 | 模块 | 内容 |
 |------|------|
-| **10 个 Skill** | 标准化工作流节点，覆盖需求→设计→实现→跟踪→输出→质量 |
+| **24 个 Skill** | 标准化工作流节点，覆盖需求→接口设计→安全→部署→PRD→Git→测试→系统设计→数据库→Docker→CI/CD→性能→重构→可观测性→设计模式 |
 | **11 个平台** | Cursor / Copilot / Cline / Windsurf / Zed / JetBrains / Continue / Claude Code 等 |
-| **3 个 Pipeline** | 链式工作流（开发 / 汇报 / 质量），有状态持久化推进 |
-| **17 个 MCP 工具** | AI 编辑器原生调用 Skill、Pipeline、Git、记忆库、估算 |
+| **6 个 Pipeline** | 链式工作流（开发 / 汇报 / 质量 / 完整周期 / 故障响应 / 新功能），有状态持久化推进 |
+| **23 个 MCP 工具** | AI 编辑器原生调用 Skill、Pipeline、Git、记忆库、估算 |
 | **40+ CLI 命令** | Git 集成、开发工具、记忆库、估算、插件 OS 全覆盖 |
+| **自定义 Skill** | `.ethan/skills/*.yaml/.md`，YAML frontmatter + Markdown body |
+| **自定义 Pipeline** | `.ethan/pipelines/*.yaml`，引用内置或自定义 Skill 自由组合 |
 | **浏览器扩展** | Chrome/Edge MV3，GitHub PR 一键 Review + 右键菜单 |
-| **VS Code 扩展** | 侧边栏树、20 个命令、17 个 @ethan 斜杠命令 |
+| **VS Code 扩展** | 侧边栏树、20 个命令、23 个 @ethan 斜杠命令 |
 | **插件 OS** | 发布/搜索/安装社区 Skill 插件，支持私有注册表 |
 
 ---
 
-## 10 个 Skill
+## 24 个 Skill
 
 | # | Skill | 分类 | 触发词（示例） | 说明 |
 |---|-------|------|--------------|------|
@@ -39,16 +41,33 @@
 | 8 | 代码审查 | 质量侧 | `代码审查`、`code review`、`CR` | 系统性审查，分级输出 Blocker/Major/Minor |
 | 9 | 故障排查 | 质量侧 | `故障排查`、`debug`、`线上故障` | 假设验证 + 5 Why 根因分析，三层解决方案 |
 | 10 | 技术调研 | 需求侧 | `技术调研`、`技术选型`、`POC` | 加权评分矩阵 + POC 验证，输出有据可查的结论 |
+| 11 | 接口设计 | 执行侧 | `接口设计`、`API 设计`、`RESTful` | RESTful/GraphQL 接口规范，OpenAPI 3.0 风格输出 |
+| 12 | 安全审查 | 质量侧 | `安全审查`、`OWASP`、`security review` | OWASP Top 10 逐项扫描，四级风险清单（Critical→Low） |
+| 13 | 部署上线 | 执行侧 | `部署上线`、`上线`、`deploy` | Pre-flight 预检 + 灰度/蓝绿策略 + 回滚方案全流程 |
+| 14 | PRD 编写 | 需求侧 | `PRD`、`产品需求`、`写 PRD` | 用户故事 + 验收标准 AC + 非功能性需求 + 埋点方案 |
+| 15 | **Git 工作流** | 执行侧 | `Git 工作流`、`分支策略`、`commit 规范` | GitFlow/Trunk-Based 选型、Conventional Commits、Rebase vs Merge 决策 |
+| 16 | **单元测试** | 质量侧 | `单元测试`、`unit test`、`测试覆盖率` | AAA 模式、Mock 策略、Vitest/Jest 配置，建立测试文化 |
+| 17 | **系统设计** | 执行侧 | `系统设计`、`架构设计`、`system design` | 需求拆解→容量估算→架构选型→核心组件→数据模型 |
+| 18 | **数据库优化** | 质量侧 | `数据库优化`、`慢查询`、`索引优化` | 慢查询诊断、索引策略、查询优化、分库分表与缓存 |
+| 19 | **Docker** | 执行侧 | `Docker`、`容器化`、`Dockerfile` | 多阶段构建、Compose 编排、安全加固与镜像精简 |
+| 20 | **CI/CD** | 执行侧 | `CI/CD`、`流水线`、`GitHub Actions` | GitHub Actions 全流程、并行构建、多环境部署策略 |
+| 21 | **性能优化** | 质量侧 | `性能优化`、`Core Web Vitals`、`performance` | 基线建立、前端懒加载/代码分割、后端缓存/并发优化 |
+| 22 | **代码重构** | 质量侧 | `代码重构`、`refactoring`、`技术债` | 识别坏味道、提炼函数/多态等重构手法、测试先行 |
+| 23 | **可观测性** | 质量侧 | `可观测性`、`监控`、`链路追踪` | 日志/指标/链路三支柱、OTel、Prometheus+Grafana、SLO |
+| 24 | **设计模式** | 执行侧 | `设计模式`、`design pattern`、`GoF` | 23 种 GoF 模式速查、TypeScript 实现、场景→模式选型指南 |
 
 ---
 
-## 3 个 Pipeline（链式工作流）
+## 6 个 Pipeline（链式工作流）
 
 | Pipeline ID | Skills | 适用场景 |
 |-------------|--------|---------|
-| `dev-workflow` | 需求理解 → 任务拆解 → 方案设计 → 执行实现 | 完整功能开发 |
+| `dev-workflow` | 需求理解 → 任务拆解 → 方案设计 → 执行实现 | 常规功能开发 |
 | `reporting` | 进度跟踪 → 任务报告 → 周报生成 | 项目汇报 |
 | `quality-workflow` | 代码审查 → 故障排查 | 质量保障 |
+| `full-dev-cycle` | 需求理解 → **接口设计** → 方案设计 → 执行实现 → 代码审查 → **部署上线** | 完整功能交付 |
+| `incident-response` | 故障排查 → 技术调研 → 任务报告 | 线上故障处理 |
+| `new-feature` | **PRD** → 技术调研 → **接口设计** → 任务拆解 → 执行实现 | 新功能从 0 到 1 |
 
 自定义 Pipeline：在 `.ethan/pipelines/` 目录创建 YAML 文件，`ethan pipeline-init` 生成模板。
 
@@ -85,7 +104,7 @@ npx ethan-skill install --platform cursor --lang en
 }
 ```
 
-重启 AI 编辑器后，可使用全部 **17 个 MCP 工具**（详见下方 MCP 工具列表）。
+重启 AI 编辑器后，可使用全部 **23 个 MCP 工具**（详见下方 MCP 工具列表）。
 
 ### 方式三：全局安装
 
@@ -120,7 +139,7 @@ ethan install --platform cursor
 
 ```bash
 ethan install [--platform <platform>] [--lang en]   # 安装规则文件
-ethan list [--json]                                  # 列出所有 Skill
+ethan list [--json]                                  # 列出所有 Skill（含自定义）
 ethan run                                            # 交互式 Skill 执行向导
 ethan init                                           # 生成 .ethanrc.json 配置文件
 ethan validate                                       # 校验 rules/ 与源码是否同步
@@ -208,6 +227,35 @@ ethan pipeline run <id> [-c "上下文"]                 # 运行 Pipeline
 ethan pipeline-init [--name my-pipeline]              # 生成自定义 YAML Pipeline 模板
 ```
 
+### 自定义 Skill
+
+```bash
+ethan skill new [name] [--format yaml|md]             # 生成自定义 Skill 模板（默认 yaml）
+ethan skill list                                      # 列出 .ethan/skills/ 中的自定义 Skill
+```
+
+自定义 Skill 文件放置在 `.ethan/skills/` 目录，支持 `.yaml`、`.json`、`.md` 格式：
+
+```markdown
+---
+id: my-skill
+name: 自定义技能
+nameEn: my_skill
+description: 一句话描述
+triggers:
+  - 触发词
+outputFormat: Markdown 文档
+---
+
+## 1. 第一步
+
+步骤说明...
+
+## 2. 第二步
+
+步骤说明...
+```
+
 ### 插件 OS（Phase 6）
 
 ```bash
@@ -220,7 +268,7 @@ ethan plugin search <keyword> [-n <limit>]            # 搜索社区插件（eth
 
 ---
 
-## 17 个 MCP 工具
+## 23 个 MCP 工具
 
 配置 MCP Server 后，AI 编辑器（Cursor / Cline / Continue 等）可直接调用：
 
@@ -236,13 +284,19 @@ ethan plugin search <keyword> [-n <limit>]            # 搜索社区插件（eth
 | `code_review` | 代码审查 Skill |
 | `debug` | 故障排查 Skill |
 | `tech_research` | 技术调研 Skill |
+| `api_design` | 接口设计 Skill（v1.7.0 新增）|
+| `security_review` | 安全审查 Skill（v1.7.0 新增）|
+| `deployment` | 部署上线 Skill（v1.7.0 新增）|
+| `prd` | PRD 编写 Skill（v1.7.0 新增）|
 | `ethan_pipeline` | 串联执行完整 Pipeline |
-| `ethan_workflow_next` | 推进工作流到下一步（传入摘要，返回下一步提示词） |
+| `ethan_workflow_next` | 推进工作流到下一步（传入摘要，返回下一步提示词）|
 | `ethan_workflow_status` | 查询工作流进度与当前步骤 |
-| `ethan_memory_search` | 搜索 Skill 记忆库（项目级 + 全局） |
-| `ethan_estimate` | 生成三点估算提示词（支持小时/故事点/人天） |
+| `ethan_memory_search` | 搜索 Skill 记忆库（项目级 + 全局）|
+| `ethan_estimate` | 生成三点估算提示词（支持小时/故事点/人天）|
 | `ethan_git_commit` | 读取 staged diff → Conventional Commit 提示词 |
 | `ethan_git_review` | 读取分支 diff → Blocker/Major/Minor Review 提示词 |
+| `ethan_autopilot` | 生成 Pipeline 超级 prompt（自动链式执行）|
+| `ethan_context_snapshot` | 采集项目快照（技术栈/git/目录树，TTL 30min 缓存）|
 
 ---
 
@@ -271,9 +325,9 @@ Chrome/Edge Manifest V3 扩展，将 Ethan 带入任意网页。
 2. VS Code → Extensions → `...` → Install from VSIX
 
 **功能：**
-- **Skill 侧边栏树**：按分类分组展示 10 个 Skill，点击直接运行
-- **Pipeline 侧边栏树**：展示 3 条 Pipeline，点击查看详情
-- **17 个 @ethan 斜杠命令**：在 Copilot Chat 中使用 `@ethan /需求理解`、`@ethan /commit` 等
+- **Skill 侧边栏树**：按分类分组展示 14 个 Skill，点击直接运行
+- **Pipeline 侧边栏树**：展示 6 条 Pipeline，点击查看详情
+- **23 个 @ethan 斜杠命令**：在 Copilot Chat 中使用 `@ethan /需求理解`、`@ethan /commit` 等
 - **20 个命令面板命令**：包含 Git、开发工具、记忆、估算、复盘等全系列
 - **状态栏快捷按钮**：底部状态栏 `⚡ Ethan`，单击打开 Skill 选择器
 
@@ -318,11 +372,11 @@ src/skills/*.ts  ──→  [build-rules.ts]  ──→  rules/cursor/smart-flow
 ```
 ethan-skill/
 ├── src/
-│   ├── skills/            # 单一数据源（10 Skill + pipeline 定义）
+│   ├── skills/            # 单一数据源（24 Skill + pipeline 定义）
 │   │   ├── types.ts       # SkillDefinition、Platform、PipelineDefinition
 │   │   ├── index.ts       # ALL_SKILLS 导出
-│   │   ├── pipeline.ts    # PIPELINES + resolvePipeline()
-│   │   └── 01~10-*.ts     # 各 Skill 定义（含 category、nextSkill）
+│   │   ├── pipeline.ts    # PIPELINES（6条）+ resolvePipeline()
+│   │   └── 01~24-*.ts     # 各 Skill 定义（含 category、nextSkill）
 │   ├── cli/               # 40+ CLI 命令入口
 │   │   ├── index.ts       # Commander.js 主程序
 │   │   └── config.ts      # .ethanrc.json 读写
@@ -330,20 +384,22 @@ ethan-skill/
 │   │   └── utils.ts       # getStagedDiff / getBranchDiff / truncateDiff 等
 │   ├── workflow/           # 有状态工作流引擎
 │   │   └── state.ts       # 会话持久化、Named Sessions、步骤推进
-│   ├── mcp/               # MCP Server（17 个工具）
+│   ├── mcp/               # MCP Server（23 个工具）
 │   │   └── server.ts
 │   ├── router/            # 触发词路由
 │   ├── templates/         # 各平台渲染模板（11 个 case，强制穷举）
 │   ├── context/           # 项目技术栈自动检测
-│   ├── loader/            # 自定义 Skill YAML 加载器
+│   ├── loader/            # 自定义 Skill/Pipeline 加载器
+│   │   ├── custom-skill-loader.ts    # .ethan/skills/*.yaml/.md
+│   │   └── custom-pipeline-loader.ts # .ethan/pipelines/*.yaml
 │   ├── server/            # Web UI Dashboard
 │   └── vscode/            # VS Code 扩展
 ├── browser-extension/     # Chrome/Edge MV3 扩展
-├── vscode-extension/      # VS Code 扩展 manifest（20 命令、17 斜杠命令）
+├── vscode-extension/      # VS Code 扩展 manifest（20 命令、23 斜杠命令）
 ├── rules/                 # 构建产物，11 个平台（提交到仓库）
 ├── docs/                  # 官网（GitHub Pages）
 ├── scripts/build/         # 构建脚本（build-rules.ts / build-vscode.ts）
-└── .ethan/                # 项目级运行时数据（workflow.json、memory/、pipelines/）
+└── .ethan/                # 项目级运行时数据（workflow.json、memory/、skills/、pipelines/）
 ```
 
 ---
@@ -399,7 +455,10 @@ npm run test:coverage    # 覆盖率报告
 
 | 版本 | 主要变更 |
 |------|---------|
-| **v1.5.0** | MCP 新增 4 工具（git commit/review/memory search/estimate）；VS Code 扩展 17 斜杠命令；插件 OS（publish/registry/search）；浏览器扩展；自定义 YAML Pipeline；Stats 排行榜；记忆库；估算复盘 |
+| **v1.8.0** | 新增 10 个 Skill（Git 工作流/单元测试/系统设计/数据库优化/Docker/CI/CD/性能优化/代码重构/可观测性/设计模式）；Skills 14 → 24；docs ReactBits 风格重设计 |
+| **v1.7.0** | 新增 4 个 Skill（接口设计/安全审查/部署上线/PRD 编写）；新增 3 条 Pipeline（full-dev-cycle/incident-response/new-feature）；自定义 Pipeline 加载（`.ethan/pipelines/`）；MCP 工具 19 → 23 |
+| **v1.6.0** | 自定义 Skill 支持 `.md` 格式（YAML frontmatter + Markdown body）；`ethan skill new --format md`；新增 MCP `ethan_autopilot` 和 `ethan_context_snapshot` 工具 |
+| **v1.5.0** | MCP 新增 4 工具（git commit/review/memory search/estimate）；VS Code 扩展 17 斜杠命令；插件 OS；浏览器扩展；Context 引擎；Stats 排行榜；记忆库；估算复盘 |
 | **v1.3.0** | Git 集成（commit/review/pr/standup/changelog）；开发工具（scan/explain/test-case/naming/readme/roast）；On-call、定时任务、Git Hooks |
 | **v1.2.0** | 新增代码审查、故障排查、技术调研 3 个 Skill；新增 Windsurf/Zed/JetBrains/Continue/Claude Code 5 个平台；validate/pipeline/doctor/stats 命令 |
 | **v1.1.0** | 有状态工作流（workflow start/done/status）；MCP Server；Web UI Dashboard；自动上下文检测 |

package/dist/skills/15-git-workflow.d.ts

@@ -0,0 +1,3 @@
+import type { SkillDefinition } from './types';
+export declare const gitWorkflowSkill: SkillDefinition;
+//# sourceMappingURL=15-git-workflow.d.ts.map

package/dist/skills/15-git-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"15-git-workflow.d.ts","sourceRoot":"","sources":["../../src/skills/15-git-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,gBAAgB,EAAE,eA4R9B,CAAC"}

package/dist/skills/15-git-workflow.js

@@ -0,0 +1,288 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gitWorkflowSkill = void 0;
+exports.gitWorkflowSkill = {
+    id: 'git-workflow',
+    name: 'Git 工作流',
+    nameEn: 'git_workflow',
+    order: 15,
+    category: '执行侧',
+    description: '规范 Git 分支策略、提交规范、合并流程，建立团队一致的版本控制工作流',
+    descriptionEn: 'Establish consistent Git branching strategy, commit conventions, and merge workflow for teams',
+    detailDescription: `系统梳理 Git 工作流全流程，涵盖 GitFlow/Trunk-Based 分支策略选型、Conventional Commits 提交规范、
+rebase vs merge 决策、冲突解决流程和 PR/MR 最佳实践，帮助团队建立高效、可追溯的版本控制体系。`,
+    triggers: [
+        'Git 工作流',
+        'git workflow',
+        'git 规范',
+        '分支策略',
+        'branching strategy',
+        'commit 规范',
+        'commit convention',
+        '提交规范',
+        'PR 规范',
+        'rebase vs merge',
+        '冲突解决',
+        '@ethan git',
+        '@ethan git-workflow',
+    ],
+    steps: [
+        {
+            title: '1. 评估项目特征，选择分支策略',
+            content: `根据团队规模和发布节奏选择合适的分支策略：
+
+**GitFlow 适用场景**
+- 有明确版本号的产品（如 App、SDK、开源库）
+- 需要维护多个线上版本
+- 发布周期较长（周/月级别）
+
+\`\`\`
+main          ──●────────────────────●──  (生产稳定)
+hotfix/1.0.1    └──●──┘                  (紧急修复)
+release/1.1       └──●──┘               (预发布验证)
+develop       ──●──────●──────●──────●── (集成分支)
+feature/login    └──●──┘                 (功能开发)
+\`\`\`
+
+**Trunk-Based Development 适用场景**
+- 持续部署（CD）体系成熟
+- 有完善的 Feature Flag 机制
+- 团队规模适中（≤50 人），发布频率高（日/周）
+
+\`\`\`
+main  ──●──●──●──●──●──  (直接推送或短命分支 <2天)
+feat   └──●──┘           (短命功能分支，快速合并)
+\`\`\`
+
+**决策矩阵**
+
+| 维度 | GitFlow | Trunk-Based |
+|------|---------|-------------|
+| 发布频率 | 低（周/月） | 高（日/周） |
+| 团队规模 | 大 | 中小 |
+| 多版本维护 | 支持 | 不擅长 |
+| CI/CD 成熟度 | 低要求 | 高要求 |`,
+        },
+        {
+            title: '2. 制定提交信息规范（Conventional Commits）',
+            content: `采用 Conventional Commits 规范，格式：\`<type>(<scope>): <subject>\`
+
+**类型（type）定义**
+
+| type | 用途 | 版本影响 |
+|------|------|---------|
+| \`feat\` | 新功能 | MINOR |
+| \`fix\` | Bug 修复 | PATCH |
+| \`perf\` | 性能优化 | PATCH |
+| \`refactor\` | 重构（无功能变化） | — |
+| \`docs\` | 文档变更 | — |
+| \`test\` | 测试相关 | — |
+| \`chore\` | 构建/依赖/工具 | — |
+| \`ci\` | CI 配置变更 | — |
+| \`BREAKING CHANGE\` | 破坏性变更（Footer） | MAJOR |
+
+**示例**
+\`\`\`bash
+# 好的提交信息
+feat(auth): add OAuth2 login with Google provider
+fix(cart): prevent duplicate item addition on rapid click
+perf(query): add composite index on (user_id, created_at)
+refactor(api): extract pagination helper to shared utils
+docs(readme): update installation steps for Node 20
+
+# 破坏性变更写法
+feat(api)!: rename /users endpoint to /accounts
+
+BREAKING CHANGE: /users endpoint removed, use /accounts instead
+\`\`\`
+
+**工具链配置**
+\`\`\`bash
+# 安装 commitlint
+npm install -D @commitlint/cli @commitlint/config-conventional
+echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js
+
+# 配合 husky 在 commit-msg 钩子校验
+npx husky add .husky/commit-msg 'npx --no -- commitlint --edit $1'
+\`\`\``,
+        },
+        {
+            title: '3. Rebase vs Merge 决策与实践',
+            content: `**核心原则：黄金法则 — 不要 rebase 已推送的公共分支**
+
+**何时用 Merge**
+- 合并长期分支（feature → develop）
+- 需要保留完整历史记录（审计场景）
+- 多人协作的共享分支
+
+\`\`\`bash
+# 保留合并记录（推荐用于 PR/MR 合并）
+git merge --no-ff feature/login
+
+# 快进合并（适合独立小修改）
+git merge --ff-only hotfix/typo
+\`\`\`
+
+**何时用 Rebase**
+- 更新本地功能分支，与主干保持同步
+- 整理本地提交历史，推送 PR 前清理
+
+\`\`\`bash
+# 将功能分支变基到最新 main
+git checkout feature/login
+git rebase origin/main
+
+# 交互式 rebase：合并/重排/修改最近 3 个提交
+git rebase -i HEAD~3
+# 选项: pick / squash(s) / fixup(f) / reword(r) / drop(d)
+\`\`\`
+
+**Squash Merge**（GitHub/GitLab PR 推荐）
+\`\`\`bash
+# 将功能分支所有提交合并为一个干净提交
+git merge --squash feature/login
+git commit -m "feat(auth): add login page with form validation"
+\`\`\`
+
+**推荐工作流**
+1. 本地开发：随意提交，保持节奏
+2. 推送 PR 前：\`git rebase -i origin/main\` 整理提交
+3. PR 合并：使用 Squash Merge 保持主干干净`,
+        },
+        {
+            title: '4. 冲突解决流程',
+            content: `**结构化冲突解决步骤**
+
+\`\`\`bash
+# Step 1: 理解冲突来源
+git log --oneline --graph --all  # 查看分支关系
+git diff HEAD origin/main        # 对比差异
+
+# Step 2: 标记冲突文件分析
+git status  # 查看所有冲突文件
+# conflict markers: <<<<<<< HEAD ... ======= ... >>>>>>> branch
+
+# Step 3: 使用工具辅助解决
+git mergetool  # 调用配置的 merge tool（VSCode / IntelliJ）
+
+# 配置 VSCode 为默认 merge tool
+git config --global merge.tool vscode
+git config --global mergetool.vscode.cmd 'code --wait $MERGED'
+\`\`\`
+
+**三路合并理解（Three-way merge）**
+\`\`\`
+BASE（公共祖先）：const timeout = 5000;
+OURS（当前分支）：const timeout = 10000;  // 改为10s
+THEIRS（被合并）：const TIMEOUT = 5000;   // 改为大写常量名
+RESULT（手动）：  const TIMEOUT = 10000;  // 两个改动都要
+\`\`\`
+
+**预防冲突的最佳实践**
+- 功能分支生命周期控制在 1-3 天内
+- 每日同步主干：\`git pull --rebase origin main\`
+- 大文件/自动生成文件加入 \`.gitattributes\` 配置合并策略
+\`\`\`gitattributes
+# 始终使用 ours 策略合并 lock 文件（减少冲突）
+package-lock.json merge=ours
+yarn.lock merge=ours
+\`\`\``,
+        },
+        {
+            title: '5. Pull Request / Code Review 流程规范',
+            content: `**PR 模板设计**
+\`\`\`markdown
+## 变更说明
+[简洁描述本次变更做了什么、为什么]
+
+## 变更类型
+- [ ] 新功能 (feat)
+- [ ] Bug 修复 (fix)
+- [ ] 重构 (refactor)
+- [ ] 性能优化 (perf)
+
+## 测试验证
+- [ ] 单元测试通过
+- [ ] 手动测试场景: [描述]
+- [ ] 截图/录屏（UI 变更必填）
+
+## 影响范围
+[描述可能影响的模块或依赖方]
+
+## Checklist
+- [ ] 代码自查完毕
+- [ ] 无调试代码 (console.log/debugger)
+- [ ] 文档已更新（如需要）
+\`\`\`
+
+**PR 规模控制**
+- 理想 PR 大小：< 400 行（不含测试）
+- 超过 800 行：强制拆分为多个 PR
+- 可用 \`git diff --stat origin/main\` 提前检查
+
+**分支保护规则（GitHub/GitLab 配置）**
+\`\`\`
+main 分支保护：
+✅ Require pull request reviews (min: 1)
+✅ Require status checks to pass (CI/lint/test)
+✅ Require branches to be up to date
+✅ Restrict push access (仅管理员)
+✅ Require signed commits（高安全场景）
+\`\`\``,
+        },
+        {
+            title: '6. 输出工作流规范文档',
+            content: `整理为团队可直接使用的规范文档，格式如下：
+
+\`\`\`markdown
+## Git 工作流规范
+
+### 分支命名
+- feature/<ticket-id>-short-description  (如: feature/PROJ-123-user-login)
+- fix/<ticket-id>-short-description
+- hotfix/<version>-short-description     (如: hotfix/1.2.1-payment-crash)
+- release/<version>                      (如: release/1.3.0)
+
+### 提交规范
+格式: <type>(<scope>): <subject>
+示例: feat(auth): add JWT refresh token support
+
+### 禁止行为
+❌ 直接推送到 main/master
+❌ force push 到共享分支
+❌ rebase 已推送的公共分支
+❌ 超过 1000 行的单次 PR（紧急 hotfix 除外）
+
+### 分支生命周期
+- feature 分支: ≤ 5 个工作日
+- release 分支: ≤ 2 周
+- hotfix 分支: ≤ 24 小时
+\`\`\``,
+        },
+    ],
+    outputFormat: 'Markdown 工作流规范文档，含分支策略选型建议、提交规范示例、rebase/merge 决策指南、冲突解决 SOP 和 PR 规范模板',
+    examples: [
+        {
+            input: '我们团队5人，做 SaaS 产品，每周发版一次，应该用什么 Git 工作流？',
+            output: `## Git 工作流建议：GitHub Flow（简化 GitFlow）
+
+**推荐理由**：5人小团队 + 每周发版，GitHub Flow 复杂度适中，无需维护多个长期分支。
+
+**分支结构**
+- \`main\`：始终可部署，受保护
+- \`feature/xxx\`：功能开发，完成即 PR，合并即删除
+
+**提交规范**：Conventional Commits
+**合并策略**：Squash Merge（保持 main 历史干净）
+**发版标记**：\`git tag v1.x.0\` 打标签`,
+        },
+    ],
+    notes: [
+        '分支策略没有银弹，根据团队规模和发版频率选择最适合的',
+        'force push 操作必须在团队内公告，避免其他成员本地分支混乱',
+        '建议在 CI 中自动校验 commit message 格式，而非依赖人工审查',
+        '冲突解决后务必运行测试，确保合并结果功能正常',
+    ],
+    nextSkill: 'unit-testing',
+};
+//# sourceMappingURL=15-git-workflow.js.map

package/dist/skills/15-git-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"15-git-workflow.js","sourceRoot":"","sources":["../../src/skills/15-git-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAoB;IAC/C,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,sCAAsC;IACnD,aAAa,EAAE,+FAA+F;IAC9G,iBAAiB,EAAE;2DACsC;IACzD,QAAQ,EAAE;QACR,SAAS;QACT,cAAc;QACd,QAAQ;QACR,MAAM;QACN,oBAAoB;QACpB,WAAW;QACX,mBAAmB;QACnB,MAAM;QACN,OAAO;QACP,iBAAiB;QACjB,MAAM;QACN,YAAY;QACZ,qBAAqB;KACtB;IACD,KAAK,EAAE;QACL;YACE,KAAK,EAAE,kBAAkB;YACzB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAgCW;SACrB;QACD;YACE,KAAK,EAAE,mCAAmC;YAC1C,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCR;SACF;QACD;YACE,KAAK,EAAE,0BAA0B;YACjC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAuCiB;SAC3B;QACD;YACE,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCR;SACF;QACD;YACE,KAAK,EAAE,oCAAoC;YAC3C,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCR;SACF;QACD;YACE,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBR;SACF;KACF;IACD,YAAY,EACV,wEAAwE;IAC1E,QAAQ,EAAE;QACR;YACE,KAAK,EAAE,wCAAwC;YAC/C,MAAM,EAAE;;;;;;;;;;gCAUkB;SAC3B;KACF;IACD,KAAK,EAAE;QACL,4BAA4B;QAC5B,oCAAoC;QACpC,yCAAyC;QACzC,wBAAwB;KACzB;IACD,SAAS,EAAE,cAAc;CAC1B,CAAC"}

package/dist/skills/16-unit-testing.d.ts

@@ -0,0 +1,3 @@
+import type { SkillDefinition } from './types';
+export declare const unitTestingSkill: SkillDefinition;
+//# sourceMappingURL=16-unit-testing.d.ts.map

package/dist/skills/16-unit-testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"16-unit-testing.d.ts","sourceRoot":"","sources":["../../src/skills/16-unit-testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,gBAAgB,EAAE,eAsS9B,CAAC"}