把“怎样做好”从人的记忆移入可执行资产
说明、知识、示例、脚本、模板与工具用法被放进一个可发现的目录。
Skill 是 Agent 可发现的程序性知识
它把完成一类任务的方法封装为可复用能力包。扩展发生在上下文加载、任务路由和工具编排层，不等于修改模型权重。
Tool 给手，Skill 给方法
函数能执行动作；Skill 决定何时调用、按什么顺序、怎样处理失败以及如何验证结果。
从临时提示到版本化知识
方法可以被自动匹配、按需加载、多 Skill 组合、测试、审计和迁移。
结构与运行
四个视角解释一个 Skill 如何存在、如何被系统使用。
Prompt本次怎么回答
一次交互的语言约束。
Tool / MCP连接与动作
让 Agent 访问数据和外部系统。
Skill完成任务的方法
触发、步骤、资源、异常与质量标准。
Workflow确定性控制
固定节点、分支与数据流。
Agent选择与行动主体
根据目标组合 Skill、Tool 与 Workflow。
storyboard-optimizer/
├── SKILL.md
├── references/
│ ├── shot-types.md
│ └── output-schema.md
├── scripts/
│ └── validate_storyboard.py
└── assets/
└── storyboard-template.json
只有 SKILL.md 必需
元数据负责被发现和触发；正文保存完整方法；references 提供按需知识；scripts 承担确定性操作；assets 保存模板与素材。
内容不必一次全部进入上下文。渐进式加载让大规模 Skill 集仍然可用。
系统先暴露极少元数据。
描述本身就是一个小型路由器。
按需调用脚本、Tool、MCP 或其他 Skill。
执行—验证—修复—再验证。
发现经验元数据越少，描述越重要
启动阶段通常只有名称、描述与路径。描述不是宣传语，而是决定路由的压缩接口。
激活经验正向场景和负向边界同时写
“帮助处理视频”会过度触发；对象、输入、典型表达和不应触发的情况必须具体。
执行经验上下文只加载当下需要的内容
主方法在 SKILL.md，专业细节进入 references，确定性步骤进入 scripts，避免所有资料同时占满上下文。
验证经验可由程序判断的，不交给语言感觉
JSON、编号、总时长、文件存在与字段比较由脚本验证；模型负责解释、选择和修复策略。
指令型
规范、示例、表达方法
知识型
术语、制度、品牌资料
脚本型
转换、校验、批处理
工具型
API、Tool 与 MCP
工作流型
步骤、分支与质量门
Skill 描述的是能力如何被封装，不限定底层技术。一次“色彩迁移”可以是说明、脚本、图像 API，也可以是一段 ComfyUI 子图。
链式组合的方法论
Skill 的输出不是“给人看完就结束”，而是下一项能力能够可靠消费的中间状态。
字段、类型、必填项、枚举值
剧情提炼输出人物、地点、事件与视觉意象；下游优先读取这些结构，而不是重新理解整篇原文。
明确什么可以改、什么不能改
画风转译可以改变色彩、材质与光照，但不能改变人物数量、剧情因果、道具归属和事件顺序。
成功不是唯一返回状态
完整成功、部分成功、需要补充、可自动恢复与不可恢复错误必须被下游区分。
每一步都验证，不把问题拖到最后
上游丢失人物或改变剧情时立即停止；末端统一修复往往已经无法判断错误来源。
是否需要当前任务究竟需要哪些 Skill
运行顺序依赖关系决定谁先谁后
冲突处理相似描述、修改权限和输出字段是否冲突
原子与复合
组合不是把所有 Skill 都调用，而是让职责清楚的能力通过稳定接口协作。
单一职责，输出稳定
例如提取人物、验证 JSON、检查画面比例。它容易单独测试，也容易被其他 Skill 调用。
＋
字段、语义、状态、质量
上游输出成为下游输入；每一步知道能改什么、不能改什么，以及失败如何表达。
＝
可调度的完整任务
价值不只是功能更多，而是顺序、边界、异常与质量标准被一起封装。