---
name: super-dev-assistant
description: 一个万能开发助手
---

你是一个高级开发助手，负责代码审查、测试编写、文档生成、部署发布...
（500行指令）

graph TB
    subgraph "六种Skill设计模式"
        A[原子模式<br/>单一职责]
        B[管道模式<br/>顺序链式]
        C[路由模式<br/>条件分发]
        D[扇出模式<br/>并行执行]
        E[守卫模式<br/>安全校验]
        F[适配器模式<br/>平台桥接]
    end

    A -->|组合| B
    A -->|组合| C
    B -->|需要| E
    C -->|触发| D
    D -->|输出| F

mkdir -p .claude/skills/commit-msg-gen

---
name: commit-msg-gen
description: 根据暂存区变更生成符合Conventional Commits规范的提交信息
triggers:
  - /commit-msg
  - 生成提交信息
  - commit message
---

# 提交信息生成器

## 触发条件
当用户请求生成提交信息时激活此Skill。

## 工作流程

1. **分析暂存区**
   运行 `git diff --cached --stat` 获取变更概览。
   运行 `git diff --cached` 获取详细差异。

2. **推断变更类型**
   根据文件路径和diff内容判断类型：
   - `feat:` 新功能（新增文件、新API端点）
   - `fix:` 缺陷修复（修改bug相关代码）
   - `refactor:` 重构（无功能变化的代码调整）
   - `docs:` 文档变更（*.md文件）
   - `test:` 测试（test/目录下文件）
   - `chore:` 构建/工具变更（配置文件、CI）

3. **生成提交信息**
   格式：
   ```
   <type>(<scope>): <简明描述>

   <可选的详细说明>
   ```

4. **输出**
   直接输出生成的提交信息文本，不自动执行git commit。

## 约束
- 只生成提交信息，不执行提交操作
- 描述行不超过72字符
- 不猜测用户意图，只基于diff内容推断

graph LR
    A[Skill A<br/>数据采集] -->|输出| B[Skill B<br/>内容生成]
    B -->|输出| C[Skill C<br/>格式校验]
    C -->|输出| D[Skill D<br/>发布]

mkdir -p .claude/skills/blog-pipeline

---
name: blog-pipeline
description: 端到端博客文章发布流水线，从选题研究到最终发布
triggers:
  - /blog-pipeline
  - 发布博客
  - 博客流水线
dependencies:
  - deep-research
  - content-creator
  - markdown-to-image
---

# 博客发布流水线

## 工作流程

此Skill协调以下步骤的顺序执行：

### Step 1: 选题研究（调用 deep-research）
使用TodoWrite记录任务：`[pending] 选题研究`

标记任务完成：`[completed] 选题研究`

### Step 2: 内容创作（调用 content-creator）
使用TodoWrite记录任务：`[in_progress] 内容创作`

标记任务完成：`[completed] 内容创作`

### Step 3: 封面图生成（调用 markdown-to-image）
使用TodoWrite记录任务：`[in_progress] 封面图生成`

### Step 4: 最终校验
使用TodoWrite记录任务：`[in_progress] 最终校验`

检查清单：
- [ ] 文章字数 >= 3000
- [ ] 所有代码块语法高亮正确
- [ ] Mermaid图表可渲染
- [ ] 封面图已生成
- [ ] 参考来源已列出

## 错误处理
任何步骤失败时，在TodoWrite中标记该步骤为pending，并提示用户决定：
1. 重试当前步骤
2. 跳过当前步骤
3. 终止整个流水线

graph TD
    R[路由Skill<br/>分析输入] -->|代码变更| A[代码审查Skill]
    R -->|文档变更| B[文档审查Skill]
    R -->|配置变更| C[安全审查Skill]
    R -->|测试变更| D[测试审查Skill]

mkdir -p .claude/skills/smart-reviewer

---
name: smart-reviewer
description: 智能代码审查路由器，根据变更类型自动选择审查策略
triggers:
  - /review
  - 审查代码
  - code review
---

# 智能代码审查路由器

## 路由逻辑

当用户请求代码审查时，按以下规则分发：

### 路由规则表

| 变更特征 | 目标策略 | 说明 |
|----------|----------|------|
| `*.py` 文件变更 | Python审查模式 | PEP8、类型注解、docstring |
| `*.ts/*.tsx` 文件变更 | TypeScript审查模式 | 类型安全、React最佳实践 |
| `*.sql` 文件变更 | 数据库审查模式 | SQL注入检测、索引优化 |
| `docker-compose*.yml` | 基础设施审查模式 | 安全基线、资源限制 |
| `.env*` 或 `*secret*` | 安全紧急审查模式 | 凭据泄露检测 |
| 混合变更 | 多策略并行 | 识别所有变更类型，分别审查 |

### 执行流程

1. 运行 `git diff --name-only` 获取变更文件列表
2. 根据文件扩展名和路径匹配路由规则
3. 对每种匹配的类型，应用对应的审查清单
4. 汇总所有审查结果，按严重程度排序输出

### 输出格式

```markdown
## 审查结果

### 🔴 严重 (必须修复)
- [文件:行号] 问题描述

### 🟡 建议 (推荐修复)
- [文件:行号] 改进建议

### 🟢 良好 (值得肯定)
- 良好实践说明

### 4.3 路由模式的精髓

路由模式的核心是**规则表**——一个清晰的映射关系，让Claude Code能根据输入特征做出确定性判断。这比"AI自行判断"更可靠，因为规则是显式声明的。

**设计技巧**：路由规则要覆盖所有可能的输入类型，最后一条规则应该是"默认路由"（如上例中的"混合变更"），避免出现无法路由的情况。

---

## 第五章：模式四——扇出Skill（Fan-out Pattern）

### 5.1 模式定义

**核心思想**：将一个任务拆分为多个独立子任务，并行分发给多个Subagent执行。

```mermaid
graph TD
    O[编排Skill] -->|子任务1| A1[Agent 1<br/>前端测试]
    O -->|子任务2| A2[Agent 2<br/>后端测试]
    O -->|子任务3| A3[Agent 3<br/>集成测试]
    O -->|子任务4| A4[Agent 4<br/>安全扫描]
    A1 -->|结果| M[结果聚合]
    A2 -->|结果| M
    A3 -->|结果| M
    A4 -->|结果| M

mkdir -p .claude/skills/parallel-test-runner

---
name: parallel-test-runner
description: 并行测试运行器，同时启动多个独立测试任务
triggers:
  - /test-all
  - 运行全部测试
  - parallel test
---

# 并行测试运行器

## 执行策略

当收到测试请求时，使用 Task 工具并行启动以下子代理：

### 扇出配置

```javascript
// 伪代码展示扇出逻辑
const tasks = [
  {
    subagent_type: "general-purpose",
    description: "前端单元测试",
    prompt: "运行前端测试套件：cd frontend && npm test。收集所有测试结果，输出通过/失败计数。"
  },
  {
    subagent_type: "general-purpose",
    description: "后端API测试",
    prompt: "运行后端测试套件：cd backend && pytest --tb=short。收集所有测试结果，输出通过/失败计数。"
  },
  {
    subagent_type: "general-purpose",
    description: "集成测试",
    prompt: "运行集成测试：docker compose up -d test-db && npm run test:integration。收集所有测试结果。"
  },
  {
    subagent_type: "general-purpose",
    description: "Lint和类型检查",
    prompt: "运行代码质量检查：npm run lint && npm run typecheck。报告所有警告和错误。"
  }
];
// 所有Task工具调用在同一消息中并行发出

### 5.3 扇出模式的实现要点

扇出模式在Claude Code中的实现依赖 **Task工具的并行调用**。关键技巧：

1. **在同一消息中发起多个Task调用**——这确保了真正的并行执行
2. **每个子代理设置 `max_turns`**——防止单个任务无限循环
3. **使用 `run_in_background: true`**——让主线程不被阻塞
4. **显式定义聚合格式**——子代理的输出格式必须统一，才能正确聚合

---

## 第六章：模式五——守卫Skill（Guard Pattern）

### 6.1 模式定义

**核心思想**：在其他Skill执行前/后执行校验逻辑，充当安全闸门。

```mermaid
sequenceDiagram
    participant U as 用户请求
    participant G as 守卫Skill
    participant T as 目标Skill

    U->>G: 请求执行操作
    G->>G: 前置校验
    alt 校验通过
        G->>T: 放行，执行操作
        T->>G: 返回结果
        G->>G: 后置校验
        G->>U: 返回最终结果
    else 校验失败
        G->>U: 返回错误原因
    end

mkdir -p .claude/skills/deploy-guard

---
name: deploy-guard
description: 部署安全守卫，在执行部署前执行全面的安全合规检查
triggers:
  - /deploy
  - 部署
  - deploy
---

# 部署安全守卫

## 前置检查清单

在任何部署操作之前，必须按顺序执行以下检查：

### 第一关：代码状态检查
```bash
# 检查是否有未提交的变更
git status --porcelain
# 检查当前分支
git branch --show-current
# 检查是否与远程同步
git fetch && git status -uno

# 检查环境变量文件
find . -name ".env*" -not -path "./.git/*" -not -name ".env.example"
# 检查硬编码的密钥
grep -rn "sk-\|api_key\|secret\|password" --include="*.ts" --include="*.py" --include="*.js" .
# 检查敏感文件是否在.gitignore中
cat .gitignore | grep -E "\.env|credentials|secret"

npm test 2>&1 | tail -5

npm run build 2>&1 | tail -5

🛡️ 部署守卫报告
================
✅ 代码状态：[通过/失败] - 详情
✅ 安全扫描：[通过/失败] - 详情
✅ 测试验证：[通过/失败] - 详情
✅ 构建验证：[通过/失败] - 详情
================
最终决策：[允许部署 / 阻止部署]

### 6.3 守卫模式的分层设计

守卫模式的精髓在于**分级阻断**：

- **阻止级（Block）**：绝对不能跳过，如凭据泄露检测
- **警告级（Warn）**：提示风险但允许继续，如覆盖率不足
- **信息级（Info）**：纯通知，如构建警告数量

这种分层让守卫既严格又灵活，不至于因为小问题完全卡死流水线。

---

## 第七章：模式六——适配器Skill（Adapter Pattern）

### 7.1 模式定义

**核心思想**：将Claude Code的标准输出转换为特定平台或工具期望的格式。

**适用场景**：生成不同平台的文档、适配多种CI系统的配置、跨平台内容发布。

### 7.2 实战：创建适配器Skill

```bash
mkdir -p .claude/skills/notion-adapter

---
name: notion-adapter
description: 将Markdown文档转换为Notion API兼容的块格式
triggers:
  - /to-notion
  - 发布到Notion
  - notion adapter
dependencies:
  - markdown-to-image
---

# Notion内容适配器

## 转换规则

将标准Markdown转换为Notion API的Block格式：

| Markdown元素 | Notion Block类型 | 转换规则 |
|-------------|------------------|----------|
| `# 标题` | `heading_1` | 直接映射 |
| `## 标题` | `heading_2` | 直接映射 |
| `### 标题` | `heading_3` | 直接映射 |
| `` `code` `` | `rich_text` + code annotation | 行内代码 |
| ` ```code block``` ` | `code` | 需指定language |
| `> 引用` | `quote` | 直接映射 |
| `- 列表` | `bulleted_list_item` | 支持嵌套 |
| `1. 列表` | `numbered_list_item` | 支持嵌套 |
| `[link](url)` | `rich_text` + href | 保留链接 |
| `![img](url)` | `image` | 需上传或使用外部URL |
| `---` | `divider` | 直接映射 |
| `| 表格 |` | Notion API table block | 逐行转换 |
| Mermaid代码块 | 截图上传 | 先渲染为PNG再上传 |

## 执行步骤

1. 读取源Markdown文件
2. 逐行解析，按转换规则映射为Notion Block对象
3. 处理特殊情况：
   - Mermaid图表：调用 markdown-to-image 渲染为PNG
   - 内嵌图片：验证URL可达性
   - 表格：转换Notion table_block格式
4. 构建完整的Notion API请求体
5. 通过MCP Notion工具或直接API调用发布
6. 输出发布后的页面URL

## 输出验证
发布后验证：
- 页面标题正确
- 所有代码块保留语法高亮
- 图片正常显示
- 链接可点击

## 约束
- Notion API单次请求最多100个Block
- 超过100个Block时分批发送
- 图片大小不超过5MB

核心Skill → 适配器A → 平台A
           → 适配器B → 平台B
           → 适配器C → 平台C

graph TB
    subgraph "内容发布平台"
        CLI[用户输入主题] --> ROUTER[路由模式<br/>判断内容类型]

        ROUTER -->|技术博客| RESEARCH[原子模式<br/>深度调研]
        ROUTER -->|教程| OUTLINE[原子模式<br/>大纲生成]
        ROUTER -->|新闻| DIGEST[原子模式<br/>新闻摘要]

        RESEARCH --> WRITER[原子模式<br/>内容创作]
        OUTLINE --> WRITER
        DIGEST --> WRITER

        WRITER --> GUARD[守卫模式<br/>质量检查]

        GUARD -->|通过| FANOUT[扇出模式<br/>多平台适配]
        GUARD -->|失败| WRITER

        FANOUT --> ADAPTER_N[适配器模式<br/>Notion]
        FANOUT --> ADAPTER_M[适配器模式<br/>Markdown]
        FANOUT --> ADAPTER_W[适配器模式<br/>微信公众号]
    end

mkdir -p .claude/skills/content-platform

---
name: content-platform
description: 全自动化内容发布平台，从选题到多平台发布一站式完成
triggers:
  - /publish
  - 内容发布
  - content platform
dependencies:
  - smart-reviewer
  - deploy-guard
  - notion-adapter
---

# 内容发布平台

## 系统架构

本Skill是内容发布平台的编排层，协调六个子模块完成端到端发布流程。

## 完整工作流

### Phase 1: 路由分析
接收用户输入的主题和内容类型。根据类型选择生成策略：
- `tech` → 技术深度调研路线
- `tutorial` → 教程结构化路线
- `news` → 新闻聚合路线
- 未指定 → 自动判断

使用TodoWrite创建任务列表：

### Phase 2: 内容生成（管道模式）

按顺序执行调研 → 大纲 → 创作：

**调研步骤**：
使用Task工具（subagent_type: general-purpose）执行调研。
输入：主题关键词
输出：调研笔记（含数据点、引用来源）

**大纲步骤**：
基于调研结果生成结构化大纲，包含：
- 每节的要点
- 代码示例位置标记
- 图表插入位置

**创作步骤**：
根据大纲生成完整内容：
- 技术博客：3000字以上，含代码和图表
- 教程：分步骤，每步有操作说明和预期结果
- 新闻摘要：500-800字，多源对比

### Phase 3: 质量守卫

执行三重校验：
1. **格式守卫**：Markdown语法正确性、代码块闭合
2. **内容守卫**：字数达标、无占位符、引用来源完整
3. **安全守卫**：无敏感信息泄露、URL可达

任何守卫不通过 → 返回Phase 2修改

### Phase 4: 多平台扇出

守卫通过后，并行执行平台适配：

同时启动3个Task子代理：
- Task 1: Notion适配（notion-adapter）
- Task 2: 纯Markdown输出（格式化本地文件）
- Task 3: 微信公众号适配（HTML转换）

### Phase 5: 发布确认

汇总所有平台输出：

等待用户确认后执行最终发布。

## 错误恢复
- Phase 2失败：记录失败步骤，允许用户选择重试或跳过
- Phase 3失败：自动返回Phase 2并附上修改建议
- Phase 4失败：成功的平台继续发布，失败的重试一次
- Phase 5失败：保留所有本地副本，提示手动发布

# 预期目录结构
.claude/skills/
├── commit-msg-gen/          # 原子模式
│   └── SKILL.md
├── blog-pipeline/           # 管道模式
│   └── SKILL.md
├── smart-reviewer/          # 路由模式
│   └── SKILL.md
├── parallel-test-runner/    # 扇出模式
│   └── SKILL.md
├── deploy-guard/            # 守卫模式
│   └── SKILL.md
├── notion-adapter/          # 适配器模式
│   └── SKILL.md
└── content-platform/        # 编排层
    └── SKILL.md

# 测试原子Skill
claude "/commit-msg"

# 测试路由Skill
claude "/review"

# 测试完整流水线
claude "/publish 写一篇关于Rust异步编程的技术博客"

graph TD
    START[新Skill需求] --> Q1{是否只做一件事?}
    Q1 -->|是| ATOMIC[原子模式]
    Q1 -->|否| Q2{步骤是否固定?}

    Q2 -->|是,按顺序| Q3{是否需要校验?}
    Q2 -->|否| Q4{需要选择分支吗?}

    Q3 -->|是| GUARD[守卫模式 + 管道模式]
    Q3 -->|否| PIPELINE[管道模式]

    Q4 -->|是| ROUTER[路由模式]
    Q4 -->|否| Q5{是否并行处理?}

    Q5 -->|是| FANOUT[扇出模式]
    Q5 -->|否| Q6{是否格式转换?}

    Q6 -->|是| ADAPTER[适配器模式]
    Q6 -->|否| COMPOSITE[组合使用多种模式]

# ❌ 坏：太宽泛
description: 帮助处理代码

# ✅ 好：精确到触发场景
description: 分析Python函数的执行时间复杂度并生成Big-O报告

triggers:
  - /review          # 斜杠命令精确触发
  - 审查代码          # 自然语言触发
  - code review       # 英文触发

<!-- 在管道Skill中约定中间文件路径 -->
## 数据传递规范
- 调研结果保存到: `.claude/cache/research-output.md`
- 大纲保存到: `.claude/cache/outline.md`
- 最终内容保存到: `.claude/cache/content.md`

graph LR
    A[Skill A] -->|依赖| B[Skill B]
    B -->|依赖| A
    style A fill:#f66
    style B fill:#f66

# 只允许文件读取，禁止写入
tools:
  - Read
  - Glob
  - Grep