Prompt file imported from zls3434/quick-input (
.windsurf/workflows/localize.md). Copyright stays with the author.
/localize — 本地化扫描、提取与验证,扫描源码中的硬编码字符串,提取到 i18n 资源文件,验证完整性并生成本地化检查报告。
触发方式
在 Cascade 对话框中输入 /localize 触发此工作流。
工作流内容
localize — 本地化扫描与验证
技能目的
对项目源码进行本地化扫描,发现硬编码字符串并提取到 i18n 资源文件中,验证多语言资源的完整性与一致性,生成本地化检查报告,确保项目可支持目标语言。
参数说明
[语言代码]:目标语言代码,例如zh-CN、en-US、ja-JP,用于确定资源文件命名与翻译方向。
分阶段工作流
阶段 1:加载上下文与确认范围
- 输入:
[语言代码]参数 - 处理:
- 使用 Read 读取
docs/technical-preferences.md确认前端框架与 i18n 方案 - 使用 Glob 扫描现有 i18n 资源文件(
locales/、i18n/、*.json、*.yaml) - 使用 Glob 查找源码目录结构确定扫描范围
- 通过 AskUserQuestion 与用户确认扫描目录、排除规则与翻译策略
- 使用 Read 读取
- 输出:本地化上下文 + 扫描计划
阶段 2:扫描源码中的硬编码字符串
- 输入:扫描计划
- 处理:
- 使用 Grep 在源码中搜索常见的硬编码字符串模式(中文文本、英文 UI 文本、模板字符串中的字面量)
- 排除注释、测试数据与配置文件中的非 UI 字符串
- 使用 Read 抽样验证匹配结果的相关性
- 使用 Bash 执行 i18n 检测工具(如 i18next-parser)辅助扫描
- 输出:硬编码字符串清单
阶段 3:提取到 i18n 资源文件
- 输入:硬编码字符串清单
- 处理:
- 为每个字符串生成命名空间与键名
- 使用 Write 创建或更新目标语言资源文件
- 将源码中的硬编码字符串替换为 i18n 调用
- 保留原文作为翻译参考
- 输出:i18n 资源文件 + 更新后的源码
阶段 4:验证完整性
- 输入:i18n 资源文件 + 更新后源码
- 处理:
- 使用 Grep 检查是否仍有遗漏的硬编码字符串
- 使用 Read 对比各语言资源文件的键集,标记缺失或多余的键
- 使用 Bash 执行 i18n 校验脚本检查格式占位符一致性
- 验证动态插值变量在各语言中均存在
- 输出:完整性验证报告
阶段 5:生成本地化检查报告
- 输入:全部阶段产物
- 处理:
- 汇总扫描结果、提取统计与验证问题
- 按严重度排序缺失项与不一致项
- 通过 AskUserQuestion 确认报告内容与后续行动
- 使用 Write 写入报告至
docs/reports/localize-[语言代码].md
- 输出:本地化检查报告
协作协议引用
- 遵循
docs/examples/COLLABORATIVE-DESIGN-PRINCIPLE.md用户驱动协作协议 - 提取与替换代码前需向用户展示草稿并获取批准
- 参考 i18n-specialist Agent 的本地化最佳实践
- 使用 Bash 执行检测与校验脚本
推荐下一步
本地化完成后,使用 /content-audit 验证文档内容与实现的一致性。无障碍相关本地化使用 /accessibility-requirements 检查。发布前使用 /team-qa 验证多语言功能。
