Agent skill
i18n-checker
全量掃描硬編碼中文字串並生成 i18n 修正建議。檢測所有層(Model/Service/Domain/UI)中文硬編碼,生成 ARB 鍵值建議,支援批量替換工作流程。Use for: (1) 檢查專案全部硬編碼中文(不只 UI 層), (2) 進行大規模 i18n 修復, (3) 生成 ARB 鍵值建議, (4) i18n 技術債務評估
Install this agent skill to your Project
npx add-skill https://github.com/tarrragon/claude/tree/main/skills/i18n-checker
SKILL.md
i18n Checker
深度掃描專案中所有硬編碼中文字串,生成 i18n 修正建議。
基本使用
快速檢查
uv run scripts/i18n_hardcode_checker.py
輸出格式
| 選項 | 說明 | 範例 |
|---|---|---|
| (無選項) | 摘要統計 | 總計: 11918, lib/: 1966, test/: 9952 |
--report |
Markdown 詳細報告 | uv run scripts/i18n_hardcode_checker.py --report > docs/i18n-report.md |
--arb |
JSON ARB 鍵值建議 | uv run scripts/i18n_hardcode_checker.py --arb |
--json |
結構化 JSON 輸出 | uv run scripts/i18n_hardcode_checker.py --json |
詳細參數和工作流程見 references/mixed-processing-guide.md 和 references/scanner-rules.md。
典型工作流程
# 1. 執行檢查,生成詳細報告
uv run scripts/i18n_hardcode_checker.py --report > docs/i18n-report.md
# 2. 根據報告分類硬編碼(見 references/mixed-processing-guide.md)
# 3. 生成 ARB 鍵值建議
uv run scripts/i18n_hardcode_checker.py --arb > arb_suggestions.json
# 4. 手動審核 + 添加到 ARB + flutter gen-l10n
# 5. 使用批量替換腳本
uv run scripts/i18n_batch_replace.py --target lib/presentation --apply
# 6. 再次驗證
uv run scripts/i18n_hardcode_checker.py
詳細的複雜度分級判斷、等級決策、Ticket 派生策略見 references/mixed-processing-guide.md。
與其他工具的差異
與 style-guardian 的互補關係:
| 工具 | 檢查範圍 | 用途 |
|---|---|---|
| style-guardian | UI 層(Text、AppBar、labelText) | 快速日常檢查 |
| i18n-checker | 全層(Model/Service/Domain/UI) | 深度技術債務清理 |
參考資源
詳細的複雜度分級、工作流程、Ticket 派生策略:
references/mixed-processing-guide.md- 等級 A/B/C/D 判斷標準和實戰案例references/scanner-rules.md- 掃描規則和鍵名建議邏輯
相關方法論
- 分層 i18n 管理:
.claude/methodologies/business-layer-i18n-management-methodology.md - Style Guardian:
.claude/skills/style-guardian/
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
skill-design-guide
Use this skill when creating a new skill, updating an existing skill's YAML frontmatter, or reviewing skill quality. Provides the official Anthropic skill specification, frontmatter rules, description writing best practices, progressive disclosure architecture, and common pitfalls to avoid. Triggers include: creating skills, skill review, frontmatter validation, SKILL.md writing.
test-async-guardian
Flutter/Dart 測試異步資源管理守護者。用於:(1) 診斷測試卡住問題,(2) 審查測試程式碼中的異步資源清理,(3) 提供 tearDown 最佳實踐,(4) 掃描潛在的資源洩漏風險。觸發場景:測試卡住、撰寫新測試、Code Review 測試程式碼、執行 flutter test 前自動掃描。
agent-team
Agent Teams 協作派發指南。Use when: (1) Agent A 的發現會改變 Agent B 正在進行的工作, (2) 用戶要求使用 team/swarm, (3) 多代理人需即時協商共用介面或 API 契約。涵蓋 team 建立、Ticket-Task 橋接、teammate 入職、生命週期管理。
tdd
TDD 全流程指導工具。Use for: (1) 開始新功能的 TDD 流程(Phase 0-4), (2) 推進到下一個 TDD 階段, (3) Phase 1 SOLID 原則驅動功能拆分分析, (4) 查看當前 TDD 進度和階段狀態, (5) 評估是否需要 Phase 4 重構以及 3b 拆分評估。Use when: 開始新功能開發、進入任何 TDD Phase、需要 SOLID 拆分指導、需要確認當前所在 TDD 階段、需要做 Phase 4 豁免判斷時。
branch-worktree-guardian
Branch Worktree Guardian - Git 分支和 Worktree 管理工具。Use for: (1) 新開發需求時建立隔離分支, (2) 使用 worktree 機制避免分支衝突, (3) 驗證當前工作分支正確性, (4) 預防在錯誤分支上開發
design-decision-framework
多方案評估決策框架。用於面臨 3+ 技術方案時的結構化評估、架構決策時的系統化分析,防止衝動決策和技術債務累積。Use for: 技術方案選擇、重大架構決策、高風險技術選型
Didn't find tool you were looking for?