WorkBuddy发布就绪审查

为什么本地好用的 Skill，一发布就翻车？

当你在本地跑通了一个 WorkBuddy 技能后，如果直接把这个目录打包发给陌生用户，大概率会遇到各种环境报错。原因很简单：你的包里可能还躺着本机绝对路径、依赖私有的 Obsidian 仓库数据，甚至因为 Python 加载而自动生成的 __pycache__ 缓存文件。如何把它快速整理成一份符合 skillhub 发布规范、真正自包含的干净技能包？

审查机制与工作流

这个技能不是通用的“质量打分器”，而是一个专注“发布就绪度”的检查工具。它会从 9 个核心维度对本地技能进行盘点，扫描是否存在资产引用缺失、硬编码路径（如 /Users/）或第三方品牌侵权。

工作流分为 7 个明确步骤：先是资产盘点，接着进行自包含性检查，然后扫描并清理私有耦合与缓存（特别提供了 PYTHONDONTWRITEBYTECODE 环境变量的根治方案），随后规范化 frontmatter。最后，你可以调用内置的审计脚本 audit_skill_publish.py，它会输出带修复建议的 P0/P1/P2 问题清单。技能还具备“经验回流”机制（通过 --learn 标志），能将本次审计发现的新模式沉淀到避坑手册中，形成自迭代闭环。

适用边界与注意点

本技能只关注“在我的机器上能跑”到“可以给别人用”这一发布环节，它不会对你的技能逻辑和代码质量本身进行优化或重构。

底层的审计器以 CLI 和静态扫描为主，它能精准报出缺失的资产等致命问题（P0），但针对路径或私有耦合是否需要保留，仍需结合人类判断来决定。发布者需明白，最终的发布包必须严格遵守 skillhub 的上传规则（仅接受纯文本文件）。