Skills
skills（技能）是指个体或系统执行特定任务所需的方法、经验与工具的集合。
Skills 本质上就是教 AI 按固定流程做事的操作说明书，一旦写好，就能像函数一样反复调用。
我们可以把 Skills 看成把"某类事情应该怎么专业做"这件事，封装成一个可复用、可自动触发的能力模块。
Skills 和传统 Prompt 最大的区别是：按需加载 + 渐进式披露（只在需要时才把厚厚的 SOP 塞进上下文，极大节省 token）。
一、skills的核心概念
- 通用定义
- 技能是完成任务的步骤化能力，涉及实践经验的规范化9。例如：编程能力、沟通技巧等。
- AI领域的skills
- 指AI执行复杂任务的"能力包"，包含：
- 结构组成：自然语言说明（SKILL.md）、可执行脚本（如Python）、参考文档4。
- 核心价值：让AI突破纯文本交互，实现自动化操作（如生成文件、调用工具）14。
二、如何学习skills
- 基础技能学习（人类视角）
-
- 方法论PQRST学习法：预览→提问→阅读→总结→测试，适用于考试复习311。
- 费曼技巧：通过讲解知识给他人来强化自身理解3。
- 实践建议设定明确目标（如"一周掌握Python基础语法"）。
- 结合多样化学习方式（课程+实操+反馈）311。
- AI skills开发（技术视角）
-
- 入门路径方式1：用自然语言让AI生成技能包（适合新手）。
- 方式2：手动编写SKILL.md文件，封装任务流程（适合开发者）10。
- 关键原则单一职责：每个技能专注解决一个具体问题。
- 渐进式加载：基础内容放SKILL.md，复杂资源按需调用45。
三、学习资源推荐
- 官方指南：Claude Skills仓库（GitHub）、平台文档（如扣子、Coze）。
- 社区实践：CSDN博客的万字教程、B站实操视频。
- 工具支持：2026年主流平台（Claude Code、Antigravity）均提供skills集成。
=======
Skills 和传统 Prompt 最大的区别是：按需加载 + 渐进式披露（只在需要时才把厚厚的 SOP 塞进上下文，极大节省 token）。
目前能用 Skills 的主流客户端：
Skill 的核心结构
一个 Skill 本质上就是一个 Markdown 文件（文件名固定为 SKILL.md），内容几乎只由下面三段组成：
my-skill/
└── SKILL.md （唯一必需）SKILL.md 基本模板:
---
name: your-skill-name
description: What it does and when Claude should use it
---
# Skill Title
## Instructions
Clear, concrete, actionable rules.
## Examples
- Example usage 1
- Example usage 2
## Guidelines
- Guideline 1
- Guideline 2
SKILL.md 完整格式：
--- # YAML frontmatter 开始（顶格）
name: code-comment-expert # 必填：技能名（也是 /slash 命令名）
description: >- # 必填：最关键一行！Claude 靠它判断是否加载
为代码添加专业、清晰的中英双语注释。
适合缺少文档、可读性差、需要分享审查的代码。
常见触发场景：加注释、注释一下、加文档、explain this、improve readability
trigger_keywords: # 强烈推荐（大幅提升自动触发率）
- 加注释
- 注释
- 加文档
- explain code
- document
- comment this
- readability
version: 1.0 # 可选
author: yourname # 可选
--- # ← YAML 结束
# 这里开始是正文（Markdown）—— Claude 真正执行时的指令
你现在是「专业代码注释专家」。
## 核心原则
- 只在缺少注释或可读性明显不足处添加
- 优先使用英文 JSDoc / TSDoc 风格
- 复杂逻辑 / 非明显意图处额外加一行中文解释
- 注释精炼，每行不超过 80 字符
- 绝不修改原有逻辑
## 输出格式（严格遵守）
1. 先输出完整修改后的代码块（用 ```语言 包裹）
2. 再用 diff 形式展示只改动注释的部分
3. 最后说明加了哪些注释、理由
现在直接开始处理用户提供的代码，不要闲聊。进阶文件结构（技能变复杂时推荐）
当技能超过 500--800 行，或需要模板/脚本/参考资料时，推荐以下组织方式：
~/.claude/skills/react-component-review/
├── SKILL.md # 核心指令 + 元数据（建议控制在 400 行内）
│
├── templates/ # 常用模板（Claude 按需读取）
│ ├── functional.tsx.md
│ └── class-component.md
│
├── examples/ # 优秀/反例（给 Claude 看标准）
│ ├── good.md
│ └── anti-pattern.md
│
├── references/ # 规范、规则、禁用词表
│ ├── hooks-rules.md
│ └── naming-convention.md
│
└── scripts/ # 可执行脚本（需开启 code execution）
├── validate-props.py
└── check-cycle-deps.sh在 SKILL.md 中引用方式示例：
Markdown需要给出标准函数组件时，参考 templates/functional.tsx.md 的结构。
如果违反 Hooks 规则，对照 references/hooks-rules.md 第 3–5 条说明。
如需校验 propTypes，可执行 scripts/validate-props.py "{代码片段}"。第一个 Skill
让我们暂时忘掉复杂的创建过程，先从 使用一个现成的 Skill 开始，感受它带来的便利。
创建 Skill 目录
Skills 存放在 ~/.claude/skills/ （个人全局）或项目目录下的 .claude/skills/（项目专用）。
本章节再项目目录下测试，先创建个目录 claude-test:
mkdir claude-test进入该目录，创建 skills 的目录与文件：
mkdir -p .claude/skills/python-naming-standard编写配置文件 SKILL.md
在目录下创建 SKILL.md，这是 Skill 的大脑 ，告诉 Claude 什么时候用它。
---
name: Python 内部命名规范技能
description: 当用户要求重构、审查或编写 Python 代码时，请参考此规范。
---
## 指令
1. 所有的内部辅助函数必须以 `_internal_` 前缀命名。
2. 如果发现不符合此规则的代码，请自动提出修改建议。
3. 在执行 `claude commit` 前，必须检查此规范。
## 参考示例
- 正确：`def _internal_calculate_risk():`
- 错误：`def _calculate_risk():`字段要求：
- name：必须仅使用小写字母、数字和连字符（最多 64 个字符）
- description：Skill 的简要描述及其使用时机（最多 1024 个字符）
你的项目现在看起来应该是这样的：
my-project/
├─ src/
│ └─ test.py # 项目源码
├─ .claude/
│ ├─ skills/
│ │ └─ hello-world/
│ │ ├─ skill.md # Skill 定义（YAML + Instructions，机器可执行）
│ │ └─ README.md # Skill 说明（人类阅读，可选）
│ └─ config.yml # Claude 项目级配置（可选）
├─ .gitignore
└─ README.md # 项目整体说明接下来我们再终端执行以下命令启动 Claude Code：
claude输入任务：
帮我写一个计算用户折扣的函数Claude 就会会扫描已安装的 Skills，发现你的请求涉及 "Python 代码编写"，匹配了 python-naming-standard。
它会根据 SKILL.md 中的要求，生成如下代码：
def _internal_get_discount(user_score):
# 计算逻辑...
return discount添加资源文件（可选）
另外我们可以在 .claude/skills/ 下添加以下目录：
在同一文件夹添加：
- examples/：存放示例文件。
- references/：存放参考文档。
- scripts/：存放可执行脚本（例如 Python 处理 PDF）。
然后在 SKILL.md 中引用：
查看示例 commit：./examples/good-commit.txt
运行脚本：使用工具执行 ./scripts/process.pyAgent Skills 相关资源整理
Skill 聚合入口https://skills.sh/
Skills 市场（中文界面）https://skillsmp.com/zh
Agent Skills 官方标准站点https://agentskills.ioAnthropic
官方工程文章（Agent Skills 实战理念）https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
VS Code Copilot Agent Skills 文档https://code.visualstudio.com/docs/copilot/customization/agent-skills
Anthropic 官方 Skills GitHub 仓库https://github.com/anthropics/skills
Claude 技能精选列表（Awesome 系列）https://github.com/ComposioHQ/awesome-claude-skills
软件开发自动化工作流 Skills 集合https://github.com/obra/superpowers
自动生成 Skill 的 Skill（官方示例）https://github.com/anthropics/skills/tree/main/skills/skill-creator