engineering-terminology

エンジニアリング用語の専門知識

概要

このスキルでは、英語、日本語、繁体字中国語の三言語間の翻訳作業に必要な、エンジニアリングおよび技術用語の包括的な知識を提供します。技術文書、ソフトウェアエンジニアリング資料、ハードウェア仕様、科学コンテンツを扱う際に使用してください。

用語は分野ごとの用語集にまとめられており、段階的に詳細を確認できるため、必要なときにだけ詳しい用語を参照できます。

用語集の使い方

利用できる用語集

すべての用語集は glossaries/ サブディレクトリにあります。

1. software-engineering.md - ソフトウェアエンジニアリングの基本概念、設計パターン、テスト、バージョン管理
2. web-development.md - フロントエンド／バックエンドのフレームワーク、ウェブ技術、API 設計
3. devops-cloud.md - DevOps の実践、クラウドコンピューティング、コンテナ化、インフラストラクチャ
4. data-engineering.md - データ処理、データベース、分析、データパイプライン
5. ai-ml.md - 人工知能、機械学習、ディープラーニング、LLM
6. hardware-electronics.md - ハードウェア設計、電子工学、組み込みシステム

用語集を横断して検索する

技術文書を翻訳する場合：

1. 分野を特定する - 最も関連性の高い用語集を判断します
2. 用語集を読む - Read ツールを使って、該当する用語集ファイルを参照します
3. 用語を検索する - 複数の用語集を横断して検索する必要がある場合は、Grep ツールを使います
4. 一貫性を保つ - 繰り返し使用する翻訳語をまとめた、プロジェクト固有の用語リストを作成します

ワークフローの例：

User: "Translate this API documentation"
→ Read web-development.md (for REST, GraphQL, endpoint)
→ Read software-engineering.md (for architecture, testing)

音訳と翻訳

英語のままにする（または音訳する）：

• 広く定着した頭字語：API、SDK、GUI、REST、JSON、XML
• 製品名／ブランド名：React、Docker、Kubernetes、AWS
• プログラミング言語：Python、JavaScript、TypeScript
• 対象言語で英語の用語が標準となっている場合

翻訳する：

• 定訳がある概念用語
• 一般的なエンジニアリングの概念
• ユーザー向けコンテンツやドキュメント
• 技術に詳しくないユーザーにもわかりやすくすることが重要な場合

地域による違い

台湾と香港の中国語：

• このスキルでは、台湾（台灣）の慣習をデフォルトとして使用します
• 香港（香港）では、特にコンピューティング分野で異なる用語が使われることがあります
• 例：
  • ソフトウェア：軟體（TW）と軟件（HK）
  • ネットワーク：網路（TW）と網絡（HK）
  • 情報：資訊（TW）と信息（HK）

日本語の使い分け：

• 技術文書では、漢字、カタカナ、英語を組み合わせて使います
• 外来の技術用語にはカタカナを使います（「server」は「サーバー」）
• フォーマルな文書では漢字を多く使い、カジュアルなコンテンツではカタカナを多く使います

翻訳の基本原則

原則 1：一貫性

技術用語は文書全体を通して統一してください。翻訳プロジェクトごとに用語集を作成し、表記を統一します。

原則 2：文脈を考慮する

同じ英語の用語でも、文脈によって訳語が異なる場合があります。

• プログラミングでの「Function」→ JA：関数／ZH-TW：函式
• 一般的な用法での「Function」→ JA：機能／ZH-TW：功能
• プログラミングでの「Type」→ JA：型／ZH-TW：型別
• カテゴリーとしての「Type」→ JA：タイプ／ZH-TW：類型

原則 3：対象読者を意識する

求められる技術的な詳しさは、読者によって異なります。

• エンジニア：専門用語を多く使い、英語の頭字語はそのまま使用できます
• 技術系マネージャー：技術用語とわかりやすさのバランスを取ります
• エンドユーザー：自然な言葉に翻訳し、頭字語を説明します

原則 4：公式標準を確認する

主要な製品や標準規格については、各地域の公式ローカライズを確認してください。

• Microsoft の用語データベース
• Apple Human Interface Guidelines（ローカライズ版）
• Google の開発者向けドキュメント（ローカライズ版）
• IEEE、ISO の国際標準規格

Quick Reference: Most Common Terms

English	Japanese	Chinese (Traditional)	Notes
API	API, エーピーアイ	API, 應用程式介面	Keep acronym usually
Framework	フレームワーク	框架	-
Database	データベース	資料庫	Often shortened to DB
Algorithm	アルゴリズム	演算法	-
Architecture	アーキテクチャ	架構	System architecture: システムアーキテクチャ, 系統架構
Backend	バックエンド	後端	-
Frontend	フロントエンド	前端	-
Deploy	デプロイ	部署	Deployment: デプロイメント, 部署作業
Debug	デバッグ	除錯	-
Compile	コンパイル	編譯	Compiler: コンパイラ, 編譯器
Runtime	ランタイム	執行時期	Runtime environment: 実行環境, 執行環境
Library	ライブラリ	函式庫	-
Module	モジュール	模組	-
Container	コンテナ	容器	Docker container, etc.
Pipeline	パイプライン	流水線	CI/CD pipeline
Repository	リポジトリ	儲存庫	Code repository
Branch	ブランチ	分支	Git branch
Commit	コミット	提交	Git commit
Merge	マージ	合併	Git merge
Cloud	クラウド	雲端	Cloud computing: クラウドコンピューティング, 雲端運算
Server	サーバー	伺服器	-
Client	クライアント	客戶端	-
Request	リクエスト	請求	HTTP request
Response	レスポンス	回應	HTTP response
Query	クエリ	查詢	Database query
Schema	スキーマ	綱要	Database schema
Model	モデル	模型	Data model, ML model
Interface	インターフェース	介面	User interface: ユーザーインターフェース, 使用者介面
Component	コンポーネント	元件	Software component
Service	サービス	服務	Microservice, web service

Best Practices

1. Create Project Glossaries

For each translation project, maintain a consistent terminology list. Document decisions about:

• Which acronyms to keep in English
• Which terms to translate vs transliterate
• Domain-specific terminology choices
• Client or project-specific preferences

2. 技術的な正確性を確認する

技術的な翻訳が正しい意味を保っていることを、必ず確認してください。

• 不明な場合は、その分野の専門家に相談する
• その分野のネイティブスピーカーに翻訳を確認してもらう
• コード例が引き続き実行可能であることを確認する
• 技術的な手順が引き続き正確であることを確認する

3. コードと技術的要素を扱う

コードを含む文書を翻訳する場合：

• 明示的にローカライズする場合を除き、コードは変更しない
• 変数名は英語のままにする（標準的な慣例です）
• コードブロック内のコメントを翻訳する
• ユーザー向けテキストの文字列リテラルを翻訳する
• API エンドポイントと技術識別子は変更しない

4. 単位と測定値

単位と測定値には注意してください。

• SI 単位（メートル、キログラム）はそのままにする
• 地域による違いに注意する（例：メートルの表記として「公尺」と「米」）
• 対象読者が異なる単位を期待する場合にのみ、単位を換算する
• 数値と数式は必ず再確認する

5. 相互参照と引用

適切な参照を維持してください。

• 引用番号と参照 ID は変更しない
• 引用文は翻訳する（著者名は原文のままでもかまいません）
• ローカライズ版がある場合は、ハイパーリンクを更新する
• 参考文献の書式規則を維持する

品質チェックリスト

エンジニアリング関連のコンテンツを翻訳する際は、次の点を確認してください。

• 技術用語が正確に翻訳されている
• 文書全体で用語が統一されている
• 略語が適切に扱われている（そのままにするか、翻訳する）
• コードサンプルの構文が正しく保たれている
• コメントが翻訳されている
• 変数名と識別子が保持されている
• 数式と記号が変更されていない
• 単位と測定値が適切に扱われている
• 相互参照と引用が適切に維持されている
• 入手可能な場合、ハイパーリンクがローカライズ版に更新されている
• 技術的な正確性が確認されている（できればその分野の専門家が確認）
• 対象言語がネイティブスピーカーにとって自然である
• 書式（Markdown、LaTeX など）が維持されている
• 画像、図、図表が正しく参照されている

追加リソース

用語集にない用語を調べる場合：

1. Microsoft Language Portal - 豊富な用語データベース
2. Google Developer Documentation - ローカライズ版を確認する
3. IEEE Standards - 電気・電子工学分野の規格
4. ISO Standards - 国際技術規格
5. 学術論文 - その分野の論文における翻訳を確認する
6. 製品ドキュメント - 大手テクノロジー企業による公式翻訳

用語集への貢献

用語集にない重要な用語を見つけた場合は、今後の追加に備えて記録してください。次の用語を優先してください。

• その分野で頻繁に使われる用語
• 翻訳が曖昧、または複数ある用語
• 新たに登場した技術概念
• 地域による違いが大きい用語