这个 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,但最终翻译质量依赖贡献者,自动化检查无法保证译文正确性。
- 本评估为纯静态审查,未执行任何脚本或命令。
- 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?
该技能本身是纯文档型工作流,不要求额外权限、无外部副作用、不接触敏感数据;翻译包写入 git 元数据且默认在工作区外,数据流向有说明。扣分点:技能指示运行 ./scripts/localize-changes 与 localization_catalog.py,但这些脚本未在证据中出现,其行为、依赖与回滚路径无法静态核验;发布方未经注册表验证(不额外扣分但归因不完整)。
指令自洽、术语一致,异常路径描述较好(歧义目录归属、defaultValue 冲突、不支持字面量等会停止并给出人类关注项,失败反馈可读)。扣分点:核心依赖脚本不在证据内,快乐路径只是'合理'而非可复现;静态审查上限为10,未达到需要奖励更高分数的第三方执行证据。
触发条件明确('任何用户面向文本变更时使用'),范围枚举详尽(UI、菜单、快捷键、schema、docs、web 消息等),非适用边界(defaultValue、省略记录、identityLocales)有明确定义;支持 zh-Hans/zh-Hant,对中文用户友好。扣分点:无明确的环境前置说明(如 python3、rg、git 版本要求),触发依赖描述语义,未覆盖误触发防护。
文档分层良好:SKILL.md 硬规则 + references/audit-workflow.md 细化 + 关联技能链接,外加 agents/openai.yaml 元数据;省略与复数记录文件化,可维护性思路清晰。扣分点:技能无版本号或变更日志;仓库许可证为 NOASSERTION(实际为 GPL-3.0-or-later + BUSL 双重许可,复杂但技能文件未自述许可与维护责任)。
审计清单具体可执行(枚举表面、跨语言比对、rg 搜索裸英文、最终交接声明),相比人工审查有明确边际价值。扣分点:输出仍依赖提交者翻译质量,脚本未在证据内,无法验证最终产物直接可用;静态上限为7。
有可审计的原始材料(规则、检查清单、引用文件),跨技能链接可追溯。扣分点:关键声明('check 为最终权威验证器')无法独立复现,脚本与测试不在证据中;仓库虽有 CI 工作流,但未见覆盖该本地化流程的执行证据,静态上限为5。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →