Skill进阶学习

斯joy杰
0 阅读3分钟

1.1. Skill定义与结构

Skill是可复用能力集合，非单纯提示词文件，而是工程化能力包

AI Coding会自动加载SKILL.md的metadata数据，类似于索引

1.1.1. Skill 目录结构

skill-name/
├── SKILL.md              # 必需：技能定义文件
├── agents/               # 可选：UI 元数据目录
│   └── openai.yaml       # UI 显示配置
├── scripts/              # 可选：存放可执行脚本
├── references/           # 可选：存放参考文档
└── assets/templates      # 可选：输出使用的资源文件，比如约束输出格式等

1.1.2. SKILL.md 文件格式

---
name: skill-name
description: 技能描述，包含触发条件和使用场景
---

# 技能名称

## 使用指令

详细说明...

1.2. 运行机制优化

从skill的目录结构出发，有逐渐披露机制和认知空间执行空间机制

1.2.1. 逐渐披露机制

  • meta data先行加载作索引
  • body仅在触发时加载
  • 脚本等文件仅执行时调用

任务启动只会加载元信息部分，正文暂时不会加载。当大模型识别到要使用该skill，才会加载skill.md的body部分。只有在涉及到脚本内容的时候才会去加载script等等，为了节省上下文

LevelFileContext Window#TokensPurpose
1SKILL.md Metadata (YAML)Always loaded~100Tells AI what the skill does / when to trigger
2SKILL.md Body (Markdown)Loaded when Skill triggers<5KSOP instructions loaded when the skill fires
3+Bundled files (docs, scripts, data)Loaded as neededunlimited*forms.md, scripts, configs: loaded on demand

1.2.2. 认知空间与执行空间分离

  • 认知空间：system prompt与skill元信息
  • 执行空间：独立运行脚本与资产
  • 结果仅返回关键信息，不污染主上下文

大模型的主线程只关注认知空间的最终结果，执行空间是主线程中的每一步单起的子线程

只保证主工作流的干净

image.png

1.3. 设计模式

模式操作目的
工具外置 (Tool Wrapper)1. 将非核心逻辑（如登录操作）封装为外部脚本
2. 保持skill.md轻量化，减少上下文占用		遵循工具外置原则，提升可维护性
生成器模式 (Generator)1. 使用template对输出结构进行强约束
2. 防止大模型生成不稳定或不符合规范的格式		通过模板强控确保输出一致性与规范性
审查者模式 (Reviewer)1. 在关键步骤设置review标准
2. 自动检验当前操作是否符合预设目标		自动审查显著提升流程正确率
反转模式 (Inversion)1. 先由大模型主动提问澄清需求细节
2. 在充分理解后才执行，适用于复杂场景 brainstorming		先问后做提升复杂任务的理解准确性
流水线模式 (Pipeline)1. 明确拆解操作步骤并串行执行
2. 防止跳步行为，确保流程可控性与可预测性		串行流水线是保障流程稳定的核心

image.png

1.4. 优质Skil验证标准

1.4.1. 触发准确性（识别）

  • 大模型能否在合适场景下正确识别并调用
  • 依赖description中明确的使用情境描述

精准触发依赖场景描述的清晰度

1.4.2. 输出质量（结果）

  • 输出内容是否准确、完整、符合业务规范
  • 是衡量Skill核心价值的关键指标

输出质量是Skill存在的根本价值

1.4.3. Token效率（性能）

  • 优秀Skill应最小化上下文占用
  • 通过渐进加载与空间隔离实现高效利用

Token效率是规模化应用的关键瓶颈

1.4.4. 组合度（复用）

  • Skill应具备原子化特征
  • 能被其他Skil复用（如读取文件功能），支持模块化集成

原子化是构建生态协同的基础

1.4.5. 鲁棒性（稳定）

  • 包含边界条件处理、异常捕获机制
  • 确保在非理想输入下仍能稳定运行

鲁棒性决定Skill在真实环境中的可用性

2. 去哪里找到想要的skill

外部开源补充：

参考文档

avatar
文章
阅读
粉丝