mcpField
E
engineering-terminology

engineering-terminology

github.com/shino369文档处理342 次安装2 周前更新
代码仓库

关于 engineering-terminology

面向技术文档翻译的工程术语 skill,涵盖软件、Web、DevOps、数据、AI/ML 和硬件等领域。它通过按领域组织的术语表帮助译者按需查找术语,并保持翻译一致。

主要功能

  1. 01覆盖六类工程领域术语
  2. 02按领域组织术语表
  3. 03支持跨术语表检索
  4. 04提供术语翻译与一致性原则

适用场景

  1. 01翻译软件工程文档
  2. 02处理中英文日文技术术语
  3. 03为项目建立一致的术语用法

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/shino369/claude-code-personal-workspace --skill engineering-terminology

安装后在 Claude Code 中输入/engineering-terminology确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

glossaries/
ai-ml.md
data-engineering.md
devops-cloud.md
hardware-electronics.md
software-engineering.md
web-development.md

详细介绍

工程术语知识

概述

此技能提供全面的工程和技术术语知识,适用于三语翻译工作(英语、日语、繁体中文)。在处理技术文档、软件工程材料、硬件规格或科学内容时,请使用此技能。

术语按特定领域整理成词汇表,并采用渐进式披露方式,让你只在需要时查阅详细术语。

如何使用词汇表

可用词汇表

所有词汇表均位于 glossaries/ 子目录中:

  1. software-engineering.md - 软件工程核心概念、设计模式、测试、版本控制
  2. web-development.md - 前端/后端框架、Web 技术、API 设计
  3. devops-cloud.md - DevOps 实践、云计算、容器化、基础设施
  4. data-engineering.md - 数据处理、数据库、分析、数据管道
  5. ai-ml.md - 人工智能、机器学习、深度学习、大模型
  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 人机界面指南(本地化版本)
  • Google 开发者文档(本地化版本)
  • IEEE、ISO 国际标准

快速参考:最常见术语

英文日语繁体中文备注
APIAPI, エーピーアイ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 等)已保留
  • 图片、图表和插图均已正确引用

其他资源

对于术语表中未收录的术语:

  1. Microsoft Language Portal - 详尽的术语数据库
  2. Google Developer Documentation - 查看本地化版本
  3. IEEE Standards - 电气和电子工程相关标准
  4. ISO Standards - 国际技术标准
  5. 学术论文 - 查看该领域已发表论文中的译法
  6. 产品文档 - 主要科技公司的官方译文

为术语表做贡献

遇到术语表中未收录的重要术语时,请记录下来,供日后补充。优先记录:

  • 领域内常用的术语
  • 存在歧义或多种译法的术语
  • 新兴的技术概念
  • 地区差异显著的术语

评论

支持 Markdown