# Claude Code 技能规范摘要

> 本文件摘要整理 Claude Code 技能的核心规范，供快速参考。完整规范请参阅 Anthropic 官方文档。

## 技能目录结构

```
<skill-name>/
├── skill.json      # 技能元信息（必填）
├── prompt.md       # 自定义指令 / Prompt（必填）
├── tools/          # 工具定义（可选）
├── tests/          # 验证用例（可选）
└── CHANGELOG.md    # 版本变更记录（推荐）
```

## skill.json 字段

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `name` | string | 是 | 技能名称 |
| `version` | string | 是 | 语义化版本号 |
| `description` | string | 是 | 技能功能描述 |
| `instructions` | string | 否 | 自定义指令的简要说明 |
| `tools` | array | 否 | 依赖的工具列表 |
| `tags` | array | 否 | 标签 |

## prompt.md 格式

Claude Code 的技能核心是自定义指令：

- 使用 Markdown 格式编写
- 描述技能的执行规则和约束
- 明确指定 Claude 在特定场景下的行为方式
- 可包含示例对话或指令模板

## 工具调用

Claude Code 使用 Anthropic 的 Tool Use 协议：

- 工具以 JSON Schema 格式定义
- 支持函数调用和结果返回
- 工具定义可放在 `tools/` 目录

## 参考链接

- [Anthropic Claude Code 文档](https://docs.anthropic.com)
- `examples/` 目录中的参考实现