glotctl

专为 Next.js 项目设计的 i18n 代码质量检查 CLI 工具。

代码质量 前端开发全栈开发 做多语言适配检查代码质量审查AI生成代码 claudecursor通用 更新于 2026-07-26

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:glotctl。
它的用途是:专为 Next.js 项目设计的 i18n 代码质量检查 CLI 工具。
完整的 Skill 内容见:https://321skill.com/skills/glotctl/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我检查一下这个 Next.js 项目的国际化翻译有没有问题。”,它会调用集成的 Glot MCP 工具,运行 `glot check` 命令,扫描你的代码库,并返回一份详细的报告,指出所有硬编码的文本、缺失的翻译键等具体问题及位置。

介绍

Glot 是一款专注于解决 Next.js 项目国际化(i18n)问题的命令行工具。它深度集成 next-intl 库,旨在帮助开发者发现和修复代码中潜在的多语言适配缺陷。

通过简单的 npx glot check 命令,Glot 可以快速扫描项目,检测出硬编码文本、缺失的翻译键、冗余的孤儿键以及未翻译的重复值等多种问题,并提供清晰的错误定位和修复建议。

该工具非常适合使用 Next.js 和 next-intl 进行国际化开发的前端、全栈开发者,以及需要确保多语言代码质量的团队。它尤其适用于在 CI/CD 流程中自动化检查,或在大型项目中逐步清理遗留的 i18n 问题。

建议在项目开发早期引入 Glot,以建立良好的国际化规范。对于已有大量硬编码文本的存量项目,可以先使用 baseline 命令生成基线报告,再逐步修复,避免一次性引入过多错误告警。

核心特点

与通用的代码检查工具(如 ESLint)不同,Glot 专门针对 Next.js 项目的 i18n 场景,能精准识别 next-intl 使用中的特定问题,如硬编码文本检测和跨语言文件键值对比。此外,它原生提供 MCP 服务器,可直接集成到 Claude、Cursor 等 AI 编码助手中,实现智能修复建议。

注意事项

仅支持使用 next-intl 库的 Next.js 项目,不适用于其他框架或国际化方案。

常见问题

Glot 能检查哪些类型的 i18n 问题?

Glot 主要检查四类问题:硬编码文本、缺失的翻译键、非主语言文件中的孤儿键,以及非主语言中与主语言完全相同的未翻译值。

如何在现有项目中快速引入 Glot 而不被大量历史问题淹没?

可以使用 `npx glot baseline` 命令生成当前问题的基线,它会为现有问题添加忽略注释,从而只关注新引入的问题,便于逐步修复。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/glotctl/raw/index.md 读取 glotctl 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。