开发与工程

cmux 合并前审查技能

在合并前审查 AI 编程代理的改动,用子代理独立发现正确性缺陷,以证据验证修复,控制审查消耗的开发者注意力。

55/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 28k
最近更新
1 天前
License
NOASSERTION
code-reviewpre-merge-reviewadversarial-protocolgit-workflow
+3subagent-reviewmerge-approvalverification-evidence

这个 Skill 能做什么,适合哪些场景?

cmux-review 是 manaflow-ai/cmux 仓库 skills 集合中的一个 Agent Skill,专门用于审查代理写出的代码改动。它的核心原则是用审查流程减少开发者需要投入的注意力:只暴露具体的正确性缺陷,压制风格意见和琐碎改进。默认流程通过一个审查子代理基于 base/head SHA 和 diff 独立发现问题,验证后才允许修复与合并;对安全、并发、数据丢失等高风险改动则升级为完整的对抗性审查协议。该技能只包含 Markdown 指令和参考文档,不附带可执行脚本。

  • 读取任务意图、base/head SHA 和精确 diff,交给当前运行时的审查子代理独立发现正确性问题与仓库规则违规
  • 以“修复前红、修复后绿”的测试证据验证每个具体发现,授权后才修复并推送,修复后重跑原始判别测试
  • 对非平凡修复获取一次全新的子代理复审,审查修复增量
  • 检查通过且满足批准规则后才合并,报告发现、验证过程与覆盖缺口
  • 高风险改动走对抗性协议:源身份确认、独立审查者、反证与可执行检查,最终持久化审查收据与报告
适合
  • 运行 Claude Code、Codex 等代理的工程师,在把代理改动合并进主分支前做最后一道正确性把关
  • 代理完成了大幅编辑后,需要一次独立于作者推理的复审再决定是否接受
  • 代理声称“已修复”某 bug 后,重新审查修复增量而非直接相信绿色测试
  • 改动涉及安全、持久化、并发或数据丢失风险时,需要执行完整的对抗性深度审查
  • 团队需要一份带证据和收据的合并报告,用于追溯每个修复的验证过程
不适合
  • 只想要风格检查、lint 或格式统一的团队——该技能明确压制风格与琐碎建议
  • 无代理工作流的普通人工 PR 审查——流程围绕审查子代理与代理改动设计
  • 需要依赖外部审查服务或第二模型把关的场景——技能明确要求使用当前运行时的子代理,而非外部服务

如何安装这个 Skill?

使用前请注意
  • 静态评审,未执行任何技能指令;评分为低置信度源码推断。
  • 技能强依赖 cmux 专有运行时(Vault、workspace 状态、comments CLI)与 subagent 支持,在非 cmux 环境中多数高级流程不可用。
  • 修复与推送等有副作用操作默认允许(在授权后),用户应确认授权范围;收据要求存储于源码库外,请勿误提交。
  • 适用人群为使用 GitHub PR 流程的英文开发者,无中文文档;dogfood/Vercel/CI 相关环节在中国大陆可达性未验证。
  • 仓库 license 元数据为 NOASSERTION,且部分目录为 BUSL-1.1,使用前需自行确认许可边界。
  • 该流程较重,对小型低风险改动成本收益比可能不划算,建议仅用于高风险或明确请求的深度评审。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • git

来源(README 与 SKILL.md)没有给出这个单独技能的安装命令,只说明了仓库以 25 个技能的集合形式分发,技能文件位于 skills/cmux-review/SKILL.md,并附带 references/ 下的参考文档。若使用 Agent Skills 兼容的宿主,通用做法是把技能文件夹复制进宿主的技能目录,具体步骤未在来源中记录。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/manaflow-ai/cmux.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/cmux-review" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 合并这个代理写的改动前先做一次审查:base 是 abc1234,head 是 def5678,只报正确性问题
  • 代理刚大幅重构了支付模块,帮我独立复审一遍再决定是否接受
  • 代理说修好了那个并发 bug,重新审查一下修复增量,给我修复前红、修复后绿的证据
  • 这个改动涉及用户数据的持久化逻辑,按对抗性协议做一次深度审查

该技能由模型自动触发,触发条件写入 SKILL.md 的 description:合并前审查代理改动、大幅编辑之后、或重新审查一次修复。默认流程四步:给审查子代理下发意图、SHA 与 diff;验证发现并在授权后修复、重跑判别测试;非平凡修复再获取一次全新复审;检查通过且批准规则满足后合并。审查保持只读直到授权修复,且不提交审查收据、临时复现脚本或日志。对于实现交接或合并,需按 references/dogfood-and-merge.md 执行逐改动验证;应用/运行时/UI 合并需要用户在 dogfood 后明确批准,或直接下达合并指令(如 merge、auto-merge;finish、lgtm、ship it 不算)。main 分支按夜间策略处理:堆叠修复而不是回滚。高风险场景切换到 references/ 中的对抗性协议(发现与分诊、挑战与验证、收据持久化)。

这个 Skill 有哪些优点和局限?

优点
  • 独立子代理审查避免作者推理污染发现过程,配合修复前红/修复后绿的证据要求,能识别空洞的绿色测试
  • 范围纪律明确:只报正确性缺陷,压制风格意见,减少开发者注意力消耗
  • 对抗性协议覆盖安全、并发、数据丢失等高风险维度,并要求持久化收据与前后修复的源坐标
  • 合并批准规则具体可执行,明确哪些口头指令构成合并授权
局限
  • 技能本身没有任何自动化测试或脚本,效果完全依赖宿主模型遵循指令的质量
  • 子代理(subagent)机制在不同 Agent Skills 宿主间实现不一,可移植性存在实际摩擦
  • 来源未提供安装命令、演示或基准数据,难以评估实际收益
  • 仓库整体许可证为 NOASSERTION(README 提到 GPL-3.0-or-later 加上服务器端的 Business Source License 1.1),商用前需确认该技能文件的具体许可条款

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
cmux 合并前审查技能 本页 55 · 谨慎使用 ★ 28k 1 天前 NOASSERTION
子代理驱动开发 50 · 谨慎使用 ★ 297k 16 天前 MIT
PR 保姆:持续监控拉取请求直至合并 47 · 谨慎使用 ★ 98k 3 天前 Apache-2.0
Imprint — AI 工作印记 46 · 谨慎使用 ★ 103 19 天前 MIT
PR 提交流程规范 40 · 不推荐 ★ 5.2k 3 天前 Apache-2.0

SKILL.md 将自身定位与传统做法区分开:它拒绝用第二模型或外部审查服务作为把关方,坚持使用当前运行时内的审查子代理;也不像通用 lint/CI 工具那样做风格检查,而是专注于正确性缺陷与证据化验证。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
55/ 100 五分制 2.8 / 5
1信任安全16 / 25 · 3.2/5

该技能默认评审阶段只读、修复需用户授权、禁止提交回执与临时产物、回执存储在源码库之外、不使用外部服务作门禁,且引用了带 schema 的收据机制,数据流与外部效应披露较好;扣分点在于对 git push、修复提交、媒体上传等有副作用的操作缺少显式确认门(仅对合并要求批准),授权边界依赖代理自行判断,技能文件本身未声明权限范围。

2可靠稳定11 / 20 · 2.8/5

文档结构自洽:发现-挑战-验证-修复-收据的流程闭环清晰,含 P0-P3 分级、验证结果枚举和证据分类;但为纯指令型技能,无可执行测试或脚本随附,关键路径未静态复现,交叉引用(如 cmux-testing、Vault、cmux CLI)未在给定文件中证实,异常输入(无 cmux 环境、无 subagent 支持)仅有部分降级说明,扣至静态上限以下。

3适用触发9 / 15 · 3.0/5

触发场景明确(合并前评审、大幅编辑后、修复复评、高风险深度评审),描述字段语义清晰;但能力边界声明不完整——强依赖 cmux 运行时(workspace 状态、Vault、comments CLI)、subagent 支持、GitHub PR 流程,非 cmux 环境适用性仅部分说明;技能无中文文档,且其服务的 dogfood/Vercel/GitHub 工作流在中国大陆可达性存在不确定性,扣分。

4规范维护9 / 15 · 3.0/5

分层文档良好(主文件 + references 深入细节 + JSON schema),收据 schema 规范完整,命名稳定;但技能自身无版本号/变更日志,无 FAQ 与已知限制章节,所属仓库 license 元数据为 NOASSERTION 且混合 GPL/BUSL 需用户自行辨析适用范围,维护责任仅体现为仓库归属,扣分。

5有效结果6 / 15 · 2.0/5

目标明确(以独立发现、对抗挑战、可执行验证减少人工评审负担),方法论优于通用提示;但为静态评审,无法证实实际产出可用性,流程较重(回执、双发现通道、重评),对低风险小改动的成本收益比存疑,且部分价值依赖 cmux 专有原语,扣分。

6证据核验4 / 10 · 2.0/5

提供了 review-receipt.schema. 作为可审计的结构化证据框架,证据分类与 PROVEN/DERIVED 等认识论标签设计严谨;但仓库未见针对该技能关键路径的 CI 测试或第三方执行证据,多条引用文件未提供,无法独立复现其结论,扣至静态上限以下。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年10月10日 审查版本 3dd1fe78859f 评估证据[1][2][3][4][5][6][7][8][9][10][11]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

使用这个技能需要花钱吗?
技能文件本身免费随 cmux 仓库分发;README 说明 cmux 应用免费开源。但仓库许可证标注为 NOASSERTION,代码主体为 GPL-3.0-or-later,服务器端组件为 Business Source License 1.1,商用前应确认许可范围。
它会自己改我的代码吗?
审查阶段保持只读;只有在修复获得授权后才会修复并推送,且修复后必须重跑原始判别测试并(对非平凡修复)获取全新的子代理复审。
测试全绿就说明改动没问题吗?
不是。技能明确规定:绿色测试只有在真正执行了所断言的失败时才算数,优先采用修复前红、修复后绿的证据。
在 Claude Code 之外还能用吗?
SKILL.md 只是带标准 YAML frontmatter 的 Markdown 指令,原则上可移植到其他 Agent Skills 宿主;但其中“使用当前运行时的子代理”等表述依赖于宿主支持子代理机制,可能需要少量适配。

同仓库的其他 Skills

均来自 manaflow-ai/cmux

开发与工程

cmux 架构规范技能

在向 cmux 添加或大幅改写 Swift 文件、包、协调器、服务或公共 API 之前,先加载这套包架构、分层、依赖倒置与 Swift 6 并发规则,避免违反项目约定。

★ 28k FS 63 推荐 1 天前
开发与工程

cmux Ghostty 子模块工作流技能

为 cmux 贡献者提供 Ghostty 子模块与 GhosttyKit.xcframework 的标准化构建、推送与指针更新流程,避免子模块指针悬空导致的拉取失败。

★ 28k FS 54 谨慎使用 1 天前
开发与工程

cmux 测试技能

为 cmux 仓库选择合适的本地/CI 验证方式,添加有行为依据的测试,并确保 Swift 测试文件在 Xcode 工程中正确接线。

★ 28k FS 60 推荐 1 天前
开发与工程

cmux-capture:cmux 窗口截图与录制

用一条 CLI 命令截图或录制 cmux 窗口,为 PR、bug 报告或视觉验证提供真实证据,且无需任何屏幕录制权限。

★ 28k FS 55 谨慎使用 1 天前
开发与工程

cmux 开发工作流技能

为 cmux 贡献者提供原生构建、带标签开发包、Xcode 工程规范化与侧边栏扩展的标准化工作流,避免破坏正在运行的 cmux 会话。

★ 28k FS 53 谨慎使用 1 天前
开发与工程

cmux 发布助手

为 cmux 仓库维护者整理发版全流程:版本号递增、变更日志汇总、预发布守卫、打标签与产物校验,减少手工遗漏。

★ 28k FS 53 谨慎使用 1 天前
开发与工程

cmux 测试二分定位(cmux-test-bisect)

当 Swift 包测试套件在 main 上持续变红时,该技能在 CI 上对历史提交做二分,逐个测试找出是哪次提交、哪种原因导致失败。

★ 28k FS 51 谨慎使用 1 天前
开发与工程

cmux 工作区操作技能

让 AI 代理安全地在调用它的 cmux 工作区内工作,避免误触用户正在查看的其他工作区或窗口。

★ 28k FS 64 推荐 1 天前
开发与工程

cmux-browser:cmux 内置浏览器自动化技能

在不抢夺焦点的前提下,通过 cmux CLI 打开网页、探查浏览器表面、等待页面状态并提取数据,专为并行开发场景设计。

★ 28k FS 60 推荐 1 天前
开发与工程

cmux 键盘快捷键定制

把你的按键习惯变成 cmux 的快捷键绑定:提供向导、模板与一键应用,避免误绑和冲突。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux 设置管理技能(cmux-settings)

安全查看、修改和回滚 cmux 终端的 cmux. 配置,改完即存即生效,无需重启应用。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux Socket 策略规范技能

为 cmux 的 socket/CLI 命令开发提供线程调度与焦点行为规范,避免高遥测负载卡死主线程、避免自动化命令抢占用户焦点。

★ 28k FS 58 推荐 1 天前
自动化与运维

cmux Cloud 虚拟机技能

让 AI 代理通过 cmux CLI 操作云端虚拟机:在持久化的远程终端上运行长时命令和编码代理,并在完成后向用户展示结果工作区。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux 调试技能

为 cmux(基于 Ghostty 的 macOS 终端)开发者提供调试日志、Debug 菜单、运行时陷阱和性能敏感路径的规范知识,避免在打字延迟敏感代码中引入卡顿。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux 本地化规范与审计技能

在修改 cmux 任何用户可见文案时,强制执行本地化规则并跑完一条可核验的翻译审计流程,杜绝硬编码英文串。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux 自定义技能

针对 cmux 终端的配置技能:安全地编辑 cmux.、Dock 配置与 Ghostty 偏好,定制动作、布局、快捷键和通知,而不破坏现有配置。

★ 28k FS 55 谨慎使用 1 天前
效率与协作

cmux Markdown 查看器

把 .md 文件在 cmux 终端旁的格式化面板中打开,文件一变就自动重渲染,让计划、文档和笔记始终可见。

★ 28k FS 52 谨慎使用 1 天前
开发与工程

cmux 后端开发规则技能

为 cmux 仓库的后端 TypeScript 与 Cloud VM 开发提供一致编码规则,确保 Effect 边界、Postgres 迁移与密钥管理不出错。

★ 28k FS 51 谨慎使用 1 天前
开发与工程

cmux 诊断

为 cmux 用户收集安全、只读的诊断信息,快速定位钩子、通知、会话恢复和 CLI 控制不工作的问题。

★ 28k FS 51 谨慎使用 1 天前
开发与工程

cmux 计费运维技能

为 cmux 项目的 Stripe 计费、定价、订阅、Webhook 与 Pro 权益开发提供一份可直接执行的架构地图与运维手册。

★ 28k FS 50 谨慎使用 1 天前

相关 Skills