skill-generalizer

技能通用化

概述

将可正常使用的本地技能转换为整洁的公开成果。目标是在保留可复用技术的同时，去除私人上下文、个人假设和特定机器的设置。

适用场景

• 用户想要发布、分享、推广、开源或打包本地技能。
• 技能源于个人工作流、私有仓库、本地路径、对话记录、远程主机或团队惯例。
• 输出需要对陌生用户也有用，同时避免泄露作者的环境信息。

不要将其用于仅针对用户自己的机器调整技能；此类情况请使用 skill-personalizer。

工作流

1. 在评估之前，检查实际的源技能和附近的仓库文件。
2. 如果不确定源技能的质量，先运行 skill-personalizer 中的审查检查。
3. 将可复用能力与个人实现细节区分开。
4. 删除或替换私人名称、路径、主机、凭据、账户 ID、对话记录和一次性项目事实。
5. 围绕通用触发条件、可移植的工作流和有限的假设重写技能。
6. 保持 SKILL.md 简洁；将较长的评估标准、示例或脚本移至附带资源中。
7. 在编写安装说明或支持声明之前，检查目标 Agent 的兼容性。
8. 仅在用户提出要求时，准备适合发布的打包内容和真实准确的推广文案。
9. 验证 frontmatter、文件布局、安装路径，以及至少一个真实的使用提示词。

公开发布规则

• Frontmatter 中的 description 应说明何时使用该技能，而不是概述其工作流。
• 公开示例必须通用，或明确标注为已脱敏。
• README 或市场文案中的声明必须与实际存在的文件一致。
• 优先使用可移植的命令和路径占位符，而非作者的主目录或私人别名。
• 如果某项个人信息不可或缺，应将其设为可配置变量，并提供设置说明。

参考资料

进行完整发布审查、脱敏检查、README 重写或推广打包时，请阅读 publication-rubric.md。

在声明支持 Codex、Claude Code、Cursor、OpenCode、Gemini CLI 或其他编码 Agent 之前，请阅读 platform-compatibility.md。