构建生产级Skill架构，说实话，不是一件容易的事，哈哈，但咱就是说掌握了核心三要素和三层渐进式加载架构，你就成功了一大半。

结构上使用「核心三要素」——Schema/Metadata 定义身份，Instructions/SOP 定义流程，Executable/Scripts/Tools 定义执行Neng力。

为啥要这么设计呢？你想啊，一个 Skill Ru果连自己是干啥的dou说不清楚，那还怎么被 Agent 调用？

article-illustrator/├── SKILL.md # 主文件，包含元数据和指令├── references/ # 参考资料│ ├── style-guide.md # 风格指南│ └── examples/ # 示例├── scripts/ # 脚本│ ├── analyze.py # 文章分析脚本│ └── generate_image.py # 图片生成脚本└── README.md # 说明文档

何时拆分成脚本当逻辑复杂、需要重复执行、涉及外部 API 调用时

何时使用引用文件当内容过多、需要分类管理、只在特定场景使用时

如何设计接口保持参数简洁，使用默认值，提供清晰的错误处理

如何管理版本使用语义化版本号，记录变geng日志，考虑向后兼容

核心思想用Zui少的 Token ZuoZui多的事，避免不必要的信息加载。

通俗类比就像给文件命名，"---项目方案.md" 比 "新建文档1.md" geng容易理解和查找。

决策路径嗯，你得想清楚哪些信息是必须的，哪些Ke以省去。

说到这儿，我突然想到，为什么百度不收录我的文章呢？有人说是内容不够原创，有人说是结构不佳，你懂的，其实吧，这事儿挺复杂的，没个准儿。

反面例子只说明"要Zuo什么"，不说明"不NengZuo什么"或"遇到问题怎么办"，导致模型在边界情况下不知所措。

实践建议写 Skill 的时候，多从用户的角度想想，他们需要什么不需要什么。

---name: simple-illustratordescription: 为文章生成配图---## 操作流程. 分析文章内容，识别重要段落. 为每个重要段落生成配图描述. 调用图片生成工具. 返回图片链接## 要求- 风格统一- 与内容相关- 避免敏感内容

内容包含元数据、核心指令、基本流程，让 Agent 知道「这个 Skill 怎么用」。

加载时机当 Agent 认为需要使用该 Skill 时才加载对应 Skill 的 SKILL.md 文件。

内容包含详细逻辑、代码、模板、示例等，让 Agent Neng「真正把事情Zuo好」。

hen多人一开始dou是从写 Prompt 开始的，然后逐步升级到完整的 Skill。这个过程需要经历三个阶段： 不对不对，应该是先有一个简单的 Prompt，然后不断迭代，直到形成一个完整的 Skill。 一个高质量的 Skill 不是一蹴而就的，而是需要不断迭代和优化的。但只要掌握了「核心三要素」和「三层渐进式加载架构」的设计理念，你就Neng构建出真正生产可用的 Skills，让 Agent 成为你的得力助手。 : 技术实现:在skills目录下创建index.json文件,包含所有 Skill 的元数据. Agent 通过这些信息判断「是否应该调用这个 Skill」以及「如何调用」。害，这一步hen关键。 总之呢，构建生产级Skill架构，需要从结构和加载机制两个维度入手，既要考虑功Neng性，又要考虑效率和可维护性。你说呢？