Communitygithub.com

PascaleBeier/hitkeep

HitKeep 是為人類和 AI 代理隱私優先的分析工具,可自架或部署於歐盟/美國的受管雲端區域。

hitkeep 是什麼?

此技能專用於管理 HitKeep 儀表板中的使用者面向文字和本地化格式。它使用 Transloco JSON 檔案管理 UI 文案,並透過@jsverse/transloco-locale 和瀏覽器 Intl API 處理區域感知的格式化。PrimeNG 元件標籤會自動與活動的 Transloco 語言同步。 技能明確定義了支援的語言 ID(en、de、es、fr、it、nl、pt)及其對應的格式化區域設定(例如 en→en-US,pt→pt-BR)。新增或更改語言時,必須確保 Transloco 設定、區域 JSON 檔案、格式化對應和產品文件完全一致。 技能提供清晰的翻譯工作流程,包括搜尋現有功能鍵、使用 TranslocoPipe 處理模板文字、在 TypeScript 中使用 TranslocoService,以及同時更新所有七個區域檔案。它強調語義鍵名命名和保持插值變數不變。對於日期、數字、百分比和持續時間,優先使用現有的區域服務或輔助函式,而非手動格式化。 翻譯品質標準要求翻譯產品 UI,而非逐詞翻譯,並針對德語、西班牙語、法語、義大利語、荷蘭語和葡萄牙語提供具體的語言正確性指導。翻譯後需執行 i18n 檢查指令碼(i18n:check)、同步指令碼(sync-i18n-locales.mjs)和格式化檢查(fmt:check),確保鍵結構一致且格式正確。對於依賴語言切換的 UI 行為,需新增或更新聚焦測試。此技能支援 Claude Code、Cursor、Codex 等 AI 代理工具。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add PascaleBeier/hitkeep

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

HitKeep i18n

當修改使用者可見的儀表板文字或 HitKeep 中的本地化格式時,請使用此技能。

HitKeep 的儀表板使用 Transloco JSON 檔案管理 UI 文案,並利用 @jsverse/transloco-locale 加上瀏覽器 Intl API 進行區域感知的格式化。PrimeNG 標籤會從活動的 Transloco 語言同步。

公開介面

儀表板翻譯檔案位於:

  • frontend/dashboard/public/i18n/en.json
  • frontend/dashboard/public/i18n/de.json
  • frontend/dashboard/public/i18n/es.json
  • frontend/dashboard/public/i18n/fr.json
  • frontend/dashboard/public/i18n/it.json
  • frontend/dashboard/public/i18n/nl.json
  • frontend/dashboard/public/i18n/pt.json

儀表板目前公開了這些語言 ID:

en, de, es, fr, it, nl, pt

格式化區域對應設定於 frontend/dashboard/src/app/app.config.ts 中:

en -> en-US
de -> de-DE
es -> es-ES
fr -> fr-FR
it -> it-IT
nl -> nl-NL
pt -> pt-BR

不要僅從 Angular 區域輔助函式推斷新的支援語言。僅在 Transloco 設定、區域 JSON 檔案、格式化對應和產品文件都一致時,才新增或更改支援的儀表板語言。

工作流程

  1. 在建立新功能鍵之前,先搜尋現有的功能鍵。
  2. 將使用者可見的 Angular 模板文字置於 TranslocoPipe 之後。
  3. 在 TypeScript 中使用 TranslocoService 處理計算後的標籤。
  4. 將相同的鍵路徑新增到所有七個區域 JSON 檔案中。
  5. 保持鍵名語義化,並按功能分組。
  6. 完全保留插值變數。不要翻譯變數名稱或更改佔位符語法。
  7. 對於計算後的選項標籤,依賴於活動語言,以便在語言切換後重新計算標籤。
  8. 對於日期、數字、百分比和持續時間,優先使用現有的區域服務或輔助函式,而不是手動格式化字串。
  9. 讓 PrimeNG 區域文字透過現有的同步服務流動,而不是硬編碼元件標籤。
  10. 保持標籤簡短,以適用於按鈕、標籤頁、晶片、表格欄位和行動版佈局。

可用於檢查的有用位置:

  • frontend/dashboard/src/app/app.config.ts
  • frontend/dashboard/src/app/transloco-loader.ts
  • frontend/dashboard/src/app/core/i18n/
  • frontend/dashboard/scripts/check-i18n-locales.mjs
  • frontend/dashboard/scripts/sync-i18n-locales.mjs

翻譯品質標準

翻譯產品 UI,而不是個別英文單詞。

  • 德語:使用自然產品德語及正確字元,例如 Ä、Ö、Ü、ä、ö、ü 和 ß。
  • 西班牙語:使用重音符號、ñ 和必要的開頭標點,例如 ¿Seguro?。
  • 法語:自然使用重音符號和撇號,例如 paramètres、sécurité 和 l'adresse e-mail。
  • 義大利語:在需要的地方使用重音符號,尤其是尾重音單詞,例如 attività、città、perché、può 和 è。
  • 荷蘭語:保持儀表板術語自然且簡潔。對 site、team、goal、funnel、share link 和 API client 重複使用現有術語。
  • 葡萄牙語:除非產品明確更改區域目標,否則使用現有的巴西葡萄牙語格式化上下文(pt-BR)。使用帶有正確重音符號的自然葡萄牙語。

在所有語言中保持分析術語的一致性。如果倉庫已對「site」、「team」、「event」、「goal」、「funnel」、「share link」、「API client」、「QR campaign」或「Opportunity」使用了某個術語,請重複使用它。

檢查

在翻譯變更後執行區域檢查:

cd frontend/dashboard && npm run i18n:check

如果懷疑鍵結構偏移,請執行同步指令碼並在保留結果前檢視產生的變更:

cd frontend/dashboard && node scripts/sync-i18n-locales.mjs

對儀表板檔案執行格式化檢查:

cd frontend/dashboard && npm run fmt:check

對於依賴語言切換的 UI 行為,請在擁有該行為的元件或服務附近新增或更新聚焦測試。

審查輸出

報告 i18n 變更時,請包括:

變更的鍵:
- <鍵路徑>

更新的區域:
- en, de, es, fr, it, nl, pt

檢查:
- <指令與結果>

注意事項:
- <佈局、措辭或審查意見>

除非確實經過母語人士審查,否則不要聲稱翻譯已由母語人士審查過。

相關技能