Skill monetize

skill-monetize：Skill 创作分成工具包

帮助 skill 创作者把自己的 skill 分享到 GitHub 时容易获得创作分成。三大能力： 配置打赏入口、维护署名/分成链、统计用量并算收益。收款通道为 GitHub Sponsors。

核心原则（务必遵守）

1. 非强制、不反感：用量统计默认只读 GitHub 公开指标，绝不默认回传任何数据。任何"提醒赞助"的文案都温和、可关闭、不阻塞用户。
2. 署名优先于收钱：先保证创作者署名链(lineage)正确，分成才有依据。
3. 诚实对账：GitHub Sponsors 的精确金额 API 不一定全暴露，拿不到就如实说明，让用户从 Sponsors 后台补录，不要编造数字。

触发方式

• /skill-monetize、/打赏配置、/分成
• 自然语言：「给我的 skill 加赞助」「发布 skill 并配 GitHub Sponsors」「算一下我这个 skill 的收益」「我 fork 了别人的 skill，怎么标注分成」

三个工作流

工作流 A：给一个 skill 配置打赏（最常用）

用户给出 skill 目录 + 自己的 GitHub Sponsors 账号，注入打赏基建。

python scripts/init_funding.py <skill目录> \
  --github <你的GitHub用户名> \
  --name "<你的署名>" \
  --repo <owner/repo> \                              # 给了就在赞助区加一行 star 引导
  [--sponsor-url https://github.com/sponsors/xxx] \  # 不给则按 github 用户名推断
  [--no-credit]                                      # 关闭底部 skill-monetize credit 飞轮

脚本会（全部幂等，可重复运行）：

• 写 <skill目录>/.github/FUNDING.yml
• 在 README 末尾插入「💛 支持作者」赞助区（Sponsor 徽章 + 可选 star 引导 + credit 行），已存在则跳过
• 创建/更新 <skill目录>/.skill-meta.json（创作者、版本、用量信号模式）

自传播飞轮：赞助区底部默认带一行不打扰的 credit（纯静态链接、零追踪），别人每用它配一次打赏 就多一次曝光，这是项目自然增长的来源。介意可加 --no-credit 关闭。CREDIT_URL 在脚本顶部可改。

完成后向用户复述：写了哪些文件、Sponsor 链接、下一步 git add/commit/push。 赞助区文案模版见 assets/README_support_block.md，可按用户语气调整。

工作流 B：标注署名/分成链（派生/二改场景）

用户基于别人的 skill 改造再发布时，把上游创作者加入 lineage，约定分成比例。

python scripts/manifest.py add-creator <skill目录> --name "我" --github me --share 0.7
python scripts/manifest.py add-upstream <skill目录> \
  --name "原作者" --github alice --sponsor-url https://github.com/sponsors/alice --share 0.3
python scripts/manifest.py show <skill目录>   # 校验各方 share 之和 = 1.0

分成模型与继承规则详见 references/attribution-model.md。 原则：上游创作者的署名与 Sponsor 链接必须保留，不能洗掉。

工作流 C：算收益 / 出报表

用 GitHub 公开指标 + Sponsors 数据生成收益报表，并按 lineage 拆分成。

python scripts/earnings_report.py <owner/repo> \
  [--meta <skill目录>/.skill-meta.json] \   # 提供则按分成链拆分
  [--net <本期净收入数字>] \                  # 已知净收入则代入拆分
  [--out report.md]

脚本用 gh CLI 拉取：stars、forks、clone/访问流量(需仓库 push 权限)、release 下载数、 Sponsors 数量（GraphQL）。流量或赞助金额拿不到时会标注"不可得"，不臆造。 报表口径见 references/revenue-report.md。

用量统计的三档（默认最克制，见 references/usage-signals.md）

• github-metrics（默认）：纯读 stars/forks/clone/下载，零侵入、不回传。
• soft-footer（可选）：skill 运行时偶尔追加一句温和的赞助提示，频率受限、用户可关。
• ping（仅显式开启）：匿名计数，默认关闭，需向用户讲清隐私并提供关闭方式。 设置：python scripts/manifest.py set-signal <skill目录> --mode github-metrics

文件结构

• scripts/init_funding.py — 注入 FUNDING.yml + README 赞助区 + manifest
• scripts/manifest.py — 读写 .skill-meta.json（创作者/上游/用量信号）
• scripts/earnings_report.py — 拉 GitHub 指标 + 算收益 + 按 lineage 拆分成
• references/funding-setup.md — GitHub Sponsors 与 FUNDING.yml 细节
• references/attribution-model.md — 署名/分成链模型与继承规则
• references/usage-signals.md — 三档用量统计的取舍与隐私底线
• references/revenue-report.md — 收益报表口径与计算
• assets/README_support_block.md — 赞助区可粘贴模版
• assets/skill-meta.template.json — manifest 模版

依赖

• gh CLI 已登录（gh auth status 校验）。工作流 C 必需；A/B 不需要。
• Python 3，标准库即可，无需第三方包。