1.Skill编写简单教程

Skill本质：

skill是将上下文转化成了一个文档的形式，在使用时模型去自行抉择调用相应的skill，选择性的将内容塞入提示词，使用的是上下文工程的方式。

使用渐进式披露：

2. 自动生成Skills：

不需要自己写文档，使用提示词来生成完整的Skills：

提示词：

我要创建一个 [领域] Skill，帮我生成完整结构。

## 基本信息
- Skill 名称：[例如：api_doc-assistant]
- 领域：[例如：代码文档编写]
- 使用场景：[例如：检查接口代码结构与逻辑、编写文档]

## 文件位置
生成到：~/.claude/skills/[api_doc-assistant]/

## 核心功能
我需要这个 Skill 帮我：
1. [功能1 - 例如：检查指定接口代码的结构与逻辑]
2. [功能2 - 例如：找出代码中有问题的地方，并向用户指出，由用户确定是否需要修改]
3. [功能3 - 例如：发布前给用户确认接口文档的框架与核心重点]

## 架构要求
1. 生成完整的 YAML frontmatter（name + description）
2. 在 workflows/ 目录创建独立的检查文件
3. 每个 workflow 包含：
   - 具体检查项（checkbox 格式）
   - 重要程度标注（⭐数量）
4. 使用渐进式披露结构（SKILL.md 引用 workflows）

## 输出格式
请按照以下结构生成所有文件内容：

1. 先生成目录结构说明
2. 然后逐个文件输出完整内容
3. 最后提供安装和验证步骤

Skill建立好之后会存在：~/.claude/skills/你的skill名称/，可以去相关文件中查看撰写的文档是否符合要求，一般来说包含三个部分：

三个核心文件的作用：

1.about-me.md - 你的个人档案

• 领域定位、写作风格
• 成功案例、失败教训
• 让 AI 知道你是谁，检查内容是否符合你的方向

2.skill.md - 主索引文件

• 包含 name 和 description（L1 元数据）
• 引用各个 workflows 文件的路径（L2 指令）
• Claude 先读这个文件，再按需加载对应的 workflow

3.workflows/ - 具体的检查清单（L3 资源层）

• 每个文件对应一个检查维度（如选题、结构、标题等）
• 包含具体检查项、案例对照
• 按需加载，省 Token

验证是否可用：

直接询问：

我有哪些可用的 Skills？

直接测试：

帮我检查一下xx接口
# 如果是写作 Skill，Claude 应该会自动调用

3. 持续迭代Skill：

这是skill会越来越强的关键，每次进行调用后，用AI来更新workflows，再进行review，workflows会根据你调用的情况以及你反馈的情况来对skill进行迭代升级