开发与工程

cmux 本地化规范与审计技能

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

56/ 100
谨慎使用

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

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 28k
最近更新
1 天前
License
NOASSERTION
localizationi18nmacosswiftui
+4xcstringstranslation-auditpluralizationstring-catalogs

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

cmux-localization 是 manaflow-ai/cmux 仓库内的一个 Agent Skill,位于 skills/cmux-localization/SKILL.md,专门约束 cmux macOS 应用中所有面向用户的字符串改动。它规定每条 UI 文案都必须走 String(localized:) 与 .xcstrings 目录,覆盖 en、de、fr、ar、es、zh-Hant、zh-Hans、ko、ja 九种 macOS 语言(英文和日文永远必需),并为复数、省略记录、identity-locale 例外等边界情况立下硬规则。改动文案后需运行 ./scripts/localize-changes 生成翻译数据包,最后以 python3 scripts/localization_catalog.py check 作为权威校验。该技能只适用于 cmux 仓库本身,不是通用 i18n 工具。

  • 在新增或修改任何用户可见文案(UI、设置行、菜单、快捷键、schema/配置文本、文档、命令帮助、弹窗、tooltip、web 消息)时,触发统一的本地化流程
  • 运行 ./scripts/localize-changes,对比工作区与主线基线,发现变更的 Swift 本地化键和英文 web 消息,生成机器可读的翻译数据包
  • 要求贡献者填写简单翻译的 value 或复数/变体的 localization,再次运行同一命令,由 scripts/localization_catalog.py merge 导入
  • 用 scripts/localization_catalog.py check 做最终校验,保证目录文件全部通过占位符、复数、双向文本、省略、identity-translation 等检查
  • 通过 rg 扫描改动的 Swift/TS/TSX/docs 文件,拦截新引入的裸英文串
  • 把刻意不变的字符串登记进 scripts/localization-allowed-omissions.,复数字符串登记进 scripts/localization-plurals.
适合
  • 向 cmux 添加新功能(如新设置行或新菜单项)的贡献者,需要为九种 macOS 语言补齐翻译条目并通过目录校验
  • 修改英文文案但不想让已批准的其他语言翻译被重新标记待审的贡献者,可在数据包中填入相同文本让确认被记住
  • 新增带数字的提示信息(如复数形式)的作者,需要按 scripts/localization-plurals. 记录并覆盖阿拉伯语 zero/one/two/few/many/other 等类别
  • 希望为某个共享拼写的词(如法语 %d machines)申请 identityLocales 例外的翻译者
  • 需要处理本地化冲突(如 Swift 调用点 defaultValue 不一致、不支持的 Swift 字面量形式)并得到具体人工处理项的开发者
不适合
  • 只想给任意 macOS/iOS 项目套用通用本地化流程的团队——技能中的脚本、键名和省略记录全部绑定 cmux 仓库结构
  • 不在 cmux 仓库内工作、没有检出该 macOS 项目及其 Python 校验脚本的环境

如何安装这个 Skill?

使用前请注意
  • 技能依赖的 scripts/localize-changes 与 localization_catalog.py 未包含在审查证据中,实际运行前请先阅读脚本源码确认其行为与依赖。
  • 仓库许可证为 GPL-3.0-or-later 与 BUSL-1.1 双重许可(web/ 目录商用受限),在企业内使用该技能及其产出时需确认许可合规。
  • 发布方未经 FollowSkills 注册表验证,身份归属不明确。
  • 支持 zh-Hans/zh-Hant,但最终翻译质量依赖贡献者,自动化检查无法保证译文正确性。
  • 本评估为纯静态审查,未执行任何脚本或命令。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • cmux repository checkout (Swift/macOS project)
  • Python 3 (scripts/localization_catalog.py)
  • ripgrep (rg)

源材料未给出跨宿主的安装命令。该技能是 manaflow-ai/cmux 仓库自带的 skills 集合中的一员(共 25 个),位于 skills/cmux-localization/,随仓库检出即得;如何将其装载到 Claude Code 等具体宿主,README 与 SKILL.md 均未说明。

git clone https://github.com/manaflow-ai/cmux
cd cmux/skills/cmux-localization

如何使用这个 Skill?

试试这样说

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

  • 我给设置页加了一行新的开关描述,帮我按 cmux 本地化规则补齐九种语言的目录条目并跑审计
  • 这条英文提示改成带数量的复数形式,请登记到 localization-plurals. 并生成阿拉伯语和法语的完整复数翻译
  • 把「Last synced」改成「Synced」,但德语翻译仍然正确,帮我在翻译数据包里确认保留以免再次标记待审
  • 检查我这个 PR 改动的所有 UI 面是否有新引入的裸英文字符串,并给出最终审计交接说明

技能描述中声明:只要任务涉及改用户可见文案就应使用。流程是先跑 ./scripts/localize-changes,解决数据包中的每一行翻译或人工处理项,再按审计清单走完五个步骤(枚举改动面、核对九语言条目、解析本地化文件比对键、rg 扫描裸英文、在交接说明中声明审计内容)。可选参数 --base <ref> 指定其他对比基线,--work-file <path> 让翻译辅助工具可见数据包(默认数据包留在工作区之外)。

./scripts/localize-changes
./scripts/localize-changes --base <ref>
./scripts/localize-changes --work-file <path>
python3 scripts/localization_catalog.py merge
python3 scripts/localization_catalog.py check

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

优点
  • 把本地化从口头约定变成可执行的强制流程,含权威校验脚本,避免裸英文串和漏翻译入仓
  • 对复数、省略记录、identity-locale、占位符、双向文本等真实本地化坑都有明确规则
  • 模糊或无法自动处理的情况会以具体人工处理项停止,而不是静默出错
  • 随附 references/audit-workflow.md 详细参考和相邻快捷键技能的交叉链接
局限
  • 只适用于 cmux 仓库本身,脚本、键结构和省略清单不可直接复用到其他项目
  • 要求每个功能 PR 携带全部九种 macOS 语言的翻译,对单人或小改动是较重的负担
  • 仓库 License 标注为 NOASSERTION(README 显示 GPL-3.0-or-later 与服务端 BUSL-1.1 混合),复用代码前需自行核实
  • 源材料未提供独立的测试证据或该技能在其他 Agent Skills 宿主上的验证记录

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

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

Skill FS 评分 Star 数 最近更新 License
cmux 本地化规范与审计技能 本页 56 · 谨慎使用 ★ 28k 1 天前 NOASSERTION
Locale UI Patterns —— OpenChamber 界面文案国际化规范 61 · 推荐 ★ 11k 3 天前 MIT
i18n 国际化工作流 53 · 谨慎使用 ★ 33k 1 个月前 Apache-2.0
Chops 开发环境配置技能 57 · 谨慎使用 ★ 1.9k 1 个月前 NOASSERTION
cmux 调试技能 56 · 谨慎使用 ★ 28k 1 天前 NOASSERTION

README 将 cmux 与 tmux 对比,但那是应用层面的对比,与这个本地化技能无直接对应关系;源材料中没有为该技能命名的直接竞品。

FollowSkills 如何评估这个 Skill?

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

该技能本身是纯文档型工作流,不要求额外权限、无外部副作用、不接触敏感数据;翻译包写入 git 元数据且默认在工作区外,数据流向有说明。扣分点:技能指示运行 ./scripts/localize-changes 与 localization_catalog.py,但这些脚本未在证据中出现,其行为、依赖与回滚路径无法静态核验;发布方未经注册表验证(不额外扣分但归因不完整)。

2可靠稳定8 / 20 · 2.0/5

指令自洽、术语一致,异常路径描述较好(歧义目录归属、defaultValue 冲突、不支持字面量等会停止并给出人类关注项,失败反馈可读)。扣分点:核心依赖脚本不在证据内,快乐路径只是'合理'而非可复现;静态审查上限为10,未达到需要奖励更高分数的第三方执行证据。

3适用触发11 / 15 · 3.7/5

触发条件明确('任何用户面向文本变更时使用'),范围枚举详尽(UI、菜单、快捷键、schema、docs、web 消息等),非适用边界(defaultValue、省略记录、identityLocales)有明确定义;支持 zh-Hans/zh-Hant,对中文用户友好。扣分点:无明确的环境前置说明(如 python3、rg、git 版本要求),触发依赖描述语义,未覆盖误触发防护。

4规范维护10 / 15 · 3.3/5

文档分层良好:SKILL.md 硬规则 + references/audit-workflow.md 细化 + 关联技能链接,外加 agents/openai.yaml 元数据;省略与复数记录文件化,可维护性思路清晰。扣分点:技能无版本号或变更日志;仓库许可证为 NOASSERTION(实际为 GPL-3.0-or-later + BUSL 双重许可,复杂但技能文件未自述许可与维护责任)。

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

审计清单具体可执行(枚举表面、跨语言比对、rg 搜索裸英文、最终交接声明),相比人工审查有明确边际价值。扣分点:输出仍依赖提交者翻译质量,脚本未在证据内,无法验证最终产物直接可用;静态上限为7。

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

有可审计的原始材料(规则、检查清单、引用文件),跨技能链接可追溯。扣分点:关键声明('check 为最终权威验证器')无法独立复现,脚本与测试不在证据中;仓库虽有 CI 工作流,但未见覆盖该本地化流程的执行证据,静态上限为5。

1 2 3 4 5 6

点击维度查看打分理由

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

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

查看完整评分方法 →

常见问题

这个技能能用于我自己的项目吗?
规则本身(如禁止裸字符串、九语言要求)可作为参考借鉴,但 localize-changes、localization_catalog.py 及省略/复数 JSON 清单都绑定 cmux 仓库结构,不能开箱即用。
哪些语言是必须提交的?
新键必须带全部九种 macOS 语言(en、de、fr、ar、es、zh-Hant、zh-Hans、ko、ja),其中 en 和 ja 永远必需,即便有省略记录也不例外。
如果自动流程处理不了怎么办?
遇到目录归属模糊、Swift 调用点 defaultValue 不一致、不支持的 Swift 字面量、无效的生成翻译等情况,命令会以具体的人工处理项停止,不会静默通过。
改英文但不想重审已有翻译怎么办?
在数据包的 value 中填入与现有翻译相同的文本,数据包会记住确认,后续运行不再标记待审。

同仓库的其他 Skills

均来自 manaflow-ai/cmux

开发与工程

cmux 调试技能

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

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

cmux 自定义侧边栏

从一句自然语言需求生成可热重载的 cmux 自定义侧边栏,无需 Xcode、无需构建、无需签名。

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

cmux 工作区操作技能

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

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

cmux 架构规范技能

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

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

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

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

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

cmux 测试技能

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

★ 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-capture:cmux 窗口截图与录制

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

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

cmux 自定义技能

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

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

cmux Ghostty 子模块工作流技能

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

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

cmux 开发工作流技能

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

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

cmux 发布助手

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

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

cmux Markdown 查看器

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

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

cmux 诊断

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

★ 28k FS 51 谨慎使用 1 天前
自动化与运维

cmux Computer Use 技能

让 cmux 中的 AI 编码代理通过本地计算机使用引擎操作真实 macOS 应用,前提是用户明确提出请求。

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

cmux 共享行为规则

为 cmux 多入口行为制定统一的实现与验证规则,避免某个入口改了、其他入口仍是旧逻辑或旧 bug。

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

cmux 核心控制技能

通过 cmux CLI 确定性地控制多窗格终端布局——创建工作区、分割面板、移动与聚焦表面、触发提醒,专为 AI 编码代理的自动化而设计。

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

相关 Skills