技能开源助手

要解决什么问题

把一个本地 skill 推上 GitHub，远不只是 git init + git push。实际操作中反复踩的坑至少有三类：slug 撞名（clawhub 不支持改名，发布即锁死）、内网信息残留（路径、邮箱、内部关键词混进代码）、frontmatter 不合规（description 超字节上限、塞了 version/metadata 字段导致跨 agent 读取失败）。此外 token 怎么传、LICENSE 选什么、版本号从几开始，都是需要人拍板而非脚本自决的节点。

核心能力与关键步骤

该技能把整个流程拆成 10 步，并按「能否脚本化」分成两类：

• 可脚本化的走 bash：precheck.sh 做 slug 冲突预检、strip_scan.sh 跑 11 条剔除清单、check_frontmatter.py 校验 SKILL.md、gen_license.sh 生成 LICENSE、scaffold.sh 生成 README 与 .gitignore、git_init.sh 初始化仓库。
• 需要决策的走对话：是否开源、走副本还是原地演进、LICENSE 类型、slug 是否改名、token 来源。

几条贯穿全程的设计原则值得单独说：

• 副本而非演进：原 skill 一行不动，副本放进 opensourceskills//，独立 commit、独立版本号。
• 身份配置一次永久用：作者名、GitHub handle、邮箱存于 ~/.config/opensource-skill-to-github/profile.env，换 agent 或重装 skill 都不丢。
• Token 卫生：token 只走环境变量或 OSG_GITHUB_TOKEN_CMD，绝不写入 git remote、日志或 memory；用一次性 PAT 推送后提示撤销。
• 首版直接 v1.0.0：clawhub 用户期望成熟的首发，不用 v0.x 试探。
• push 用 Basic Auth header：受限网络下 bearer 可能不被接受。

适用边界

• 依赖 bash ≥ 4.0、git、python3 ≥ 3.8；curl、rsync、node + npm 按需使用。
• 每个 grep 命中的内网残留都必须由人确认保留、删除或改写，AI 不自决。
• LICENSE 的作者署名需用对外身份与公网邮箱，不能填内网信息。
• GitHub 仓库创建这一步必须人工完成，技能只负责推送。
• clawhub 与 skillhub.cn 发布为可选步骤，且部分内网 hub 会把 public 静默降级为 private。