55+ 个 Agent Skills 核心知识点

吃透 Agent Skills
这一个开放标准
从 SKILL.md 到渐进式披露

基于 agentskills.io 官方规范整理的中文学习工坊 —— 一步步搞懂结构化文件夹、YAML 前置字段、三层渐进披露、触发优化、输出评估和客户端接入

当前概念
Agent Skill(智能体技能)
给 LLM 的一组有组织的提示词和指令,用来完成特定任务
基础概念
55+
核心知识点
11
关键主题
30分钟
核心框架速览

九大核心主题

从标准规范到客户端实现,完整覆盖 agentskills.io 官方文档

🎯
基础概念
Agent Skill 是什么、为什么需要、SKILL.md 文件结构与 agentskills.io 开放标准
📐
规范与 YAML 前置字段
name / description / license / compatibility / metadata / allowed-tools 六大字段
🪜
三层渐进式披露
Discovery → Activation → Execution 的 token 经济学,500 行/5000 token 建议上限
🚀
Quickstart 实战
.agents/skills/ 约定路径、roll-dice 入门示例、VS Code / Claude Code 验证
🧠
最佳实践
从真实任务提炼、Gotchas 段落、模板与校验循环、Plan-Validate-Execute 模式
🔍
优化 description
Trigger eval 查询、近似陷阱、Train/Validation 切分、避免过拟合的优化循环
📊
评估输出质量
with_skill vs without_skill、断言、LLM 评审、benchmark.json 与 delta 指标
🛠️
脚本集成
uvx / npx 一键命令、PEP 723 内联依赖、非交互式、结构化输出设计
🔌
客户端实现
Discovery 扫描策略、目录优先级、file-read vs 专用工具激活、Context 保护