关于 engineering-terminology
面向技术文档翻译的工程术语 skill,涵盖软件、Web、DevOps、数据、AI/ML 和硬件等领域。它通过按领域组织的术语表帮助译者按需查找术语,并保持翻译一致。
主要功能
- 01覆盖六类工程领域术语
- 02按领域组织术语表
- 03支持跨术语表检索
- 04提供术语翻译与一致性原则
适用场景
- 01翻译软件工程文档
- 02处理中英文日文技术术语
- 03为项目建立一致的术语用法
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ shino369/ claude-code-personal-workspace --skill engineering-terminology安装后在 Claude Code 中输入/engineering-terminology确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
glossaries/ai-ml.mddata-engineering.mddevops-cloud.mdhardware-electronics.mdsoftware-engineering.mdweb-development.md详细介绍
工程术语知识
概述
此技能提供全面的工程和技术术语知识,适用于三语翻译工作(英语、日语、繁体中文)。在处理技术文档、软件工程材料、硬件规格或科学内容时,请使用此技能。
术语按特定领域整理成词汇表,并采用渐进式披露方式,让你只在需要时查阅详细术语。
如何使用词汇表
可用词汇表
所有词汇表均位于 glossaries/ 子目录中:
- software-engineering.md - 软件工程核心概念、设计模式、测试、版本控制
- web-development.md - 前端/后端框架、Web 技术、API 设计
- devops-cloud.md - DevOps 实践、云计算、容器化、基础设施
- data-engineering.md - 数据处理、数据库、分析、数据管道
- ai-ml.md - 人工智能、机器学习、深度学习、大模型
- hardware-electronics.md - 硬件设计、电子技术、嵌入式系统
搜索各词汇表
翻译技术文档时:
- 确定领域 - 判断哪些词汇表最相关
- 阅读词汇表 - 使用 Read 工具查阅特定词汇表文件
- 搜索术语 - 需要跨多个词汇表搜索时,使用 Grep 工具
- 保持一致 - 为反复出现的译文创建项目专用术语表
示例工作流:
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 人机界面指南(本地化版本)
- Google 开发者文档(本地化版本)
- IEEE、ISO 国际标准
快速参考:最常见术语
| 英文 | 日语 | 繁体中文 | 备注 |
|---|---|---|---|
| API | API, エーピーアイ | API, 應用程式介面 | 通常保留缩写 |
| Framework | フレームワーク | 框架 | - |
| Database | データベース | 資料庫 | 通常缩写为 DB |
| Algorithm | アルゴリズム | 演算法 | - |
| Architecture | アーキテクチャ | 架構 | 系统架构:システムアーキテクチャ, 系統架構 |
| Backend | バックエンド | 後端 | - |
| Frontend | フロントエンド | 前端 | - |
| Deploy | デプロイ | 部署 | 部署:デプロイメント, 部署作業 |
| Debug | デバッグ | 除錯 | - |
| Compile | コンパイル | 編譯 | 编译器:コンパイラ, 編譯器 |
| Runtime | ランタイム | 執行時期 | 运行时环境:実行環境, 執行環境 |
| Library | ライブラリ | 函式庫 | - |
| Module | モジュール | 模組 | - |
| Container | コンテナ | 容器 | Docker 容器等 |
| Pipeline | パイプライン | 流水線 | CI/CD 流水线 |
| Repository | リポジトリ | 儲存庫 | 代码仓库 |
| Branch | ブランチ | 分支 | Git 分支 |
| Commit | コミット | 提交 | Git 提交 |
| Merge | マージ | 合併 | Git 合并 |
| Cloud | クラウド | 雲端 | 云计算:クラウドコンピューティング, 雲端運算 |
| Server | サーバー | 伺服器 | - |
| Client | クライアント | 客戶端 | - |
| Request | リクエスト | 請求 | HTTP 请求 |
| Response | レスポンス | 回應 | HTTP 响应 |
| Query | クエリ | 查詢 | 数据库查询 |
| Schema | スキーマ | 綱要 | 数据库架构 |
| Model | モデル | 模型 | 数据模型、ML 模型 |
| Interface | インターフェース | 介面 | 用户界面:ユーザーインターフェース, 使用者介面 |
| Component | コンポーネント | 元件 | 软件组件 |
| Service | サービス | 服務 | 微服务、Web 服务 |
最佳实践
1. 创建项目术语表
为每个翻译项目维护一份一致的术语表。记录以下方面的决定:
- 保留英文的缩写
- 翻译还是音译的术语
- 特定领域的术语选择
- 客户或项目的特定偏好
2. 验证技术准确性
务必确认技术翻译准确传达了原意:
- 如有疑问,请咨询领域专家
- 请领域内的母语者测试译文
- 检查代码示例是否仍可执行
- 确保技术流程仍然准确
3. 处理代码和技术元素
翻译含代码的文档时:
- 除非明确要求本地化,否则保持代码不变
- 变量名保留英文(标准做法)
- 翻译代码块中的注释
- 翻译面向用户的字符串字面量
- API 端点和技术标识符保持不变
4. 单位和测量值
请谨慎处理单位和测量值:
- SI 单位(米、千克)保持不变
- 注意地区差异(例如,meter 可译为“公尺”或“米”)
- 仅当目标受众习惯使用其他单位时才进行换算
- 始终仔细核对数值和公式
5. 交叉引用和引文
妥善保留引用信息:
- 引文编号和参考 ID 保持不变
- 翻译引文文本(作者姓名可保留原文)
- 如果有本地化版本,请更新超链接
- 保持参考文献格式规范
质量检查清单
翻译工程内容时:
- 技术术语翻译准确
- 全文术语一致
- 缩略语处理得当(保留原文或翻译)
- 代码示例语法正确
- 代码注释已翻译
- 变量名和标识符已保留
- 数学公式和符号保持不变
- 单位和测量值处理正确
- 交叉引用和引文均已妥善保留
- 如有本地化版本,已更新超链接
- 已验证技术准确性(最好由领域专家确认)
- 目标语言自然流畅,符合母语者习惯
- 格式(Markdown、LaTeX 等)已保留
- 图片、图表和插图均已正确引用
其他资源
对于术语表中未收录的术语:
- Microsoft Language Portal - 详尽的术语数据库
- Google Developer Documentation - 查看本地化版本
- IEEE Standards - 电气和电子工程相关标准
- ISO Standards - 国际技术标准
- 学术论文 - 查看该领域已发表论文中的译法
- 产品文档 - 主要科技公司的官方译文
为术语表做贡献
遇到术语表中未收录的重要术语时,请记录下来,供日后补充。优先记录:
- 领域内常用的术语
- 存在歧义或多种译法的术语
- 新兴的技术概念
- 地区差异显著的术语
评论
支持 Markdown