技能介绍

问题场景：SkillHub 发布流程中的重复性操作与潜在错误

在将自定义 Skill 发布到 SkillHub 平台时，开发者常面临多个容易被忽略的环节：CLI 工具是否已正确安装、登录状态是否有效、SKILL.md 的必填字段是否完整、slug 命名是否符合规范且发布后无法修改、是否应该先执行 dry-run 预检避免直接发布出错，以及 Windows 环境下的编码问题导致命令执行失败。这些步骤若依赖人工检查，容易因遗漏或误操作导致发布流程中断，甚至需要重新走完整流程。

核心能力与工作流程

该技能通过分阶段自动化处理，覆盖从环境准备到发布后状态查询的全流程：

环境检查阶段：自动检测 skillhub 命令是否可用，若未安装则引导使用官方脚本安装；验证登录状态，未登录时引导用户通过 API key 完成认证；针对 Windows 用户，处理 UnicodeEncodeError 编码问题，通过调整 PYTHONIOENCODING 或创建 python3 包装脚本确保命令正常执行。
文件检查阶段：验证目标目录是否存在且包含 SKILL.md，检查必填字段（如 slug、displayName、version 等）是否完整；若 slug 为空，根据用户输入的团队前缀生成 2-3 个符合规范的命名建议供选择，并明确提醒 slug 发布后不可修改，需用户亲自确认。
预检与发布阶段：先执行 --dry-run 本地预检，确认格式无误后再通过 --changelog 参数完成正式发布，并返回 skillId 与审核状态。
发布后处理：告知用户 skillId 和审核状态，明确审核周期（3-7 个工作日），并提供查询发布进度的路径。

适用边界与关键约束

该技能严格遵循以下约束以确保发布过程的安全性与可控性：

用户决策优先：slug 的命名与确认必须由用户亲自完成，技能仅提供建议，不主动替用户决定。
预检强制：发布前必须执行 --dry-run，通过预检后再正式发布，避免直接发布导致格式错误。
字段最小修改：除 slug 字段外，不修改用户 SKILL.md 中的其他任何字段，保证文件内容的完整性。
敏感信息保护：API Token 作为敏感信息，不会在日志或输出中完整打印，防止泄露。
版本兼容性：若检测到 CLI 版本过旧（如 npm 版 @skill-hub/cli），提醒用户先卸载旧版本再安装正确版本，避免因版本差异导致的兼容性问题。