Adonis0123/adonis-skills / .agents/skills/lingui-workflow
lingui-workflow
VerifiedChoose and troubleshoot extract, translation-check, compile, and catalog-manifest commands in an existing Lingui project. Use for daily catalog maintenance and command semantics, not initial setup, plain text translation, or choosing an i18n library.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.4 KB |
| references/i18n-commands.md | markdown | 9.5 KB |
| references/maintenance-playbook.md | markdown | 2.7 KB |
| references/workflow-daily.md | markdown | 3.2 KB |
references/workflow-daily.md
View on GitHub# Lingui 日常工作流与发布前检查
本文件使用已退役的 `lingui-next-init` 历史模板命令举例,只服务既有项目维护。先核对目标项目已有脚本,只读取与当前场景有关的部分;实际命令优先,不调用初始化 skill 或同步其模板。
## 场景一:新增或修改源码文案
执行顺序:
```bash
pnpm --filter @your/web run i18n:extract
pnpm --filter @your/web run i18n:translate
pnpm --filter @your/web run i18n:compile
```
目标:
1. `extract` 把最新文案落到 `po`。
2. `translate` 明确缺失项。
3. `compile` 生成 `mjs` 并刷新 manifest。
## 场景二:只更新翻译(未改源码)
建议顺序:
```bash
pnpm --filter @your/web run i18n:translate
pnpm --filter @your/web run i18n:compile
```
说明:
1. 不强制再跑 extract,但如果怀疑词条漂移可补跑 extract。
2. `compile` 是把翻译变成运行时可加载产物的关键步骤。
## 场景三:构建前检查
```bash
pnpm --filter @your/web run i18n:compile
pnpm --filter @your/web run typecheck
```
如果本次构建已包含 compile,就复用该结果,不在同内容上先重复编译。采用此历史脚本实现的 compile 已包含 manifest;以实际入口为准。
## 场景四:快速占位回填
```bash
pnpm --filter @your/web run i18n:translate -- --fill-source
pnpm --filter @your/web run i18n:compile
```
仅在用户明确接受源语言占位时使用;回填不是实际翻译完成。
## 场景五:出现 locale 未激活运行时错误
报错示例:
`Lingui: Attempted to call a translation function without setting a locale`
建议顺序:
1. 先检查 `initLingui(locale)` 是否包含 `i18n.activate(locale)`。
2. 再检查服务端 `layout.tsx` 和服务端 `page.tsx` 是否都调用了 `initPageLingui(params)`(或等价初始化)。
3. 如果报错发生在共享服务端组件,优先改为 `useLingui`/`Trans`;避免依赖全局 `@lingui/core/macro` `t` 的调用时序。
4. 最后执行 `i18n:compile`,确认 `catalog-manifest.ts` 已覆盖对应 entry。
## 场景六:CI / 发布前翻译完整性检查
```bash
pnpm --filter @your/web run i18n:check
```
说明:
1. `i18n:check` 等价于 `i18n:translate -- --strict`,发现任何目标语言 `msgstr` 为空即非零退出。
2. 适用于 CI 管线或发布前门禁,确保所有文案均已翻译。
3. 只读操作,不会修改任何 `po` 文件。
推荐在 CI 中组合使用:
```bash
pnpm --filter @your/web run i18n:extract
pnpm --filter @your/web run i18n:check
pnpm --filter @your/web run i18n:compile
```
## 按失败阶段选择检查
从实际失败阶段开始,必要时向前核查输入,不要求每次跑完整链路。
1. `extract` 是否成功产出/更新对应 `po`。
2. `po` 中目标语言 `msgstr` 是否为空。
3. `compile` 是否成功生成 `src/locales/**/*.mjs`。
4. `manifest` 是否已更新并包含对应 entry + locale loader。
5. 服务端 locale 初始化是否覆盖 layout + page 两层。
## 发布前最小验收
1. 新增文案已进入目标 `po`。
2. `i18n:check` 通过(无缺失翻译),或 `translate` 结果中缺失项可解释。
3. `compile` 后运行时可加载目标 locale。
4. 默认语言和非默认语言路由下文案一致可用。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |