Agent Skills
› manaflow-ai/cmux
› cmux-localization
cmux-localization
GitHub规范 cmux UI 字符串本地化流程,强制所有用户可见文本必须通过键值对进行国际化。要求修改涉及 UI、文档或配置时执行本地化审计,确保关键文件与多语言目录同步更新。
触发场景
修改 SwiftUI 或 AppKit 界面文本
更新 Web 消息目录或文档内容
变更设置项、菜单或工具提示文案
安装
npx skills add manaflow-ai/cmux --skill cmux-localization -g -y
SKILL.md
Frontmatter
{
"name": "cmux-localization",
"description": "Localization rules and audit workflow for cmux UI strings, settings rows, menus, shortcuts, schema\/config text, docs, command\/help text, alerts, tooltips, and web messages. Use whenever changing user-facing text."
}
cmux Localization
Use this skill for any user-facing string change.
Hard rules
- Every user-facing string is localized. Never a bare string literal in SwiftUI
Text(),Button(), alert titles, tooltips, menus, or dialogs. - Swift/AppKit/SwiftUI:
String(localized: "key.name", defaultValue: "English text"), with keys inResources/Localizable.xcstrings. Feature PRs add the key and English source value; translations for every supported language are completed in the release PR. defaultValue, English fallback text, schema descriptions, and copied English strings do not count as localization. They are acceptable in feature PRs only when the release workflow tracks the key for translation.- Localized web/docs content updates every supported message catalog (currently
web/messages/en.jsonandweb/messages/ja.json) plus any localized data structures carrying inline translations. - A localization audit is required for every user-facing change.
Audit checklist
Before finishing a task that changes UI, Settings rows, menus, shortcut metadata, schema/config text, docs, command/help text, alerts, or tooltips:
- Enumerate the changed user-facing surfaces.
- Verify each surface has a catalog key in the feature PR. Verify translated values for every supported locale in the release PR.
- Parse the touched localization files and compare changed message keys across locales.
- Run
rgover changed Swift/TS/TSX/docs files for newly introduced bare English. - State in the final handoff what audit was performed, or explicitly say what could not be verified.
Detailed reference
- references/audit-workflow.md: what counts as user-facing, search patterns, and handoff wording.
New keyboard shortcuts also need docs and Settings entries; see ../cmux-keyboard-shortcuts/SKILL.md.
版本历史
-
c05e1b4
当前 2026-09-09 15:45
优化了 defaultValue 的合规性说明,明确其在特性 PR 中作为占位符的接受条件;简化了版本支持描述。
- cef69a7 2026-08-20 08:16


