SuperAPI AI 工具集

skill-publicizer

办公与效率

查看项目

更新于 11-04 11:48

技能介绍

Skill 公开化助手用于把一个带有个人经验、本机配置或真实数据的自用 Skill,变成他人拿到即可使用、并且不泄露维护者隐私的公开候选。其核心原则是:公开层只保留可复用机制,个人事实放入私有层;所有结论都绑定到真实候选;对外动作只执行用户已经明确授权的那一步。

用途与定位 本技能是流程编排层,不复制其他技能已有的细则,只在公开化场景中把步骤串联起来:结构合规使用 skill-creator 产出与校验,验收使用 skill-lint 的模块化规则,Git/PR/隐私预检使用 git-workflow,版本资产与平台同步使用 release-workflow 和 skill-publish-sync。它不代替 skill-lint 的正式验收、git-workflow 的 Git 门禁或各平台的发布合同,也不自动扫描整个磁盘查找隐私;它的处理范围以当前候选文件清单和任务指定的上下文为边界。二进制文件与非 UTF-8 材料交给 git-workflow 的隐私预检人工审查路径处理,本技能不提供跳过检查的开关。

参考文档的读取时机 开工前判断公开化目标、写入范围、授权与风险时,读取“公开化设计预检”;拆分通用层、示例层与私有层并设计配置合同时,读取“分层与配置合同”;逐文件剥离个人经验、设计占位符与登记表时,读取“个人经验剥离”;对齐版本、CHANGELOG、README 与发布字段时,读取“版本与索引同步”;运行静态门禁、测试与隐私检查时,读取“发布前门禁”;执行 PR、迁移、平台上传等对外动作时,读取“发布执行与授权边界”;需要可复用检查清单时,读取“案例检查清单”。

共同约束 先预检后动手:任何剥离或重构之前,先完成设计预检;如果目标、写入范围和动作已经获得明确授权,就直接记录后执行,只追问那些仍会改变方案的缺失信息。默认采用“单源自用公开同源”,即不维护“自用版/公开版”两套实现,自用差异放在本地配置或数据目录中,发行候选从同一源码构建,例外必须记录理由与两套源的同步责任。同源还要核对功能范围,一份源码并不意味着可以任意裁剪发行物,应先核对用户已确认的功能与兼容入口。.gitignore 不会解除已跟踪状态,本地配置若曾被跟踪,需先另存副本再逐项退出跟踪,发布包按路径硬排除作为兜底,形成版本控制 ignore 与发布包允许清单的双通道防护,并做正反例回归验证。静态检查只是最低要求,安全扫描、链接检查、示例验证通过并不等于语义隐私已经清零,独立复审与按产物类型的真实验证不可跳过。结构校验要先对齐目标规范:不同仓库对 version、author 等发布字段的合法位置不同,使用 quick_validate 前先读取目标项目发布规范与 skill-lint 的 references/frontmatter-metadata-policy.md,项目规范要求的字段不能因为通用校验器白名单更窄而被删除,工具不兼容时以目标仓库的结构规则为准并记录 NOT_VERIFIED。对外动作要逐级授权:整理、拆层、写测试可以自主推进,push、PR、合并、平台上传、公开仓库迁移以及 tag/Release 则需分别核对会话中已有的授权是否覆盖当前目标、写入范围与动作;前一步完成不隐含下一步授权。候选变化后要重新运行受影响的检查,不复用旧证据。

主流程

  1. 预检:固定目标 Skill、目标形态(公开仓库目录、独立仓库或平台包)、当前版本与基准、允许的写入范围和停止条件,识别已知风险类别,必要时先请用户裁决高风险项。
  2. 权威仓库裁决:私仓 Skill 迁入公开仓库时,确认公开仓库目录是“权威源”还是“同一源码的导出快照”,并写入预检输出;两种形态的门禁产物不同:如果公开仓库是权威源,需按公开仓库的项目规范同步 README 与套件索引;如果是导出快照,必须在 CHANGELOG 或任务记录中写明来源 OID、manifest 与同步方向,且公开仓库目录不独立修改实现。
  3. 分层:把文件归入通用层(入库)、示例层(入库的 .example. 与 schema)、私有层(本机数据,不入库),并设计配置合同,包括解析顺序、缺省行为、坏配置处理和校验入口。
  4. 剥离:逐文件处理个人经验,其方式包括占位化、泛化、结构化(写成步骤或判据而不是叙述)或整体移入私有层;许可与外部来源先查清,第三方材料按用户裁决删除替换或标注。
  5. 同步版本与索引:让 SKILL.md 版本、CHANGELOG 最新条目及其历史条目、README 索引(含最近更新区)、发布字段(license/homepage/author)一次对齐,历史条目同样去具体化。
  6. 门禁:执行静态安全扫描、Harness 失效审查、quick_validate、链接与引用检查、示例对 schema 校验、ignore 正反例验证,以及脚本的离线测试(若有),证据写入任务卡。
  7. 前向检查:按公开使用说明完成隔离安装与首次配置,其余检查按候选实际能力选取;不存在的能力记为“不适用”并写明依据,适用而未执行的项记为 NOT_VERIFIED,并逐条写明阻塞范围与恢复条件。
  8. 独立复审:指派没有旧上下文的只读 reviewer 给出结构化发现,由 PM 独立验收,不采信自报。
  9. 执行与收口:按授权依次进行 safe-push、safe-pr(Draft)、合并/迁移/平台上传,回写任务状态与证据,并明确 NOT_VERIFIED 项。

完成定义 公开化整理阶段完成的条件是:分层落地并有正反例验证、个人锚点清零或登记豁免、版本引用一致、关键门禁全部执行并通过、独立复审无未闭合阻断项、任务卡记录证据。门禁分两类:关键门禁包括静态安全扫描、隐私检查、适用的行为验证、真实产物生成、版本与索引一致性,未执行或未通过时整理阶段保持未完成,不能用 NOT_VERIFIED 覆盖;其他适用门禁包括链接与引用、示例与 schema、ignore 正反例、扩展项的平台或 Runtime 覆盖等,未执行时记为 NOT_VERIFIED,并写明其不阻塞的范围与恢复条件。判定为“不适用”的项不算 NOT_VERIFIED,也不阻塞任何结论,但需要写明判定依据。完成不等于已发布,正式发布前还需按 skill-lint 完成候选绑定证据验收,发布以真实远端回执或平台回执为准,并且必须在用户已授权的范围内。

适用场景与依赖 本技能适用于用户要求把个人自用 Skill 公开化、可分享化、迁移公仓或做发布整改的场景;不适用于普通代码审查、把 Skill 同步或上传到 ClawHub、SkillHub 等平台,以及未经用户授权的对外发布。处理法律或客户材料时遵循最小必要原则,无法确认是否真实的信息按疑似具体信息处理。依赖包括 skill-creator、skill-lint、git-workflow,仅在构建发布包或 Release 时需要 release-workflow,仅在上传目标平台时需要 skill-publish-sync;使用前先确认对应技能与执行工具可用,缺失时暂停依赖它的阶段并说明缺口,同时保留可独立完成的整理工作。本技能不内置上述脚本,也不保证单独复制它的目录即可完成 Git 或平台操作。