这个 Skill 能做什么，适合哪些场景？
cmux-backend 是随 cmux 仓库（manaflow-ai/cmux）捆绑的第 25 个技能之一，位于 skills/cmux-backend/SKILL.md。它不是工具脚本，而是一套面向 AI 编码代理的后端开发规则：规定在 web/app/api 与 web/services 中默认使用 Effect 框架，将 Postgres 作为 VM 生命周期的唯一事实来源，并约束迁移与密钥的加载方式。当代理被要求修改后端 API、Cloud VM 生命周期或供应商集成代码时，这套规则会指导其产出符合项目架构的改动。
- 在编辑 web/app/api/、web/services/ 及后端脚本时，强制默认使用 Effect 框架组织代码
- 规定 Next 路由处理器保持精简：解析请求、在边界运行一个 Effect 程序、把类型化错误映射为 HTTP 响应
- 将 Postgres 确立为 VM 生命周期、活跃 VM 限额、幂等性与用量事件的唯一事实来源
- 指定生产/预发环境连接 PlanetScale PostgreSQL 数据库 cmux-prod，运行时读取 DATABASE_URL 并设置 CMUX_DB_DRIVER=url
- 规定迁移只能通过 bun run cloud-vm:migrate -- staging 再 -- production 执行，禁止从 Vercel 构建或路由启动时运行
- 指导从 ~/.secrets/cmux.env 读取 FREESTYLE_API_KEY 等 R2 上传变量
- 维护 cmux 后端的开发者，需要让 AI 代理在修改 web/services 下的 Effect 服务时遵循项目架构约定
- 编写新的 Cloud VM 控制平面功能，希望代理正确使用 Postgres 记录 VM 生命周期与限额而非引入 Rivet 或原始 actor 协议
- 需要对 staging/production PlanetScale 数据库执行迁移，希望代理按正确命令与顺序操作
- 配置 Stack Auth 团队付费项作为 Cloud VM 创建的价格门槛时，需要规则指引
- 为供应商镜像构建脚本准备本地密钥环境，需要正确 sourcing ~/.secrets/cmux.env
- 不适用于 cmux 前端 React 代码或琐碎的 TypeScript 数据结构——该技能明确限定 Effect 的使用边界
- 不针对不熟悉 cmux 仓库的外部项目——规则深度绑定 cmux 的具体路径、数据库与密钥布局
如何安装这个 Skill？
- 技能针对的 web/ 目录采用 BUSL-1.1 许可，生产使用需商业授权，技能文件未提示此点。
- 该技能为编码规范型，不执行任何脚本；其规则与代码库的实际一致性未经执行验证。
- 后端栈依赖 PlanetScale、Vercel、Stack Auth 等海外服务，中国大陆网络环境下核心功能可达性未声明。
- 仓库许可证元数据为 NOASSERTION，发布方未经 FollowSkills 验证，身份未知（不视为可疑）。
- Shell / 命令行
- 网络访问
- 本地文件系统
BunDocker (local Postgres via bun dev)PlanetScale PostgreSQL
该技能属于 manaflow-ai/cmux 仓库内捆绑的 25 个技能集合，源文档未给出单独安装命令；将仓库克隆后把 skills/cmux-backend/ 目录放入你的 Agent Skills 兼容客户端即可。
git clone https://github.com/manaflow-ai/cmux.git
cp -r cmux/skills/cmux-backend ~/.claude/skills/如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 在 web/services 中新增一个 Cloud VM 限流服务，按照 cmux-backend 规则使用 Effect 并把错误映射为 HTTP 响应
- 帮我给 staging PlanetScale 数据库跑一次迁移，注意不要从 Vercel 构建中触发
- 我要给 Cloud VM 创建加一个 Stack Auth 团队付费门槛，请参考 effect-boundaries.md 和 cloud-vm-control-plane.md 后动手
技能通过其 YAML frontmatter 的 description 触发：当任务涉及 web/app/api、web/services、后端脚本、Cloud VM 生命周期、供应商集成、Postgres、Stack Auth 价格门槛、迁移或供应商镜像构建脚本时，代理应加载该技能并按其规则执行。核心规则之后引用两个详细参考文档：references/effect-boundaries.md（路由处理器、服务、类型化错误、重试、依赖注入）与 references/cloud-vm-control-plane.md（VM 生命周期、迁移、Postgres、供应商幂等性、价格门槛）。本地开发时 bun dev 会先 source ~/.secrets/cmux.env 再 source ~/.secrets/cmuxterm-dev.env。
这个 Skill 有哪些优点和局限？
- 规则非常具体，直接绑定真实路径、命令与环境变量，可立即执行
- 包含两个详细参考文档，覆盖 Effect 边界与 Cloud VM 控制平面的深层细节
- 明确禁止反模式（如在 Vercel 构建时运行迁移、重新引入 Rivet）
- 仅对 cmux 仓库本身有价值，规则无法直接迁移到其他项目
- 技能未附带可执行脚本或测试，规则遵守程度取决于代理的自查
- 仓库 License 标记为 NOASSERTION，实际为 GPL-3.0 与 BSPL 1.1 混合（web/ 目录为 Business Source License 1.1），商用需注意
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux 后端开发规则技能 本页 | 51 · 谨慎使用 | ★ 28k | 今天 | NOASSERTION |
| Effect JSDoc 规范撰写技能 | 77 · 高度推荐 | ★ 26k | 3 天前 | MIT |
| Anti-Slop：反低证据代码模式的 Oxlint 规则集 | 62 · 推荐 | ★ 5.3k | 1 个月前 | MIT |
| PinMe Worker 认证 API 集成 | 59 · 推荐 | ★ 3.7k | 3 个月前 | MIT |
| Supabase 开发助手 | 55 · 谨慎使用 | ★ 2.7k | 9 天前 | MIT |
与通用的 Effect-TS 或 Next.js 最佳实践指南相比，cmux-backend 的价值在于其规则精确对应 cmux 的实际代码库结构（具体路径、PlanetScale 数据库、密钥文件位置），而非泛泛的框架建议；对于不修改 cmux 代码库的开发者，通用的 Effect 官方文档可能更合适。
FollowSkills 如何评估这个 Skill？
该技能本身不执行代码、不索取广泛权限，秘密管理建议（~/.secrets 分离、不将 AWS 凭据混为数据库凭据、迁移用受保护 DATABASE_URL）体现了最小权限和数据流透明意识。扣分点：无用户确认/回滚机制，技能文件未说明自身数据流，来源归属仅限仓库层级且发布方未经注册表验证，许可证元数据为 NOASSERTION。
指令内部自洽（SKILL.md 与两个 references 相互呼应、无矛盾），渐进式引用结构完整。扣分点：该技能是纯规则型指导，无脚本可运行，无测试或错误反馈路径；静态审查按锚点封顶于 10，且关键路径（如迁移命令、Effect 边界）未经执行复现。
触发条件在 description 中写得明确具体（web/app/api、web/services、Cloud VM、迁移、定价门等），适用/不适用边界（Effect vs 普通 TS 的划分）清楚。扣分点：核心依赖 PlanetScale、Vercel、Stack Auth、AWS 均为海外服务，未声明中文支持或中国大陆可达性考虑；非适用范围虽有原则性说明但无显式清单。
文档分层良好（SKILL.md 概览 + references 详述），命名稳定，与仓库结构对应。扣分点：技能自身无版本号、变更日志或独立维护责任声明；仓库许可证为 GPL+BUSL 双轨制，而技能覆盖的 web/ 目录恰在 BUSL 范围内，技能文件未披露这一限制，许可证元数据 NOASSERTION。
作为编码规范技能，其价值主张（统一 Effect 架构、迁移纪律、幂等性检查清单）明确且具体可操作，对使用 cmux 后端的贡献者有边际价值。扣分点：静态审查无法验证规则产出代码的正确性，收益与替代方案（直接阅读架构文档）对比证据有限。
引用的 references 文件真实存在且内容一致，仓库有真实 CI 工作流可佐证工程实践。扣分点：无针对该技能规则的独立测试或第三方执行证据，规则与实际代码库的一致性仅能推断，静态审查按锚点封顶于 5。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →