技能工坊

要解决什么问题

在 CodeBuddy / WorkBuddy 里写 Skill 时，常见问题不是「缺一段说明」，而是：元数据写成了功能说明书导致 description 从不触发；SKILL.md 与 references/ 重复塞满上下文；脚本无后缀被 SkillHub 拒传；打包 zip 根目录错位；改完市场技能却被自动更新覆盖。技能工坊在开源 skill-creator（Apache-2.0）基础上做了增强，把「创建 → 测 → 包 → 发 → 改」串成可执行流程。

技能如何工作

结构与渐进披露：技能以 SKILL.md 为入口，可选 scripts/、references/、assets/、examples/。原则是元数据常驻、正文在触发时加载、大段资料按需读入——examples/ 专门放踩坑与失败模式这类模型搜不到的经验。

写作与路由：frontmatter 的 description 是意图路由，应写「用户想做什么时加载」，而不是罗列能力；并强调 agent_created: true 以便后续 skill_manage 维护。发布 SkillHub 时需补齐 slug、displayName、summary、license、version 等字段，并对照 references/publishing-checklist.md。

测试与发布：用 references/evals-template.json 建 evals.json，按 正确性 / 完整性 / 触发准确率 / 性能 四维打分；with-skill 较 baseline 领先约 1.0+ 再考虑发布。打包前自动校验 frontmatter、无后缀文件、垃圾目录与版本一致性；上传前必读 references/failures.md 做回归。

改已安装技能：先读现有目录再改；保存成功后向 _skillhub_meta.json 或 _knot_meta.json 写入 "userModified": true，避免市场更新静默覆盖。

适用边界

• 面向 创建、改进、评估 技能本身，不是替代具体业务域技能。
• 评估分数需结合真实 AI 输出人工填写，模板不会自动替你判分。
• SkillHub 规则（后缀名、zip 结构、frontmatter）以文档与校验脚本为准，环境差异仍需本地抽查包内容。