用途:Skill Creator+ 帮助创建或审查可复用的技能(SKILL.md),将一段可重复的多步骤工作流打包,并在动手前判断该需求是否应该做成技能,而不是提示词、指令、自定义智能体或钩子。
主要能力:提供决策流程,区分适用形态——可复用多步骤工作流并带脚本、参考或模板时用技能;单一聚焦的带参斜杠任务用提示词(仅本地 harness,Agent Host 已弃用);常驻或按文件范围的指导用指令;角色、工具限制、委派或交接用自定义智能体;确定性强制或生命周期自动化用钩子。若非技能,则停止并改做正确的原语。支持从零创建技能、从对话/事故/清单中提取重复工作流、更新或重构已有技能、审查已有 SKILL.md、以及先判定再编写。
使用方式:先提取要打包的工作流,只澄清缺失维度(目标结果、个人与工作区范围、清单与完整工作流),起草最小可用的 SKILL.md,再把细节移入 references。创建或修改前先对目标分类:自编、第三方或衍生。新建自编技能可提议 CC BY-NC-SA 4.0 作为候选,展示确切的署名方式并确认;不要静默把本技能的 Apache-2.0 许可复制到目标;更新或导入时保留既有或上游许可。涉及许可与验证门:始终需要基线审查,Python 辅助与打包为条件性。
限制与注意:init_skill.py 的 --path 取已存在的父目录,目标为 <path>/<skill_name>,传入技能目录本身会嵌套重复;会生成 SKILL.md、LICENSE.txt、skill-license.json 三个产物;quick_validate.py 精确比对 LICENSE.txt 与渲染模板,并要求 metadata.author 与 authorAttribution.value 逐字符相等,不要手改 LICENSE.txt,用工具重新生成并覆盖;通过门只证明一致性而非正确性,脚手架后应读一次渲染后的 LICENSE.txt。分类取决于来源是否独立编写,而非复制行为本身。无 skill-license.json 的技能按旧版处理并跳过内容比对。导入到其他仓库时需用该仓库工具链重新生成 LICENSE.txt 与 skill-license.json。上传到 Microsoft 365 Agent Builder(Preview,仅 Frontier)前需对照文档限制:每个代理 8 个技能、zip 50 MB、SKILL.md 少于 20,000 字符、目录深度 3、350 个文件、脚本仅 .py .js .mjs .cjs .ts .mts .sh .bash(无 .ps1),沙箱内无网络或安装;package_skill.py 将文件嵌套在 <skill_name>/ 下,而文档示例中 SKILL.md 位于 zip 根,两种布局的导入均未测试,不要承诺可行。
核心原则:简洁优先(上下文窗口共享,只加 Claude 不知道的内容);发现优先(描述即路由面,触发词须明确);自由度匹配任务脆弱度;渐进式披露(元数据→正文→参考三级);先集成再新增;选对原语;先定范围再建文件;自包含(技能须自带知识,打包进 references/scripts,不要把工作区文件仅作链接,环境相关值抽象为 args/config)。
结构:路由与决策留在 SKILL.md,确定性辅助放 scripts/,按需细节放 references/,可复用输出放 assets/。门控不可逆操作的约束(允许清单、禁用值、安全限制)即使像细节也应内联在 SKILL.md,仅理由放 references。
创建流程:选择原语与范围,提取可复用工作流,规划资源,实现,验证,用真实触发提示测试。重构顺序:删除过时或低价值指导,合并重复规则,长细节移入 references/,最后才补真正缺失的指导。
Frontmatter 与触发:使用最小可用 frontmatter,name、description 及仅改变行为的可选字段;name 须与文件夹一致,description 须含触发条件。SKILL.md 宜少于 150 行,超 300 行须拆分到 references。When to Use 从用户短语开始,只保留必要工作流,长示例/模式/配方移入 references。
迭代循环:起草并保存,找出最弱或最含糊部分,收紧后总结产出与可试提示。完成标准包括:确认需求是技能而非其他原语;创建文件前已定范围;SKILL.md 建立且少于 150 行;frontmatter 含 name 与带触发条件的 description;手动使用的技能有 argument-hint;有意设置 user-invocable;仅当可选字段改变行为时才添加;细节移入 references/;自包含,无对其他技能/工作区文件的硬引用,环境相关值已抽象;通过审查清单。