这个 Skill 能做什么，适合哪些场景？
cmux-billing 是 manaflow-ai/cmux 仓库中 25 个技能之一，位于 skills/cmux-billing/SKILL.md。它是一份面向 AI 编码代理的计费领域知识文档，覆盖 Stripe Checkout、客户门户、订阅录制、Pro 权益解析、管理员路由与测试脚本。技能本身不执行任何操作，其价值在于让代理在改动计费代码前先掌握幂等录制、环境开关、价格目录和迁移流程等关键约束。适合参与 cmux 服务端（web/）计费开发的工程师或代理使用，对其他项目没有直接适用性。
- 提供计费架构地图：checkout、portal、subscription、webhook、purchase.ts 等路由与模块的职责和边界
- 说明 Pro 权益解析逻辑：cmuxVmPlan 运维覆盖优先于 Stripe 镜像的 cmuxPlan，billingManagement 保持仅 Stripe
- 列出完整价格目录与 Stripe 产品/价格/门户配置 ID，包括测试模式与生产模式、遗留 grandfathered 价格与环境覆盖变量名
- 记录开发工作流：dev-stack.sh、dev-grant.sh、dev-reset.sh、CMUXDEV100 测试优惠券、Docker Postgres --db-port 注意事项
- 给出生产上线 runbook：provision-live.sh、Vercel 环境变量、迁移顺序（preflight → staging → production）
- 收录已知坑：bun mock.module 全局性、DrizzleQueryError 需读 error.cause、非 locale 页面需 proxy.ts bypass 等
- 在 cmux 仓库修改或调试 /api/billing/* 或 /api/stripe/webhook 代码的工程师，需要先了解幂等录制与签名验证约束
- 需要为付费用户授予、切换或降级计划的运维人员，想弄清 cmuxVmPlan 覆盖与 admin_plan_grants 的生效条件
- 处理 Stripe Webhook 未生效或重复发放权益的排查者，需要了解 insert-first 幂等和 2xx/500 返回策略
- 需要调整定价或新增年付套餐的开发者，想避免改动不可变的 Stripe 金额并正确使用 LEGACY_PRICE_LOOKUP_KEYS
- 在本地搭建计费测试环境的贡献者，需要用 dev 脚本与 100% 折扣券走完整结账流程
- 非 cmux 仓库的 Stripe 项目：技能内容全部硬绑定 cmux 的路由、脚本和环境变量名，无法复用
- 不参与计费/权益开发的 cmux 贡献者：这份文档对终端用户功能、CLI、通知等主题毫无帮助
- 寻求通用计费集成教程的读者：这是内部 runbook，不是 Stripe 教学
如何安装这个 Skill？
- 这是一份面向 cmux 仓库内部贡献者的计费 runbook，对外部用户几乎不可直接使用；确认你的任务确属修改/调试 cmux 计费代码再调用。
- 核心流程完全依赖 Stripe、Vercel、Stack 等境外服务，中国大陆网络环境下可达性与可用性未经验证。
- 文档内嵌大量内部产品/价格/端点 ID（如 staging webhook 端点），虽非密钥，但属于敏感内部信息，复用或引用时注意暴露面。
- 许可证元数据为 NOASSERTION，且 web/ 目录受 BUSL-1.1 商业许可限制（生产使用需商业授权），在计费相关代码上二次使用需自行核实许可边界。
- 所有脚本与实现断言均为静态文档阅读所得，未执行验证；按文档操作前应核对引用文件的实际内容。
- Shell / 命令行
- 本地文件系统
BunStripe CLIDocker (Postgres)
来源未给出独立的安装命令；该技能随 manaflow-ai/cmux 仓库分发，获取方式是克隆仓库并读取 skills/cmux-billing/SKILL.md：
git clone https://github.com/manaflow-ai/cmux.git将其放入你的代理技能目录（如 Claude Code 的 skills 路径）即可被自动发现，具体目录路径来源未记载。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 我要修改 /api/billing/checkout 的 team 逻辑，先按 cmux-billing 技能梳理现有回退路径再动手
- 客户付费后 Pro 状态没生效，请按 cmux-billing 的 webhook 章节排查 stripe_webhook_events 的幂等记录
- 帮我把 Pro 年付价格从 $480 调整为 $528，按技能里关于 Stripe 金额不可变和 LEGACY_PRICE_LOOKUP_KEYS 的说明给出步骤
- 在本地给 [email protected] 模拟一次 Pro 购买并再撤销，使用 cmux-billing 中的 dev-grant 和 dev-reset 流程
技能通过其 description 触发：当任务涉及编辑或调试计费、定价、Stripe Checkout、订阅录制、Pro 计划状态、Webhook、权益元数据或定价 dev/prod 工具时，代理应先阅读此文档再动手。核心用法是让代理在改代码前加载其中的架构约束（如幂等录制、webhook 只在持久化写入后返回 2xx），并按 Dev workflow 章节运行本地脚本：
web/scripts/stripe/dev-stack.sh
web/scripts/stripe/dev-reset.sh <email>
web/scripts/stripe/dev-grant.sh <email>生产操作按 Prod runbook 执行：
web/scripts/stripe/provision-live.sh
bun run cloud-vm:preflight
bun run cloud-vm:migrate -- staging
bun run cloud-vm:migrate -- production这个 Skill 有哪些优点和局限？
- 覆盖面极完整：从路由架构、权益解析到价格目录 ID、环境变量和迁移顺序一应俱全
- 包含大量只能来自实战的 gotcha（mock.module 全局性、Drizzle 错误包装、proxy.ts bypass），可直接避免返工
- 明确安全边界：webhook 签名验证、幂等、绝不基于未验证邮箱跨账户发放权益
- 强绑定 cmux 仓库，对外部项目零复用价值
- 包含大量内部 ID（产品、价格、门户配置、staging webhook endpoint），时效风险高，需随代码同步维护
- 技能本身无脚本或自动化，只是文档，正确性依赖代理遵循而非强制执行
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux 计费运维技能 本页 | 50 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 工作区操作技能 | 64 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux-browser：cmux 内置浏览器自动化技能 | 60 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 设置管理技能（cmux-settings） | 58 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| Stripe AI 开发工具集 | 待评估 | ★ 1.9k | 3 天前 | MIT |
FollowSkills 如何评估这个 Skill？
SKILL.md 描述的计费流程具备多项安全设计：webhook 签名验证、insert-first 幂等表、不基于未验证邮箱交叉授予权、admin 门禁（requireAdmin + 域名/成员校验）、非管理员 403、敏感数据流披露较清晰。扣分点：文档内嵌了大量生产/测试 Stripe 产品与价格 ID、staging webhook 端点等内部标识（信息暴露面偏大但非密钥）；dev 环境自动授予 Pro 的开关逻辑复杂，误配置边界依赖四个环境变量同时满足；未提供明确回滚说明；发布者未经验证。
文档自洽且异常路径描述充分（Stripe 500 重试、503 未迁移、typed resource-pool 错误、drizzle 错误包装读取 error.cause、Stripe CLI 两种格式兼容），Gotchas 有真实工程味道。扣分点：静态审查无法执行任何脚本（dev-stack.sh、dev-grant.sh、provision-live.sh 均未提供源码），关键路径不可复现，失败反馈质量仅凭描述，故按锚点封顶在 10 以下。
frontmatter 触发条件写得非常精确（编辑/调试 billing、pricing、Stripe、webhook、Pro 状态等），边界清晰，适用人群是 cmux 代码库的贡献者/代理。扣分点：这是仓库内部 runbook 技能，对外部用户价值有限；核心功能依赖 Stripe、Vercel、Stack 等境外服务，中国大陆可达性存在风险；无中文支持说明。
信息架构分层良好（架构图→开发流程→目录→flags→生产 runbook→Gotchas），包含已知限制与迁移步骤。扣分点：技能本身无版本号/变更日志；许可证元数据为 NOASSERTION，且仓库许可证复杂（GPL + web/ 目录 BUSL-1.1 商业限制），技能未声明自身许可归属；维护责任与更新路径仅能间接推断。
对目标用户（修改 cmux 计费代码的代理/开发者）边际价值明确：集中了路由、脚本、价格目录、环境变量与坑点，避免散落检索。扣分点：无任何已验证的代表性输出；多个关键脚本与实现文件不在证据范围内，完成度与直接可用性只能凭描述采信，静态锚点封顶 7。
SKILL.md 的所有断言（ID、脚本、迁移、门禁逻辑）均不可独立验证——引用的源码文件未随证据提供。仓库存在大量真实 CI 工作流与测试（app-host 测试、auth 测试等），但未见覆盖计费关键路径的证据。扣分点：单一来源叙述、事实与推断无法分离，静态审查下仅能给到低分区。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →