核心用法
skill-compiler 是一个面向 ClawHub 生态的编译型工具链，核心任务是将声明式的 SKILL.md 文档转换为运行时优化的机器友好格式。主要工作流分为三步：
1. 环境检测：check-env 脚本验证本地依赖（bash、mdquery、jq、toon）是否完备。
2. 单文件/批量编译：compile-skill 针对单个 Markdown 文件生成 SKILL.struct.json（规范化运行时结构）与 SKILL.toon（Token 精简投影）；compile-all 则递归扫描目录批量处理。
3. 发布就绪：编译后的技能文件夹包含 SKILL.md、skill.yaml 及脚本目录，可直接通过 clawhub publish 推送至注册中心。
显著优点
- 性能优先：Toon 格式专为 Token 效率设计，降低运行时解析开销。
- 标准化输出：JSON Schema 严格的 struct.json 确保跨 Skill 一致性，便于后续工具链消费。
- 批量友好：支持递归批量编译，适合大型技能仓库的 CI/CD 集成。
- 零网络依赖：纯本地工具链，无需外部 API 或密钥，部署门槛低。
- 回滚明确：文档中明确记录回滚策略（删除目录 + revert commit），运维可预测。
潜在缺点与局限性
- Shell 限定：仅支持 bash，Windows 用户需 WSL 或额外适配。
- 架构覆盖：虽支持 x64 与 arm64，但缺少对嵌入式或 WASM 等新兴运行时的说明。
- 生态耦合：Toon 格式与 ClawHub 深度绑定，脱离该生态后价值下降。
- 无安全扫描：报告中明确提示"未执行安全扫描"，生产环境需自行补全审计。
- 版本管理弱：示例版本号为硬编码 0.1.0，缺乏语义化版本自动化工具。
适合人群
- 构建个人或团队 Skill 仓库的开发者
- 追求低延迟、高吞吐 Skill 加载的性能敏感场景
- 希望将 Markdown 文档与可执行产物分离的文档驱动工作流拥护者
- 熟悉 bash 生态的 DevOps/SRE 工程师
常规风险
- 供应链风险：依赖 mdquery、toon 等外部二进制，若上游未签名需验证哈希。
- 编译漂移：SKILL.md 与生成产物不同步可能导致运行时行为不一致，需纳入版本控制钩子。
- 权限风险：脚本执行需适当文件系统权限，多用户环境应限制写权限。
- 回滚窗口：删除目录操作不可逆，建议配合 Git 标签与备份策略。