Agent Skillsmanaflow-ai/cmux › cmux-localization

cmux-localization

GitHub

规范 cmux UI 字符串本地化流程,强制所有用户可见文本必须通过键值对进行国际化。要求修改涉及 UI、文档或配置时执行本地化审计,确保关键文件与多语言目录同步更新。

skills/cmux-localization/SKILL.md manaflow-ai/cmux

触发场景

修改 SwiftUI 或 AppKit 界面文本 更新 Web 消息目录或文档内容 变更设置项、菜单或工具提示文案

安装

npx skills add manaflow-ai/cmux --skill cmux-localization -g -y
更多选项

不安装直接使用

npx skills use manaflow-ai/cmux@cmux-localization

指定 Agent (Claude Code)

npx skills add manaflow-ai/cmux --skill cmux-localization -a claude-code -g -y

安装 repo 全部 skill

npx skills add manaflow-ai/cmux --all -g -y

预览 repo 内 skill

npx skills add manaflow-ai/cmux --list

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 in Resources/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.json and web/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:

  1. Enumerate the changed user-facing surfaces.
  2. Verify each surface has a catalog key in the feature PR. Verify translated values for every supported locale in the release PR.
  3. Parse the touched localization files and compare changed message keys across locales.
  4. Run rg over changed Swift/TS/TSX/docs files for newly introduced bare English.
  5. State in the final handoff what audit was performed, or explicitly say what could not be verified.

Detailed reference

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

同 Skill 集合

skills/cmux-architecture/SKILL.md
skills/cmux-backend/SKILL.md
skills/cmux-billing/SKILL.md
skills/cmux-browser/SKILL.md
skills/cmux-cua/SKILL.md
skills/cmux-custom-sidebar/SKILL.md
skills/cmux-customization/SKILL.md
skills/cmux-debugging/SKILL.md
skills/cmux-dev-workflow/SKILL.md
skills/cmux-diagnostics/SKILL.md
skills/cmux-ghostty/SKILL.md
skills/cmux-keyboard-shortcuts/SKILL.md
skills/cmux-markdown/SKILL.md
skills/cmux-release/SKILL.md
skills/cmux-settings/SKILL.md
skills/cmux-shared-behavior/SKILL.md
skills/cmux-socket-policy/SKILL.md
skills/cmux-testing/SKILL.md
skills/cmux-workspace/SKILL.md
skills/cmux/SKILL.md

元信息

文件数
0
版本
c05e1b4
Hash
f867e9bb
收录时间
2026-08-20 08:16

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-09-09 22:15
浙ICP备14020137号-1 $访客地图$