技能系统
技能（Skills）是 Claude Code 中可复用的工作流模板。用户通过 /skill-name 调用，技能内容会被展开成完整的提示词，指导 Claude 按照特定流程工作。
技能 vs 命令 vs 工具
| 特性 | 技能 | 命令 | 工具 |
|---|---|---|---|
| 定义方式 | Markdown 文件 | TypeScript 代码 | TypeScript 代码 |
| 调用方式 | /skill-name | /command | LLM Tool Use |
| 执行者 | LLM 按指导执行 | 代码直接执行 | 代码直接执行 |
| 扩展性 | 用户可自定义 | 需要改代码 | 需要改代码 |
技能文件结构
---
name: investigate
description: 系统性调试，根因分析
---
## 调试四阶段
### 阶段一：调查
收集所有相关信息...
### 阶段二：分析
分析收集到的数据...
### 阶段三：假设
提出可能的根因...
### 阶段四：实施
基于根因修复...
技能存储位置
~/.claude/skills/ # 用户全局技能
├── investigate/
├── ship/
├── qa/
├── frontend-design/
└── ...
.claude/skills/ # 项目级技能
└── ...
~/.claude/plugins/cache/ # 插件提供的技能
└── superpowers/
└── skills/
技能分类
开发流程技能
| 技能 | 说明 |
|---|---|
/ship | 完整发布流程：测试、审查、版本、CHANGELOG、推送、PR |
/review | PR 审查：SQL 安全、LLM 信任边界、副作用检测 |
/investigate | 系统性调试：调查 → 分析 → 假设 → 实施 |
/retro | 周回顾：提交分析、代码质量指标、团队贡献 |
设计技能
| 技能 | 说明 |
|---|---|
/frontend-design | 高质量前端界面设计与实现 |
/design-consultation | 完整设计系统：美学、排版、配色、布局 |
/design-review | 视觉 QA：间距、层级、AI 生成痕迹检测 |
/web-design-guidelines | Web 界面设计规范审查 |
QA 技能
| 技能 | 说明 |
|---|---|
/qa | 系统性 QA 测试 + 自动修复 |
/qa-only | 仅报告 Bug，不修复 |
/browse | 无头浏览器交互测试 |
计划审查技能
| 技能 | 说明 |
|---|---|
/plan-ceo-review | CEO 视角：重新思考问题，找 10 星产品 |
/plan-eng-review | 工程经理视角：架构、数据流、边界情况 |
/plan-design-review | 设计师视角：交互式设计维度评分 |
安全技能
| 技能 | 说明 |
|---|---|
/careful | 危险命令警告 |
/freeze | 限制编辑范围到指定目录 |
/guard | careful + freeze 的组合 |
工具技能
| 技能 | 说明 |
|---|---|
/agent-browser | 浏览器自动化 |
/agent-reach | 多平台信息获取 |
/codex | OpenAI Codex 集成 |
/office-hours | YC Office Hours 模式 |
技能类型
刚性技能 (Rigid)
必须严格按照步骤执行，不能跳过或简化。
例如：TDD 技能要求先写测试再写实现，不能颠倒。
柔性技能 (Flexible)
提供原则和指导，可以根据具体情况调整。
例如：前端设计技能提供设计原则，具体实现可以灵活调整。
自定义技能
用户可以创建自己的技能：
- 在
~/.claude/skills/下创建目录 - 编写技能 Markdown 文件
- 添加 frontmatter（name, description）
- 通过
/skill-name调用