Skill: lbbniu/lbb-my-skill (version 1.0.1)

--- name: translator description: Professional Chinese-English bidirectional translation for technical documentation, following established style guides and terminology standards. Use when translating technical documents, API documentation, user guides, product descriptions, code comments, or any technical content between Chinese and English. Ensures consistency, accuracy, and adherence to technical writing conventions. --- # Translator ## Overview This skill provides professional Chinese-English bidirectional translation specialized for technical documentation. It ensures translations follow industry-standard style guides, maintain terminology consistency through a comprehensive terminology database, and adhere to technical writing best practices. ## Core Translation Workflow ### 1. Understand the Content Before translating: - Read the entire content to understand context and purpose - Identify the document type (API docs, user guide, tutorial, etc.) - Note any special terminology or technical concepts - Understand the target audience ### 2. Apply Translation Standards **For Chinese to English:** - Use active voice and present tense - Address the reader directly with "you" - Keep sentences concise and clear - Follow English punctuation rules (half-width) - Use bold for UI elements: **Button Name** - Use code formatting for technical terms: `function_name()` **For English to Chinese:** - Use formal written Chinese, avoid colloquialisms - Follow Chinese punctuation rules (full-width for Chinese, half-width for code) - Add spaces around English words in Chinese text - Keep technical names in English: React, API, JSON - Use bold for UI elements: **按钮名称** ### 3. Ensure Terminology Consistency **Always check the terminology database first:** - Load `references/terminology.md` to find standard translations - Use the exact translations specified in the terminology table - For terms not in the database, follow industry conventions - Maintain consistency throughout the document **For first occurrences:** - Chinese to English: Optionally use "English (中文注释)" format - English to Chinese: Optionally use "中文（English）" format - Subsequent uses maintain the standard translation ### 4. Maintain Technical Accuracy **Code elements:** - Never translate variable names, function names, or code syntax - Translate code comments according to target language - Keep string literals as-is unless they're user-facing text - Preserve code formatting and indentation **Technical concepts:** - Ensure technical meaning is preserved - Do not add or remove information - Maintain logical relationships from the original - Verify technical accuracy over linguistic fluency ### 5. Format Properly **Document structure:** - Preserve markdown formatting - Maintain heading hierarchy - Keep lists and tables properly formatted - Ensure links remain functional **Special elements:** - Translate alt text for images - Keep code blocks untranslated (except comments) - Format UI paths consistently: **Settings** > **Security** - Use appropriate note/warning/tip formatting ## Quick Translation Patterns ### Common Scenarios **API Documentation:** ```markdown Original (EN): ### Get User Profile Retrieves the profile information for a specific user. Translation (ZH): ### 获取用户资料 获取指定用户的资料信息。 ``` **User Instructions:** ```markdown Original (EN): Click **Save** to save your changes. Translation (ZH): 点击**保存**按钮保存更改。 ``` **Technical Descriptions:** ```markdown Original (ZH): 该函数返回一个包含用户数据的 JSON 对象。 Translation (EN): This function returns a JSON object containing user data. ``` ## Reference Materials This skill includes comprehensive reference materials. Load them as needed: ### Style Guide `references/style-guide.md` - Complete translation style guide including: - Translation principles (accuracy, consistency, readability) - Chinese to English conventions - English to Chinese conventions - Punctuation rules - Number and unit formatting - Code-related translation guidelines - Common expression mappings **When to load:** Reference when you need clarification on style conventions, punctuation rules, or formatting standards. ### Terminology Database `references/terminology.md` - Comprehensive technical terminology with standard Chinese-English mappings covering: - Software development terms (API, SDK, framework, etc.) - Cloud computing and architecture - Data and storage - Network and security - Frontend development - API and integration - User interface elements - Development tools - Document structure terms - Status and operation terms - Common verbs **When to load:** Reference at the start of any translation task to ensure terminology consistency. Search for specific terms as needed during translation. ### Writing Guidelines `references/writing-guidelines.md` - Technical writing best practices including: - Document structure standards - Writing style (clarity, active voice, present tense, second person) - Formatting standards for code, UI elements, links, images - Notes and warnings formatting - Step-by-step instructions format - API documentation standards - Code examples guidelines - Tables and version documentation **When to load:** Reference when creating or translating technical documentation to ensure it follows professional technical writing standards. ## Quality Checklist Before finalizing any translation, verify: **Accuracy:** - [ ] Technical meaning preserved - [ ] No information added or removed - [ ] Logical relationships maintained - [ ] Code elements untranslated (except comments) **Consistency:** - [ ] Terminology matches the database - [ ] Style follows the guide - [ ] Tone is consistent throughout - [ ] Format is consistent **Readability:** - [ ] Clear and natural in target language - [ ] Appropriate for target audience - [ ] Not overly literal - [ ] Flows well **Format:** - [ ] Markdown formatting preserved - [ ] Code blocks properly formatted - [ ] Links functional - [ ] Punctuation correct for target language - [ ] UI elements properly marked (bold) - [ ] Code elements properly marked (backticks) ## Usage Examples **Example 1: User asks for API documentation translation** ``` User: "请将这段 API 文档翻译成中文" Process: 1. Load references/terminology.md to check API-related terms 2. Read the entire API documentation 3. Translate following Chinese conventions (full-width punctuation, spaces around English) 4. Maintain code examples unchanged 5. Ensure UI elements are bolded 6. Verify terminology consistency ``` **Example 2: User asks for user guide translation** ``` User: "Translate this user guide to English" Process: 1. Load references/terminology.md and references/style-guide.md 2. Identify UI elements and technical terms 3. Translate using active voice, present tense, second person 4. Keep technical terms standardized 5. Format UI elements with bold 6. Check formatting and readability ``` **Example 3: User asks for terminology verification** ``` User: "检查这段翻译的术语是否一致" Process: 1. Load references/terminology.md 2. Extract all technical terms from the text 3. Compare against standard translations 4. Identify inconsistencies 5. Provide corrections with reference to terminology database ```

path: references/style-guide.md
content: # 技术文档翻译风格指南

## 翻译原则

### 1. 准确性优先
- 技术准确性高于语言流畅性
- 保持原文的技术含义和逻辑关系
- 不得添加或删减原文信息

### 2. 一致性
- 同一术语在整个文档中保持统一翻译
- 遵循术语表中的标准译法
- 保持语气和风格的统一

### 3. 可读性
- 使用简洁明了的表达
- 避免过度直译导致的生硬表达
- 符合目标语言的表达习惯

## 中译英规范

### 语气和风格
- 使用主动语态，避免被动语态
- 使用现在时态描述功能和操作
- 保持简洁，避免冗余
- 使用第二人称"you"直接与读者对话

### 句式结构
- 一句话表达一个主要观点
- 避免过长的复合句
- 使用并列结构时保持平行
- 示例：
  - ✓ "Click **Save** to save your changes."
  - ✗ "Your changes will be saved when you click the Save button."

### 标点符号
- 使用英文标点符号（半角）
- 列表使用句号或不用标点（保持一致）
- 代码、参数使用反引号包裹

### 格式要求
- UI 元素名称使用粗体：**Button Name**
- 代码元素使用反引号：`function_name()`
- 文件路径使用反引号：`/path/to/file`
- 重要提示使用 Note、Warning、Important 等标记

## 英译中规范

### 语气和风格
- 使用书面语，避免口语化
- 保持专业、客观的语气
- 避免过度本土化，保留必要的技术感

### 句式结构
- 遵循中文语序和表达习惯
- 适当拆分长句，提高可读性
- 避免欧化句式
- 示例：
  - ✓ "点击**保存**按钮保存更改。"
  - ✗ "当你点击保存按钮时，你的更改将被保存。"

### 标点符号
- 使用中文标点符号（全角）
- 句号、逗号、冒号使用全角：，。：
- 括号使用全角：（）
- 引号使用中文引号：「」或 ""
- 代码、英文专有名词前后使用半角空格

### 专有名词处理
- 产品名称、技术名称保持英文
- 首次出现时可用中文注释：React（一个 JavaScript 库）
- 常用技术术语保持英文：API、SDK、JSON
- 中英混排时注意空格：使用 React 框架开发应用

### 格式要求
- UI 元素名称使用粗体：**按钮名称**
- 代码元素使用反引号：`function_name()`
- 文件路径使用反引号：`/path/to/file`
- 重要提示使用"注意""警告""重要"等标记

## 数字和单位

### 英文文档
- 使用阿拉伯数字：1, 2, 3
- 大数字使用逗号分隔：1,000,000
- 百分比使用 %：50%
- 单位与数字之间加空格：10 GB, 5 minutes

### 中文文档
- 使用阿拉伯数字：1、2、3
- 大数字使用万、亿：100 万、10 亿
- 百分比使用 %：50%
- 单位与数字之间不加空格：10GB、5 分钟

## 代码相关

### 代码注释
- 注释保持简洁明了
- 使用完整的句子（首字母大写，句末标点）
- 或使用短语（全小写，无标点）
- 保持风格统一

### 代码示例
- 代码块不翻译
- 字符串内容根据需要翻译
- 变量名、函数名不翻译
- 注释根据目标语言翻译

## 常见表达对照

| 中文 | 英文 |
|------|------|
| 点击 | Click |
| 选择 | Select |
| 输入 | Enter / Type |
| 配置 | Configure |
| 设置 | Set / Configure |
| 启用 | Enable |
| 禁用 | Disable |
| 创建 | Create |
| 删除 | Delete |
| 修改 | Modify / Edit |
| 保存 | Save |
| 取消 | Cancel |
| 确认 | Confirm |
| 提交 | Submit |
| 返回 | Return / Go back |
| 刷新 | Refresh |
| 搜索 | Search |
| 筛选 | Filter |
| 排序 | Sort |
| 导入 | Import |
| 导出 | Export |
| 上传 | Upload |
| 下载 | Download |

## 翻译流程建议

1. **理解原文**：完整阅读原文，理解上下文和技术背景
2. **术语核对**：检查术语表，确保使用标准译法
3. **初步翻译**：按照风格指南进行翻译
4. **格式检查**：确保标点、格式符合规范
5. **一致性检查**：确保术语和风格的一致性
6. **质量审核**：检查准确性、可读性和完整性


path: references/terminology.md
content: # 产品术语表

## 使用说明

本术语表提供了技术文档中常用术语的标准中英文对照。翻译时必须严格遵循此表，确保术语的一致性和准确性。

**原则**：
- 术语表中的术语必须按照指定译法翻译
- 首次出现时可以用"中文（英文）"的形式注释
- 后续出现保持译法一致
- 产品特定术语保持英文或使用品牌标准译法

## 通用技术术语

### 软件开发

| 英文 | 中文 | 说明 |
|------|------|------|
| API | API | 不翻译，保持英文 |
| SDK | SDK | 不翻译，保持英文 |
| Framework | 框架 | |
| Library | 库 | |
| Module | 模块 | |
| Component | 组件 | |
| Plugin | 插件 | |
| Extension | 扩展 / 扩展程序 | 根据上下文选择 |
| Package | 包 | |
| Dependency | 依赖 / 依赖项 | |
| Repository | 仓库 / 代码仓库 | |
| Commit | 提交 | |
| Branch | 分支 | |
| Merge | 合并 | |
| Pull Request | 拉取请求 / PR | |
| Issue | 议题 / Issue | |
| Bug | 缺陷 / Bug | |
| Feature | 功能 / 特性 | |
| Refactor | 重构 | |
| Deploy | 部署 | |
| Build | 构建 | |
| Compile | 编译 | |
| Debug | 调试 | |
| Test | 测试 | |
| Unit Test | 单元测试 | |
| Integration Test | 集成测试 | |
| End-to-End Test | 端到端测试 | |
| Code Review | 代码审查 / Code Review | |
| Version Control | 版本控制 | |
| Continuous Integration | 持续集成 / CI | |
| Continuous Deployment | 持续部署 / CD | |

### 云计算与架构

| 英文 | 中文 | 说明 |
|------|------|------|
| Cloud Computing | 云计算 | |
| Virtual Machine | 虚拟机 | |
| Container | 容器 | |
| Docker | Docker | 不翻译，保持英文 |
| Kubernetes | Kubernetes | 不翻译，保持英文 |
| Microservices | 微服务 | |
| Serverless | 无服务器 / Serverless | |
| Load Balancer | 负载均衡器 | |
| Auto Scaling | 自动扩缩容 | |
| High Availability | 高可用性 / HA | |
| Disaster Recovery | 灾难恢复 | |
| Backup | 备份 | |
| Restore | 恢复 / 还原 | |
| Snapshot | 快照 | |
| Instance | 实例 | |
| Cluster | 集群 | |
| Node | 节点 | |
| Endpoint | 端点 / 终端节点 | |
| Gateway | 网关 | |
| Proxy | 代理 / 代理服务器 | |

### 数据与存储

| 英文 | 中文 | 说明 |
|------|------|------|
| Database | 数据库 | |
| SQL | SQL | 不翻译，保持英文 |
| NoSQL | NoSQL | 不翻译，保持英文 |
| Table | 表 | |
| Schema | 模式 / 架构 | 数据库语境下用"模式" |
| Query | 查询 | |
| Index | 索引 | |
| Primary Key | 主键 | |
| Foreign Key | 外键 | |
| Transaction | 事务 | |
| ACID | ACID | 不翻译，保持英文 |
| Cache | 缓存 | |
| Redis | Redis | 不翻译，保持英文 |
| Object Storage | 对象存储 | |
| Block Storage | 块存储 | |
| File System | 文件系统 | |
| Data Lake | 数据湖 | |
| Data Warehouse | 数据仓库 | |
| ETL | ETL | 不翻译，保持英文 |
| Big Data | 大数据 | |
| Analytics | 分析 | |
| Business Intelligence | 商业智能 / BI | |

### 网络与安全

| 英文 | 中文 | 说明 |
|------|------|------|
| Network | 网络 | |
| VPC | VPC | 不翻译，保持英文 |
| Subnet | 子网 | |
| IP Address | IP 地址 | |
| DNS | DNS | 不翻译，保持英文 |
| Firewall | 防火墙 | |
| Security Group | 安全组 | |
| SSL/TLS | SSL/TLS | 不翻译，保持英文 |
| Certificate | 证书 | |
| Encryption | 加密 | |
| Authentication | 身份验证 / 认证 | |
| Authorization | 授权 | |
| OAuth | OAuth | 不翻译，保持英文 |
| JWT | JWT | 不翻译，保持英文 |
| Token | 令牌 / Token | |
| Access Key | 访问密钥 | |
| Secret Key | 密钥 | |
| IAM | IAM | 不翻译，保持英文 |
| Role | 角色 | |
| Policy | 策略 | |
| Permission | 权限 | |
| Two-Factor Authentication | 双因素认证 / 2FA | |
| Single Sign-On | 单点登录 / SSO | |
| DDoS | DDoS | 不翻译，保持英文 |
| Vulnerability | 漏洞 | |
| Penetration Test | 渗透测试 | |

### 前端开发

| 英文 | 中文 | 说明 |
|------|------|------|
| Frontend | 前端 | |
| Backend | 后端 | |
| Full Stack | 全栈 | |
| HTML | HTML | 不翻译，保持英文 |
| CSS | CSS | 不翻译，保持英文 |
| JavaScript | JavaScript | 不翻译，保持英文 |
| TypeScript | TypeScript | 不翻译，保持英文 |
| React | React | 不翻译，保持英文 |
| Vue | Vue | 不翻译，保持英文 |
| Angular | Angular | 不翻译，保持英文 |
| DOM | DOM | 不翻译，保持英文 |
| Virtual DOM | 虚拟 DOM | |
| Component | 组件 | |
| Props | Props / 属性 | React 语境下保持 Props |
| State | 状态 / State | |
| Hook | Hook / 钩子 | React 语境下保持 Hook |
| Router | 路由器 / 路由 | |
| Responsive Design | 响应式设计 | |
| Progressive Web App | 渐进式 Web 应用 / PWA | |
| Single Page Application | 单页应用 / SPA | |
| Server-Side Rendering | 服务端渲染 / SSR | |
| Static Site Generation | 静态站点生成 / SSG | |
| Webpack | Webpack | 不翻译，保持英文 |
| Bundle | 打包 / 包 | 动词用"打包"，名词用"包" |

### API 与集成

| 英文 | 中文 | 说明 |
|------|------|------|
| REST | REST | 不翻译，保持英文 |
| RESTful API | RESTful API | 不翻译，保持英文 |
| GraphQL | GraphQL | 不翻译，保持英文 |
| WebSocket | WebSocket | 不翻译，保持英文 |
| HTTP | HTTP | 不翻译，保持英文 |
| HTTPS | HTTPS | 不翻译，保持英文 |
| Request | 请求 | |
| Response | 响应 | |
| Endpoint | 端点 / API 端点 | |
| Header | 请求头 / 响应头 | 根据上下文 |
| Body | 请求体 / 响应体 | 根据上下文 |
| Parameter | 参数 | |
| Query String | 查询字符串 | |
| Payload | 负载 / 有效载荷 | |
| Status Code | 状态码 | |
| Rate Limit | 速率限制 | |
| Throttling | 限流 | |
| Webhook | Webhook | 不翻译，保持英文 |
| Callback | 回调 | |
| Middleware | 中间件 | |
| CORS | CORS | 不翻译，保持英文 |
| JSON | JSON | 不翻译，保持英文 |
| XML | XML | 不翻译，保持英文 |
| YAML | YAML | 不翻译，保持英文 |

### 用户界面

| 英文 | 中文 | 说明 |
|------|------|------|
| User Interface | 用户界面 / UI | |
| User Experience | 用户体验 / UX | |
| Dashboard | 仪表板 / 控制台 | 根据产品习惯 |
| Console | 控制台 | |
| Panel | 面板 | |
| Dialog | 对话框 | |
| Modal | 模态框 / 弹窗 | |
| Tooltip | 工具提示 / 提示框 | |
| Dropdown | 下拉菜单 / 下拉列表 | |
| Checkbox | 复选框 | |
| Radio Button | 单选按钮 | |
| Toggle | 开关 / 切换 | |
| Tab | 标签页 / 选项卡 | |
| Sidebar | 侧边栏 | |
| Navigation Bar | 导航栏 | |
| Breadcrumb | 面包屑导航 | |
| Pagination | 分页 | |
| Form | 表单 | |
| Input Field | 输入框 / 输入字段 | |
| Button | 按钮 | |
| Icon | 图标 | |
| Avatar | 头像 | |
| Badge | 徽章 / 标记 | |
| Notification | 通知 | |
| Alert | 警告 / 提醒 | |
| Toast | 提示消息 / Toast | |
| Spinner | 加载动画 / 加载指示器 | |
| Progress Bar | 进度条 | |

### 开发工具

| 英文 | 中文 | 说明 |
|------|------|------|
| IDE | IDE | 不翻译，保持英文 |
| Code Editor | 代码编辑器 | |
| Terminal | 终端 | |
| Command Line | 命令行 | |
| CLI | CLI | 不翻译，保持英文 |
| GUI | GUI | 不翻译，保持英文 |
| Git | Git | 不翻译，保持英文 |
| GitHub | GitHub | 不翻译，保持英文 |
| GitLab | GitLab | 不翻译，保持英文 |
| npm | npm | 不翻译，保持英文 |
| yarn | yarn | 不翻译，保持英文 |
| pip | pip | 不翻译，保持英文 |
| Maven | Maven | 不翻译，保持英文 |
| Gradle | Gradle | 不翻译，保持英文 |
| Jenkins | Jenkins | 不翻译，保持英文 |
| Travis CI | Travis CI | 不翻译，保持英文 |
| CircleCI | CircleCI | 不翻译，保持英文 |

## 文档结构术语

| 英文 | 中文 | 说明 |
|------|------|------|
| Table of Contents | 目录 | |
| Overview | 概述 / 概览 | |
| Introduction | 简介 / 介绍 | |
| Getting Started | 快速开始 / 入门指南 | |
| Prerequisites | 前提条件 / 先决条件 | |
| Installation | 安装 | |
| Configuration | 配置 | |
| Tutorial | 教程 | |
| Guide | 指南 | |
| Reference | 参考 / 参考文档 | |
| Best Practices | 最佳实践 | |
| Troubleshooting | 故障排除 / 问题排查 | |
| FAQ | 常见问题 / FAQ | |
| Glossary | 术语表 | |
| Appendix | 附录 | |
| Changelog | 变更日志 | |
| Release Notes | 发布说明 / 版本说明 | |
| Roadmap | 路线图 | |
| Migration Guide | 迁移指南 | |
| Deprecation Notice | 弃用通知 | |

## 状态与操作

| 英文 | 中文 | 说明 |
|------|------|------|
| Enabled | 已启用 | |
| Disabled | 已禁用 | |
| Active | 活动 / 激活 | |
| Inactive | 非活动 / 未激活 | |
| Running | 运行中 | |
| Stopped | 已停止 | |
| Pending | 待处理 / 挂起 | |
| Completed | 已完成 | |
| Failed | 失败 | |
| Success | 成功 | |
| Error | 错误 | |
| Warning | 警告 | |
| Info | 信息 | |
| Debug | 调试 | |
| Available | 可用 | |
| Unavailable | 不可用 | |
| Online | 在线 | |
| Offline | 离线 | |
| Connected | 已连接 | |
| Disconnected | 已断开 | |
| Valid | 有效 / 合法 | |
| Invalid | 无效 / 非法 | |
| Required | 必需 / 必填 | |
| Optional | 可选 | |

## 常用动词

| 英文 | 中文 | 说明 |
|------|------|------|
| Initialize | 初始化 | |
| Configure | 配置 | |
| Install | 安装 | |
| Uninstall | 卸载 | |
| Update | 更新 | |
| Upgrade | 升级 | |
| Downgrade | 降级 | |
| Migrate | 迁移 | |
| Import | 导入 | |
| Export | 导出 | |
| Load | 加载 | |
| Unload | 卸载 / 卸载 | |
| Start | 启动 | |
| Stop | 停止 | |
| Restart | 重启 | |
| Pause | 暂停 | |
| Resume | 恢复 | |
| Execute | 执行 | |
| Run | 运行 | |
| Invoke | 调用 | |
| Call | 调用 | |
| Trigger | 触发 | |
| Subscribe | 订阅 | |
| Publish | 发布 | |
| Fetch | 获取 | |
| Retrieve | 检索 / 获取 | |
| Query | 查询 | |
| Search | 搜索 | |
| Filter | 筛选 / 过滤 | |
| Sort | 排序 | |
| Validate | 验证 | |
| Parse | 解析 | |
| Serialize | 序列化 | |
| Deserialize | 反序列化 | |
| Encode | 编码 | |
| Decode | 解码 | |
| Encrypt | 加密 | |
| Decrypt | 解密 | |
| Compress | 压缩 | |
| Decompress | 解压缩 | |
| Monitor | 监控 | |
| Track | 跟踪 | |
| Log | 记录 / 日志 | |
| Audit | 审计 | |

## 使用建议

1. **术语优先级**：术语表 > 产品文档 > 行业惯例
2. **上下文适配**：某些术语在不同上下文下有不同译法，选择最合适的
3. **保持更新**：发现新术语或更好的译法时，及时更新术语表
4. **团队协作**：翻译团队应共同维护和遵守术语表


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)