跳转至

创建 SKILL 规范

1. 文档结构

skill-name/
├── SKILL.md                    # 【唯一必填】技能入口：YAML元数据+核心导航+核心规则
├── references/                 # 【可选】详细参考文档，按需加载
├── assets/                     # 【可选】静态资源：模板、规范、变体方案、图片、pdf、docx
└── examples/                   # 【可选】示例输出，保证输出稳定性
└── scripts/                    # 【可选】可执行脚本，可直接调用运行

2. SKILL.md 规范

2.1 YAML 元数据

  • 必须包含顶部的 YAML 元数据（name、description）
  • name ：必选字段，字段必须和根目录名完全一致；最多 64 个字符；不能包含 XML 标签。
  • description：必选字段，不能为空；必须包含：技能功能+使用时机+触发词最多 1024 个字符；不能包含 XML 标签。
  • triggers: 必选字段，触发条件，语义近似匹配，不多于10个，比如["红烧鱼做法", "红烧鱼教程"]。
  • allowed-tools：可选字段，限制可使用的工具，避免无关操作，比如["Read", "Write", "Grep"]。
  • dependencies：依赖的其他技能或外部工具（如["python>=3.8", "jq"]）

2.2 正文规范

  • 正文模块：1. 角色与目标（必要）、2. 核心执行逻辑（必要）、3. 输入输出（必要）、4. 标准化制作 SOP（必要）、5. 资源与参考文件（非必要）、6. 异常处理速查（非必要）
  • SKILL.md 正文必须控制在 500 行以内。若 SKILL.md 正文超过 500 行，需将非核心内容（如详细异常案例、商用扩展流程）拆分至 references/ 目录，并在 SKILL.md 中明确跳转链接（如「商用大锅版流程详见 references/commercial-batch.md」）

2.3 SKILL.md 样例

---
name: braised-fish-cooking-skill
description: 生成红烧鱼的标准化烹饪方案。支持家常与商用场景，涵盖鱼种适配、精准量化配料、SOP流程、关键控制点及异常处理。
triggers: ["红烧鱼做法", "红烧鱼教程"]
allowed-tools: ["Read", "Write", "Grep"]
---

# 红烧鱼标准化烹饪技能

## 1. 角色与目标
你是一名专业的中餐烹饪顾问，遵循“型完整、肉不碎、无腥味、酱香浓郁、肉质鲜嫩”的出品标准。你的核心任务是根据用户输入的参数，生成一份**可直接落地执行**的烹饪方案。

## 2. 核心执行逻辑
1.  **禁止模糊表达**：所有输出的食材用量必须基于用户提供的重量，按照下方的公式计算得出数值（单位：克/毫升），严禁使用“少许”、“适量”。
2.  **分步控制**：输出步骤必须区分“预处理”、“烹饪中”、“收汁起锅”三个阶段，并在关键风险点（KCP）标注注意事项。

## 3. 输入输出

### 3.1 输入参数
- **鱼种**（string，必需）：如鲈鱼、草鱼、鲫鱼
- **鱼重量**（number，必需）：单位克（g），如 500

若用户未提供完整参数，技能应主动引导补充。

### 3.2 输出结构
技能输出为 Markdown，固定包含以下章节：
1. **食材清单**（基于重量精确计算）
2. **预处理 SOP**（含关键控制点）
3. **烹饪 SOP**（热锅凉油法）

## 4. 标准化制作 SOP
请严格按此结构输出方案：

### 4.1 预处理关键控制点
1.  **清洗**：去除鱼鳞、鱼鳃、腹腔黑膜（腥味主要来源），洗净血水。
2.  **改刀**：在鱼身两面每隔 2-3 厘米划一字刀，深至鱼骨（便于入味与熟透）。
3.  **吸水**：**关键步骤**。用厨房纸彻底吸干鱼身表面及腹腔内水分。若有残留水分，煎鱼必破皮。
4.  **腌制**：将计算好的腌制盐均匀涂抹鱼身内外，塞入姜片，静置 10-15 分钟。煎制前需再次吸干表面渗出水分。

### 4.2 烹饪流程（热锅凉油法）
1.  **润锅**：大火烧热锅至冒烟，倒入底油，晃动锅体使油浸润内壁，倒出热油。
2.  **煎鱼**：重新加入计算好的食用油，中火烧至油温 6 成热（约 180℃）。放入鱼，**入锅后切勿翻动**，单面煎 2-3 分钟至金黄定型后翻面。
3.  **爆香**：鱼推至一侧，放入葱段、姜片、蒜瓣、八角（或干辣椒）爆香。
4.  **调味**：沿锅边烹入料酒，加入生抽、老抽、蚝油、糖（按口味）。
5.  **炖煮**：加入计算好的清水，大火烧开后转中小火，炖煮 `W * 3` 分钟。期间可用勺子将汤汁不断淋在鱼身表面，确保上半部分入味。
6.  **收汁**：开大火收浓汤汁，可加入少许水淀粉勾薄芡（可选），待汤汁浓稠明亮时关火。

### 4.3 装盘与出品标准
- **装盘**：盛出时使用两把铲子托住鱼腹和鱼头，避免断裂。将汤汁均匀浇在鱼身上。
- **验收标准**：
    - 外观：鱼皮完整，无大面积破损，色泽红亮。
    - 质地：鱼肉用筷子轻拨即开，不散碎。
    - 风味：无腥味，酱汁挂壁均匀。

## 5. 资源与参考文件
当需要更深度的专业知识时，读取以下文件辅助回答：
- **食材替代方案**：若用户鱼种特殊（如冷冻鱼），读取 `references/fish-variants.md` 调整预处理方式（如是否需要拍粉）。
- **商用大锅版**：若用户指定“商用”或“大份量”（单条鱼 > 3斤），读取 `references/commercial-batch.md` 调整煎炸手法与摆盘逻辑。
- **问题速查**：若用户遇到特定问题，读取 `references/troubleshooting.md` 定位根因。

## 6. 异常处理速查
若用户反馈烹饪失败，请根据关键词匹配以下解决方案：
- **鱼皮粘锅/破皮**：确认是否严格执行“擦干水分”与“热锅凉油”。补救：若已破碎，后续可考虑红烧时多留汤汁，掩盖破损，并建议下次使用不粘锅或拍薄粉。
- **鱼肉发柴**：原因是火候过大或炖煮时间过长。补救：建议起锅后淋入明油，增加油润感。

3. 目录规范

references/ 目录

  • 用途：存放详细的参考文档、规范细则、SOP 流程，仅在需要时按需加载，不占用常驻上下文
  • 规范：单个文件控制在 150-300 行，按功能模块拆分，必须在SKILL.md的资源导航中明确说明文件用途与加载时机
  • 示例：references/cooking-execution-sop.md 对应之前红烧鱼案例的核心烹饪 SOP，完整量化步骤与关键控制点

assets/ 目录

  • 用途：存放静态资源，包括模板、出品规范、品牌标准、变体方案、图片等，是技能执行中可复用的固定素材
  • 规范：按类型拆分文件，在SKILL.md中明确引用场景，禁止存放大体积文件

examples/ 目录

  • 用途：存放标准输出示例、成功案例、模板化输出结果，帮助稳定输出符合预期的格式与内容，大幅降低幻觉
  • 规范：示例必须完整、可复现，和技能核心能力完全匹配，在SKILL.md中明确引用场景

scripts/ 目录

  • 用途：存放 Python/Shell/JavaScript 等可执行脚本，可直接调用运行，完成确定性的计算、校验、自动化操作
  • 规范：脚本必须有明确的输入输出，在SKILL.md中明确调用时机与使用方法，禁止存放无注释的复杂代码