Skills

my-skill/
├── SKILL.md              # 必需：主指令文件
├── references/           # 可选：参考文档（按需加载）
│   ├── api-guide.md
│   └── examples.md
├── scripts/              # 可选：可执行脚本
│   └── validate.py
├── assets/               # 可选：模板、字体、图片
│   └── template.html
└── evals/                # 建议：评估测试
    └── evals.json

---
name: code-review                    # Skill 名称，成为 /slash-command
description: 按照团队规范审查代码。当用户请求代码审查、PR review、检查代码质量时使用。
when_to_use: 触发短语：review, 审查, 检查代码, code review
disable-model-invocation: false      # 是否禁止 Claude 自动调用
user-invocable: true                 # 是否对用户可见（/菜单中显示）
allowed-tools: Read Grep Bash(git *) # 预授权工具
model: sonnet                        # 激活时使用的模型
context: fork                        # 在子代理中运行
agent: Explore                       # 子代理类型
---

# 代码审查 Skill

## 审查清单

1. **功能正确性**：代码是否实现了预期功能
2. **代码风格**：是否符合团队编码规范
3. **安全性**：是否存在注入、XSS、敏感信息泄露等风险
4. **性能**：是否存在明显的性能问题
5. **可测试性**：是否易于测试，测试覆盖率如何

## 输出格式

对每个审查项给出：
- 状态：通过 / 建议改进 / 必须修复
- 具体问题描述
- 改进建议（含代码示例）

---
name: fix-issue
description: 修复指定 GitHub Issue
disable-model-invocation: true
---

修复 GitHub Issue #$ARGUMENTS：
1. 读取 Issue 描述
2. 理解需求
3. 实现修复
4. 编写测试
5. 创建提交

---
name: pr-summary
description: 总结当前 Pull Request
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---

## PR 上下文
- PR diff: !`gh pr diff`
- PR 评论: !`gh pr view --comments`
- 变更文件: !`gh pr diff --name-only`

## 任务
总结这个 Pull Request 的变更内容、潜在风险和测试覆盖缺口。

## 环境信息
```!
node --version
npm --version
git status --short
```

---
name: code-review
description: 按照团队规范进行代码审查。当用户请求 review、代码审查、检查 PR、分析代码质量时自动激活。
when_to_use: 触发词：review, 审查, PR, code review, 检查代码
---

# 代码审查指南

## 审查流程

1. **理解变更范围**
   - 读取变更文件的完整内容
   - 理解变更的业务背景和目的
   - 检查相关测试文件是否同步更新

2. **逐文件审查**
   - 检查功能正确性
   - 检查代码风格和命名规范
   - 检查错误处理完整性
   - 检查安全性问题
   - 检查性能影响

3. **输出审查报告**
   - 按严重程度分类问题
   - 提供具体的改进建议（含代码示例）
   - 标记必须修复 vs 建议改进

## 审查标准

### 必须修复（Blocker）
- 安全漏洞（SQL 注入、XSS、敏感信息硬编码）
- 明显的功能缺陷
- 破坏现有测试
- 类型错误（TypeScript 项目）

### 建议改进（Suggestion）
- 命名不够清晰
- 缺少注释或文档
- 可优化的算法复杂度
- 可提取的重复代码

## 输出格式

## 常见陷阱

- 不要只关注风格问题而忽略功能正确性
- 对于重构类 PR，重点关注是否保持了行为一致性
- 检查边界条件和错误路径是否被覆盖

// evals/evals.json
{
  "evals": [
    {
      "name": "basic-trigger",
      "prompt": "帮我 review 这个文件",
      "expected": "skill should be invoked"
    },
    {
      "name": "security-check",
      "prompt": "检查这段代码是否有安全问题",
      "expected": "reports security issues if present"
    }
  ]
}

# 在 Claude Code 中
"使用 skill-creator 帮我创建一个数据库迁移 Skill"

# Claude Code
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

# 或通过 skills.sh 安装
npx skills add https://github.com/anthropics/skills --skill xlsx

"创建一个 Q3 销售数据的 Excel 文件，包含收入趋势图"
"把这份数据转换成 PowerPoint 演示文稿"
"从这个 PDF 中提取表格数据并生成 Excel"

# 项目结构
my-project/
├── .claude/
│   └── skills/
│       ├── code-review/
│       │   └── SKILL.md
│       └── deploy/
│           └── SKILL.md
├── src/
└── package.json

my-plugin/
├── .claude-plugin/
│   └── plugin.json       # 插件元数据
└── skills/
    ├── code-review/
    │   └── SKILL.md
    └── deploy/
        └── SKILL.md

{
  "name": "my-team-skills",
  "description": "我们团队的自定义 Skills 集合",
  "version": "1.0.0",
  "author": { "name": "Team Name" }
}

---
name: pr-review
description: 审查 Pull Request，检查代码质量、安全性和团队规范符合度。当用户请求 review PR、审查代码变更、检查 pull request 时激活。
context: fork
agent: Explore
allowed-tools: Read Grep Bash(git *)
---

# PR 审查流程

## 前置检查
1. 获取 PR diff：`git diff main...HEAD`
2. 获取提交历史：`git log --oneline main..HEAD`
3. 检查 CI 状态

## 审查维度

### 1. 功能正确性
- 变更是否实现了 PR 描述中的目标
- 边界条件是否被处理
- 是否有回归风险

### 2. 代码质量
- 是否符合项目编码规范
- 命名是否清晰、一致
- 函数长度是否合理（建议 < 50 行）
- 复杂度是否可控

### 3. 安全性
- 用户输入是否被正确校验
- 是否存在 SQL 注入、XSS 风险
- 敏感信息是否被硬编码
- 权限检查是否完整

### 4. 测试
- 新增代码是否有对应测试
- 测试是否覆盖了正常路径和异常路径
- 现有测试是否仍然通过

## 输出格式

对每个审查维度给出评分（通过/警告/阻塞），并提供：
- 具体问题描述
- 建议的修复方案（含代码示例）
- 优先级（P0-必须修复 / P1-建议修复 / P2-可选优化）

---
name: weekly-report
description: 从 Git 提交历史生成本周工作周报。当用户请求生成周报、weekly report、本周总结时激活。
disable-model-invocation: true
allowed-tools: Bash(git *)
---

# 周报生成器

## 数据收集

执行以下命令收集本周工作数据：

```bash
# 本周提交（按作者分组）
git log --since="1 week ago" --author="$(git config user.name)" --pretty=format:"%h %s" --no-merges

# 变更文件统计
git diff --stat HEAD@"{1 week ago}"..HEAD

# 参与的 PR
gh pr list --search "updated:>$(date -v-7d +%Y-%m-%d) author:@me" --state all

# 周报 $(date +%Y-%m-%d)

## 本周完成
- [项目/模块] 具体工作内容（关联提交 hash）

## 进行中
- [项目/模块] 当前进度和下一步计划

## 遇到的问题
- 问题描述及解决方案（如有）

## 下周计划
- 优先级排序的工作项

### 6.3 数据处理 Skill

```yaml
---
name: data-cleaning
description: 清洗和标准化数据文件（CSV、JSON、Excel）。当用户请求清洗数据、data cleaning、处理脏数据、标准化格式时激活。
allowed-tools: Read Write Bash(python3 *)
---

# 数据清洗工作流

## 第一步：数据探查

1. 读取数据文件，分析结构
2. 生成数据质量报告：
   - 总行数、列数
   - 每列的数据类型
   - 缺失值比例
   - 重复行数量
   - 异常值统计

## 第二步：清洗规则

根据数据探查结果，执行以下清洗操作：

1. **处理缺失值**
   - 数值列：用中位数填充或删除
   - 类别列：用众数填充或标记为"未知"
   - 时间列：用前后值插值

2. **处理重复值**
   - 删除完全重复的行
   - 对业务关键列检查逻辑重复

3. **标准化格式**
   - 日期格式统一为 ISO 8601
   - 文本去除首尾空格，统一大小写规则
   - 数值单位统一

4. **异常值处理**
   - 使用 IQR 方法识别异常值
   - 根据业务规则决定删除或修正

## 第三步：输出

1. 生成清洗后的数据文件
2. 生成清洗报告，记录：
   - 原始数据状态
   - 应用的清洗规则
   - 清洗前后的统计对比
   - 被修改/删除的数据明细

description: 分析 Figma 设计文件并生成开发者交接文档。当用户上传 .fig 文件、请求"design specs"、"component documentation"或"design-to-code handoff"时使用。

description: 帮助处理项目相关任务。  # 太模糊，无触发词

<!-- SKILL.md -->
## 额外资源

- 完整 API 细节，参见 [reference.md](reference.md)
- 使用示例，参见 [examples.md](examples.md)
- 验证脚本，参见 [scripts/validate.py](scripts/validate.py)