Skill 创建指南

为什么需要这个技能？

在构建通用Agent时，常见的问题是：当面对特定领域的复杂任务时，Agent往往缺乏专业知识和结构化流程，导致输出不可靠或需要大量手动调整。例如，让一个通用模型直接处理公司内部的API集成流程，可能会遗漏关键步骤或违反业务规范。Skill的设计目标就是解决这类问题——它通过模块化、自包含的能力扩展包，将领域知识封装成“入职指南”，让Agent快速获得专业能力。

技能如何工作？

讲解概念

本技能以“先类比、后结构、再流程”的顺序解释Skill的本质。例如，将Skill比作“工程师的入职培训手册”，帮助用户理解其价值：

• 模块化扩展：通过SKILL.md定义技能元数据和流程，避免污染主模型上下文。
• 渐进式加载：采用三级加载机制（元数据→正文→资源），按需注入知识，节省token消耗。
• 自包含设计：捆绑脚本、模板和参考文档，确保技能开箱即用。

指导创建

对于从零构建Skill的场景，技能提供了完整的六步工作流：

1. 初始化项目：调用skill-creator脚手架生成标准目录结构（用户级~/.workbuddy/skills/，项目级.workbuddy/skills/）。
2. 编写核心文件：SKILL.md需用祈使句描述流程，description字段需明确“做什么+何时触发”。
3. 捆绑资源：将模板、脚本放入assets/，复杂知识拆解到references/目录。
4. 校验与打包：运行package_skill.py自动检查frontmatter格式、命名规范，并生成可分发的zip包。
5. 迭代优化：在实际使用中持续更新，修复流程卡点或补充缺失资源。

适用边界与注意事项

• 知识封装范围：适合结构化流程、API操作、模板生成等“程序性知识”，不涉及模型训练或动态数据获取。
• 元数据设计：name和description需精准描述技能用途，避免模糊表述导致误触发。
• 资源组织：复杂技能应通过references/分层加载，避免单文件过长影响可维护性。
• 版本管理：建议通过git管理Skill仓库，方便回溯修改和团队协作。