（4142期）Skill Sync Publisher – 一键多平台技能发布管家

一键多平台技能发布管家 基于官方 CLI 的安全发布工作流，支持 8 大主流技能市场同步验证、预检与发布，确保 GitHub 源站权威性的同时降低多平台维护成本。 使用说明 核心用法 Skill Sync Publisher 是一款面向 Agent 技能开发者的跨平台发布管理工具，旨在解决技能市场碎片化带来的维护负担。用户通过本地 CLI 工具 bin/skill-sync 或 python3 scripts/sync.py 即可完成从初始化、预检到多平台同步的完整工作流。 典型使用流程分为四步：首先运行 init <skill-dir> 初始化技能目录配置；接着通过 preflight <skill-dir> 执行本地安全验证与合规检查；然后使用 sync 命令配合 --dry-run 预览变更，确认无误后执行正式同步；最后通过 status 跟踪各平台发布状态。工具支持增量恢复（--resume）、平台定向发布（--platform）及选择重置等高级功能。 当前覆盖八大目标平台：GitHub（源站托管）、Awesome Codex Plugins（插件市场）、HOL Registry、skills.sh、SkillsMP、LobeHub、ClawHub 及 Cursor Directory。针对不同平台的接入特性，工具采用差异化策略——对具备官方 CLI 的平台（如 HOL Registry、ClawHub）直接调用原生工具链；对目录型站点则生成浏览器跳转链接或手动提交指引，避免伪造不存在的 API 端点。 显著优点 源站权威架构：明确以 GitHub 仓库为唯一可信源，各注册表仅作为投影存在，从根本上杜绝版本分叉与状态不一致问题。 安全优先设计：内置 preflight 安全扫描流程，强制 --dry-run 预览机制，所有 Git 操作均展示精确 diff 与提交范围，禁止强制推送、回滚或触碰未关联的脏文件。 凭证零存储原则：明确声明不收集、不存储密码、Token、Cookie 或私钥，用户身份验证需现场完成，失败仅阻断对应平台而不影响全局流程。 平台适配精细化：区分原生 API 支持与手动提交流程，对无官方接口的目录站点（如 Cursor Directory、LobeHub）生成 planned 状态提示，引导用户完成网页验证后重试，避免虚假成功标记。 自动化与可控性平衡：默认开启确认门控（confirmation-gated），--yes 标志仅用于已审阅的 CI 场景，且不绕过平台选择与安全阻断器，兼顾效率与风险管控。 潜在缺点与局限性 手动闭环负担：skills.sh、SkillsMP、LobeHub 等四个平台需用户介入完成网页提交或验证，工具无法全程无人值守，对追求纯自动化发布的团队构成效率瓶颈。 平台生态依赖：部分平台（如 Awesome Codex Plugins）要求特定 manifest 格式，普通技能默认被阻断，需显式启用 --as-plugin 投影模式，增加了多形态维护成本。 状态分散存储：用户平台选择持久化于用户状态文件而非仓库，虽符合安全隔离原则，但导致团队协作时需额外同步个人配置，或出现"同一技能不同成员选择不一致"的潜在冲突。 恢复机制粗粒度：--resume 虽支持断点续传，但平台级失败需人工排查日志，缺乏可视化失败归因与自动重试策略（如速率限制退避）。 适合的目标群体 开源技能维护者：需要维护单一技能在多个市场曝光，追求"一次编写，多处发布"的开发者。 企业/团队技能管理员：负责内部 Agent 技能标准化上架，对安全审计、变更可追溯性有合规要求的 DevOps 或平台工程角色。 插件市场运营者：Awesome Codex Plugins 等生态的贡献者，需确保 manifest 合规与版本语义化。 使用风险 性能风险：跨平台串行同步时，任一平台的网络延迟或 CLI 调用耗时将阻塞后续队列；大规模批量发布场景建议按平台拆分并行 Job。 依赖项风险：npx @hol-org/registry、clawhub 等外部 CLI 的版本漂移可能导致行为不一致，需锁定版本或容器化运行环境。 凭证时效风险：现场身份验证依赖的浏览器会话或临时 Token 存在过期可能，长耗时发布流程中需关注重新认证提示。 平台策略变更风险：目录站点的提交流程、验证规则变更后，工具生成的 handoff URL 可能失效，需定期对照 references/platform-matrix.md 更新适配逻辑。 原始说明 Sync one skill across eight publishing channels