Claude Code Skills 官方完整指南：从入门到高级模式的权威教程

---
name: my-skill                    # 显示名称，小写字母/数字/连字符，最多 64 字符
description: 技能描述              # 推荐填写，Claude 用这个决定何时使用
when_to_use: 触发词或示例请求      # 补充 description，合计不超过 1536 字符
argument-hint: "[issue-number]"   # 自动补全时显示的参数提示
arguments: [issue, branch]        # 命名位置参数，用于 $name 替换
disable-model-invocation: true    # 只允许用户调用，Claude 不自动触发
user-invocable: false             # 只允许 Claude 调用，不出现在 / 菜单
allowed-tools: Read Bash(git *)   # 技能激活时预授权的工具
model: claude-sonnet-4-6          # 覆盖当前会话模型
effort: high                      # 覆盖当前努力等级（low/medium/high/xhigh/max）
context: fork                     # fork 在独立子 agent 上下文里运行
agent: Explore                    # context: fork 时使用哪种 subagent
paths: "src/**/*.ts"              # 路径 glob，仅匹配文件时自动激活
shell: bash                       # 内联 shell 命令的 Shell（bash/powershell）
hooks:                            # 技能生命周期的 Hooks
  PostSkillUse:
    - type: command
      command: echo "skill done"
---

---
name: fix-issue
description: 修复 GitHub Issue
disable-model-invocation: true
allowed-tools: Bash(gh *) Read Glob Grep Edit Write
---

按照我们的编码规范修复 GitHub Issue $ARGUMENTS：

1. 用 `gh issue view $ARGUMENTS` 读取 Issue 详情
2. 理解需求
3. 实现修复
4. 写测试
5. 创建 commit（包含 "Fixes #$ARGUMENTS" 的 commit 消息）

---
name: api-conventions
description: 这个代码库的 API 设计模式
---

编写 API 端点时：
- 使用 RESTful 命名约定
- 返回一致的错误格式 { code, message, details }
- 包含请求验证（Zod schema）
- 所有端点必须有 OpenAPI 注释

---
name: deploy
description: 部署应用到生产环境
context: fork
disable-model-invocation: true
---

部署 $ARGUMENTS 到生产环境：

1. 运行测试套件（`npm test`），失败则停止
2. 构建（`npm run build`）
3. 推送到部署目标
4. 验证部署成功（健康检查）
5. 通知 Slack #deployments 频道

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

## Pull Request 上下文（实时数据）

- PR 差异：!`gh pr diff`
- PR 评论：!`gh pr view --comments`
- 变更文件：!`gh pr diff --name-only`

## 你的任务

总结这个 Pull Request：
1. 主要变更是什么？
2. 有没有潜在风险？
3. 建议的测试重点

---
name: react-patterns
description: React 组件的最佳实践模式
paths: "src/components/**/*.tsx,src/pages/**/*.tsx"
---

编写 React 组件时：
- 使用函数式组件和 Hooks
- Props 用 interface 而非 type
- 使用 React.memo 包裹纯展示组件

---
name: commit
description: 暂存并提交当前变更
disable-model-invocation: true
allowed-tools: Bash(git add *) Bash(git commit *) Bash(git status *) Bash(git diff *)
---

暂存并提交当前变更：

1. 运行 `git status` 查看变更
2. 运行 `git diff --staged` 检查暂存内容
3. 生成描述性 commit 消息（遵循 Conventional Commits 规范）
4. 运行 `git add -A && git commit -m "消息"`
5. 确认 commit 成功

---
name: security-check
description: 对当前变更进行安全审查
allowed-tools: Read Glob Grep
effort: xhigh
---

对以下变更进行安全审查：!`git diff HEAD`

重点检查：

**输入验证**
- SQL 注入（字符串拼接 SQL）
- XSS（未转义的用户输入输出到 HTML）
- 路径遍历（用户控制的文件路径）

**认证和授权**
- 缺失认证检查
- 硬编码密钥或密码
- 不安全的 token 存储

**数据暴露**
- 日志里的敏感信息
- 过多的 API 响应字段
- 错误消息暴露内部细节

输出：按严重性排序的发现（Critical/High/Medium/Low），每项包含：位置、问题说明、修复建议。

---
name: pr-desc
description: 根据变更自动生成 PR 描述
disable-model-invocation: true
allowed-tools: Bash(gh *) Bash(git *)
---

## 当前变更

提交历史：!`git log main..HEAD --oneline`
变更统计：!`git diff main --stat`

## 生成 PR 描述

根据以上变更，生成符合以下模板的 PR 描述：

### What
（用 1-2 句话描述这个 PR 做了什么）

### Why  
（为什么需要这个变更）

### How
（关键实现思路，不超过 5 个要点）

### Testing
（如何验证这个 PR，测试场景）

### Screenshots
（如有 UI 变更，在此说明截图位置）

---
name: debt-check
description: 检查当前文件的技术债标记
paths: "**/*.ts,**/*.tsx,**/*.py,**/*.go"
user-invocable: false
---

检查这个文件里的技术债标记：

1. 找出所有 TODO、FIXME、HACK、XXX 注释
2. 评估每个标记的：严重性、是否过时（结合 git blame）、预估修复时间
3. 如果有超过 90 天的 TODO，特别标注

输出简洁的摘要，不超过 10 行。