TIP

Agent Skills（智能体技能） 是一种模块化的能力扩展系统，它为 Claude 提供了领域专业知识、工作流程和最佳实践。

与传统的 Prompt（对话级别的一次性指令）不同，Skills 具有以下特点：

📦 模块化封装：将指令、脚本、资源文件组织成独立的技能包
🔄 按需加载：只在相关任务时才加载，不占用多余上下文
🔌 可组合性：多个 Skills 可以协同工作，构建复杂工作流
♻️ 可复用性：创建一次，跨多个对话自动使用

技能结构解剖

my-code-review-skill/       # 技能文件夹（建议 kebab-case 命名）
├── SKILL.md                # 【必需】技能核心定义文件
├── scripts/                # 【可选】可执行脚本（.py, .sh, .js）
│   └── format-code.py
├── references/             # 【可选】参考资料（Claude 按需读取）
│   └── eslint-rules.md
└── assets/                 # 【可选】静态资源（模板、图片等）
    └── report-template.md

SKILL.md的二元结构

这是技能的心脏，采用 YAML Frontmatter + Markdown Body​ 格式。

A. Frontmatter（元数据）

---
name: "my-code-review"                    # 必填。小写+连字符，即斜杠命令名
description: "对代码进行安全与规范审查。当用户说‘review’、‘代码审查’或提交代码时触发。" # 必填。Claude 靠这个自动匹配
license: "MIT"                            # 可选。许可证
compatibility: "Claude Code"              # 可选。运行环境要求
allowed-tools: "Read Bash"                # 可选。预授权工具（如代码执行）
disable-model-invocation: false           # 可选。设为 true 则禁止 Claude 自动加载，仅手动调用
---

位于文件顶部 ---之间，用于声明技能的身份和触发条件。

Body（指令体）

# 代码审查 SOP

## 工作流程
1.  读取用户指定的文件或 Diff 内容。
2.  使用 `scripts/` 中的工具进行静态分析。
3.  输出结构化报告。

## 输出规范
-   必须包含**严重等级**（高危/中危/低危）。
-   必须给出具体的**修复代码建议**。