swiftui-localization-skill
SwiftUI/iOS/macOS项目的工程化本地化处理工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:swiftui-localization-skill。 它的用途是:SwiftUI/iOS/macOS项目的工程化本地化处理工具 完整的 Skill 内容见:https://321skill.com/skills/swiftui-localization-skill/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'/swiftui-localize scan lang=zh',它会以中文输出对你的SwiftUI项目的本地化系统分析报告,指出硬编码字符串、未使用的本地化键等问题。
对AI说:'/swiftui-localize apply base=en target=zh-Hans',它会基于英文源文件,自动将你的应用本地化为简体中文,并重构代码中对应的字符串引用。
介绍
这个Skill旨在解决SwiftUI项目本地化过程中的工程化难题。传统的本地化工作常停留在文本翻译层面,容易导致键值管理混乱、硬编码字符串难以发现、翻译质量参差不齐等问题,给多语言项目的长期维护带来挑战。
它提供三种核心工作模式:扫描分析、应用更改和代码质量检查。用户只需在Claude Code等AI开发环境中输入简单指令,即可自动分析项目中的本地化资源,识别未使用的键、动态键风险,并支持基于源语言进行多目标语言的翻译和代码重构。
该Skill特别适合负责SwiftUI或Apple平台应用开发的前端/全栈开发者、项目经理以及需要确保应用国际化和本地化质量的团队成员。对于需要将应用推向全球市场或维护多语言版本的团队来说,它能显著提升本地化流程的规范性和效率。
使用建议:首次使用时建议先运行scan模式进行全面分析,了解项目现状。在apply模式进行批量修改前,务必确保代码已纳入版本控制。对于CI/CD流程,可集成lint模式作为质量关卡,确保新的代码提交符合本地化规范。
核心特点
与单纯的翻译工具不同,它将本地化视为一个完整的、可审查、可演进、可集成到CI/CD的工程系统,提供从代码分析、键值管理到质量检查的全链路支持,并深度集成SwiftUI框架特性,能智能识别硬编码的UI字符串。
注意事项
主要专注于SwiftUI及Apple生态系统(iOS/macOS)的本地化,不适用于Flutter、React Native等其他跨平台框架或Web前端项目。
常见问题
这个Skill能自动翻译我的App吗?
可以。在`apply`模式下,它能基于你指定的源语言(如`base=en`)自动翻译到目标语言(如`target=zh-Hans,ja`),并遵循工程最佳实践更新代码和资源文件。
它会修改我的源代码吗?
仅在`apply`模式下会修改源代码(如替换硬编码字符串为本地化引用)和资源文件。`scan`和`lint`模式是只读分析,不会做任何更改。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/swiftui-localization-skill/raw/index.md 读取 swiftui-localization-skill 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/swiftui-localization-skill/raw/index.md(查看排版版本)