skill-publicizer · v1.0.0 · 2026-10-26 · sha256 19b05e4af8553beb
skill-publicizer v1.0.0A
Immutable. This exact content never changes and is served at /api/v1/blob/19b05e4af8553beb.
--- name: skill-publicizer description: 本技能应在用户要求把个人自用 Skill 公开化、可分享化、迁移公仓或做发布整改时使用。不要用于:普通代码审查;把 Skill 同步/上传到 ClawHub、SkillHub 等平台(用 skill-publish-sync);未经用户授权的对外发布。 license: MIT metadata: version: "1.0.0" homepage: https://github.com/cat-xierluo/legal-skills author: 杨卫薪律师(微信ywxlaw) --- # Skill 公开化助手 把一个带个人经验、本机配置或真实数据的自用 Skill,变成他人拿到即用、且不泄露维护者隐私的公开候选。核心原则:**公开层只保留可复用机制,个人事实放私有层;结论绑定真实候选;对外动作只做用户已明确授权的那一步**。 本技能是流程编排层:结构合规用 skill-creator 产出与校验,验收用 skill-lint 的模块化规则,Git/PR/隐私预检用 git-workflow,版本资产与平台同步用 release-workflow 和 skill-publish-sync。不复制它们已维护的细则,只在公开化场景把步骤串起来。 ## 何时读哪份参考 | 当前阶段 | 读取 | |---|---| | 开工前判断目标、写域、授权与风险 | [公开化设计预检](references/publication-preflight.md) | | 拆通用/示例/私有三层,设计配置合同 | [分层与配置合同](references/layering-and-config.md) | | 逐文件剥离个人经验、设计占位符与登记表 | [个人经验剥离](references/personal-experience-extraction.md) | | 对齐版本、CHANGELOG、README 与发布字段 | [版本与索引同步](references/version-and-index-sync.md) | | 跑静态门禁、测试与隐私检查 | [发布前门禁](references/release-gates.md) | | 执行 PR/迁移/平台上传等对外动作 | [发布执行与授权边界](references/publish-execution.md) | | 需要三案例的可复用检查清单 | [案例检查清单](references/case-checklist.md) | ## 共同约束 - **先预检后动手**:任何剥离或重构前,先完成设计预检;目标、写域和动作已有明确授权时直接记录后执行,仅追问仍会改变方案的缺失信息。 - **单源自用公开同源**:默认不维护「自用版/公开版」两套实现;自用差异放本地配置或数据目录,发行候选从同一源构建。例外须记录理由与两套源的同步责任。 - **ignore 不解除已跟踪**:把文件写进 `.gitignore` 不会让已跟踪文件退出版本控制;本地配置若曾被跟踪,需先另存副本再逐项退出跟踪,发布包按路径硬排除作为兜底。 - **双通道防护**:版本控制 ignore 规则挡提交,发布包允许清单挡打包;两道都要有,且都要有回归验证(含正反例)。 - **静态检查是下界**:安全扫描、链接检查、示例验证通过不等于语义隐私已清零、行为已验收;独立复审与按产物类型的真实验证不可跳过。 - **对外动作逐级授权**:整理、拆层、写测试是可自主推进的工作;push、PR、合并、平台上传、公开仓迁移、tag/Release 分别核对会话中已有授权是否覆盖当前目标、写域与动作;授权持续有效,缺失或目标变化时才补问,前一步完成不隐含下一步。 - **候选绑定证据**:所有通过结论绑定当前候选 OID/哈希;候选变化后重跑受影响检查,不复用旧证据。 ## 主流程 1. **预检**:固定目标 Skill、目标形态(公仓目录/独立仓/平台包)、当前版本与基准、允许写域、停止条件。识别已知风险类别(见预检参考的风险表),必要时先请用户裁决高风险项。 2. **分层**:把文件归入通用层(入库)、示例层(入库的 `*.example.*` 与 schema)、私有层(本机数据,不入库)。设计配置合同:解析顺序、缺省行为、坏配置处理、校验入口。 3. **剥离**:逐文件处理个人经验——占位化、泛化、结构化(写成步骤/判据而不是叙述)、或整体移入私有层。许可与外部来源先查清;第三方材料按用户裁决删除替换或标注。 4. **同步版本与索引**:`SKILL.md` 版本、CHANGELOG 最新条目、README 索引(含最近更新区)、发布字段(license/homepage/author)一次对齐;CHANGELOG 历史条目同样去具体化。 5. **门禁**:静态安全扫描、Harness 失效审查、quick_validate、链接/引用、示例对 schema、ignore 正反例、(若有脚本)离线测试。证据写任务卡。 6. **独立复审**:指派无旧上下文的只读 reviewer,给出结构化发现;PM 独立验收,不采信自报。 7. **执行与收口**:按授权走 safe-push → safe-pr(Draft)→ 合并/迁移/平台上传;回写任务状态与证据,明确 NOT_VERIFIED 项。 ## 完成定义 公开化整理阶段完成 = 分层落地并有正反例验证、个人锚点清零或登记豁免、版本引用一致、门禁全绿、独立复审无未闭合阻断项、任务卡记录证据。**这不等于已发布**——正式发布前还需按 skill-lint 完成候选绑定证据验收;发布以真实远端回执/平台回执为准,且须在用户已授权范围内。 ## 边界 - 不代替 skill-lint 的正式验收、git-workflow 的 Git 门禁或各平台的发布合同。 - 不自动扫描全盘找隐私;以当前候选文件清单和任务指定的上下文为界。 - 二进制与非 UTF-8 材料走 git-workflow 隐私预检的人工审查路径,本技能不发明跳过开关。 - 处理法律/客户材料时遵循最小必要;无法确认是否真实的信息按疑似具体信息处理。 ## 按阶段需要的依赖 - `skill-creator`:Skill 编辑与结构校验;`skill-lint`:质量/隐私/候选证据审查。 - `git-workflow`:Git 提交、推送、PR、身份与完整历史预检。 - `release-workflow`:仅在构建发布包或 Release 时需要;`skill-publish-sync`:仅在上传目标平台时需要。 先确认对应技能与执行工具可用;缺失时暂停依赖它的阶段并说明缺口,保留可独立完成的整理。 本技能不内置上述脚本,也不保证单独复制它的目录即可完成 Git/平台操作。 Skill 内的使用说明写在 SKILL.md 和按需 references;README 仅指目标仓库或套件的外部索引。