{"id":"c2fd9e6d-996d-4758-b710-2842633d27f1","shortId":"pGzBk7","kind":"skill","title":"chinese-documentation","tagline":"中文技术文档写作规范——排版、术语、结构一步到位，告别机翻味","description":"# 中文技术文档写作规范\n\n## 概述\n\n中文技术文档最常见的问题不是内容不够，而是**读起来别扭**——中英文挤在一起没有空格、全角半角混用、一股机翻味。本技能提供一套完整的中文技术文档写作规范，让你的文档**专业、好读、不出戏**。\n\n**核心原则：** 排版服务于阅读体验，规范服务于一致性，内容服务于读者。\n\n**参考标准：** [中文文案排版指北](https://github.com/sparanoid/chinese-copywriting-guidelines)\n\n## 中文排版规范\n\n### 空格\n\n**中英文之间加空格：**\n\n```\n# 好\n使用 Git 进行版本管理，配合 Jenkins 实现持续集成。\n\n# 坏\n使用Git进行版本管理，配合Jenkins实现持续集成。\n```\n\n**中文与数字之间加空格：**\n\n```\n# 好\n本次更新包含 3 个新功能和 12 个 Bug 修复。\n\n# 坏\n本次更新包含3个新功能和12个Bug修复。\n```\n\n**数字与单位之间加空格：**\n\n```\n# 好\n文件大小不超过 5 MB，响应时间控制在 200 ms 以内。\n\n# 坏\n文件大小不超过5MB，响应时间控制在200ms以内。\n```\n\n**例外：度数、百分比等不加空格：**\n\n```\n# 好\n今天气温 32°C，CPU 使用率 95%。\n\n# 坏\n今天气温 32 °C，CPU 使用率 95 %。\n```\n\n**链接前后加空格：**\n\n```\n# 好\n请参考 [官方文档](https://example.com) 获取更多信息。\n\n# 坏\n请参考[官方文档](https://example.com)获取更多信息。\n```\n\n### 标点符号\n\n**中文语境使用全角标点：**\n\n```\n# 好\n注意：该接口需要鉴权，请先获取 Token。\n\n# 坏\n注意:该接口需要鉴权,请先获取 Token.\n```\n\n**全角标点与英文/数字之间不加空格：**\n\n```\n# 好\n项目使用 MIT 协议，详见 LICENSE 文件。\n\n# 坏\n项目使用 MIT 协议 ，详见 LICENSE 文件 。\n```\n\n**括号的使用：**\n\n```\n# 中文语境用全角括号\n请运行安装命令（详见下方说明）。\n\n# 括号内有英文或数字时用半角括号\n该项目基于 Spring Boot (v3.2.0) 开发。\n\n# 纯英文内容用半角括号\nSee the documentation (README.md) for details.\n```\n\n**引号的使用：**\n\n```\n# 中文使用直角引号（推荐）\n「确定」按钮触发表单提交，「取消」按钮关闭弹窗。\n\n# 也可以使用弯引号（视团队规范而定）\n\"确定\"按钮触发表单提交，\"取消\"按钮关闭弹窗。\n\n# 嵌套引号\n他说：「请点击『确定』按钮。」\n```\n\n### 数字\n\n```\n# 阿拉伯数字（技术文档中统一使用半角数字）\n支持最多 100 个并发连接。\n\n# 不要用中文数字写技术参数\n# 坏：支持最多一百个并发连接。\n\n# 数字使用半角字符\n版本号 v2.1.0，端口号 8080，HTTP 状态码 200。\n```\n\n## 中英混排最佳实践\n\n### 术语处理原则\n\n**保留英文的情况：**\n\n- 专有名词：React、Kubernetes、Redis、MySQL\n- 行业通用缩写：API、SDK、CLI、ORM、CI/CD\n- 命令和代码：`npm install`、`git commit`\n- 协议和标准：HTTP、TCP/IP、JSON、REST\n- 没有公认中文翻译的术语：debounce、throttle、middleware\n\n**翻译为中文的情况：**\n\n- 有公认翻译的通用概念：数据库、服务器、浏览器、框架\n- 描述性短语：version control → 版本控制，load balancing → 负载均衡\n- 文档标题和章节名（尽量中文，技术名词可保留英文）\n\n### 首次出现标注翻译\n\n技术术语首次出现时，标注中英对照：\n\n```\n# 好\n本系统采用消息队列（Message Queue）实现异步通信，\n使用死信队列（Dead Letter Queue）处理消费失败的消息。\n\n# 后续出现直接使用\n消息队列的消费者需要实现幂等性……\n```\n\n### 避免过度翻译\n\n```\n# 好：保留业界通用英文术语\n在 Controller 层做参数校验，Service 层处理业务逻辑。\n\n# 坏：强行翻译反而看不懂\n在控制器层做参数校验，服务层处理业务逻辑。\n\n# 好\n使用 Redis 做 Session 缓存。\n\n# 坏\n使用\"远程字典服务\"做\"会话\"缓存。\n```\n\n## API 文档中英对照格式\n\n### 接口文档模板\n\n```markdown\n## 创建订单 / Create Order\n\n### 基本信息\n\n- **请求方式 (Method):** POST\n- **请求路径 (Path):** `/api/v1/orders`\n- **鉴权方式 (Auth):** Bearer Token\n- **Content-Type:** application/json\n\n### 请求参数 (Request Parameters)\n\n| 参数名 (Field) | 类型 (Type) | 必填 (Required) | 说明 (Description) |\n|----------------|-------------|-----------------|-------------------|\n| product_id | string | 是 | 商品 ID (Product ID) |\n| quantity | integer | 是 | 购买数量 (Quantity)，最小值为 1 |\n| address_id | string | 是 | 收货地址 ID (Shipping address ID) |\n| coupon_code | string | 否 | 优惠券码 (Coupon code) |\n\n### 请求示例 (Request Example)\n\n\\```json\n{\n  \"product_id\": \"prod_abc123\",\n  \"quantity\": 2,\n  \"address_id\": \"addr_xyz789\",\n  \"coupon_code\": \"SUMMER2024\"\n}\n\\```\n\n### 响应参数 (Response Parameters)\n\n| 参数名 (Field) | 类型 (Type) | 说明 (Description) |\n|----------------|-------------|-------------------|\n| order_id | string | 订单 ID (Order ID) |\n| status | string | 订单状态 (Order status): pending / paid / shipped |\n| total_amount | integer | 订单总金额，单位：分 (Total amount in cents) |\n| created_at | string | 创建时间 (Created at)，ISO 8601 格式 |\n\n### 响应示例 (Response Example)\n\n\\```json\n{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"data\": {\n    \"order_id\": \"ord_20240315001\",\n    \"status\": \"pending\",\n    \"total_amount\": 9900,\n    \"created_at\": \"2024-03-15T10:30:00+08:00\"\n  }\n}\n\\```\n\n### 错误码 (Error Codes)\n\n| 错误码 (Code) | 说明 (Description) | 处理建议 (Suggestion) |\n|---------------|--------------------|--------------------|\n| 40001 | 商品不存在 (Product not found) | 检查 product_id 是否正确 |\n| 40002 | 库存不足 (Insufficient stock) | 减少购买数量或稍后重试 |\n| 40003 | 优惠券已过期 (Coupon expired) | 移除 coupon_code 或更换优惠券 |\n```\n\n### 金额表示约定\n\n```\n# 好：明确说明单位\ntotal_amount: 9900  // 单位：分（即 99.00 元）\n\n# 坏：不说明单位，造成歧义\ntotal_amount: 99.00  // 是元还是分？浮点数会有精度问题\n```\n\n## README.md 中文模板\n\n国内开源项目常用的 README 结构：\n\n```markdown\n# 项目名称\n\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)]()\n[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)]()\n\n简短一句话介绍项目是什么、解决什么问题。\n\n## 特性\n\n- 特性一：简要描述\n- 特性二：简要描述\n- 特性三：简要描述\n\n## 快速开始\n\n### 环境要求\n\n- Node.js >= 20\n- MySQL >= 8.0\n\n### 安装\n\n\\```bash\nnpm install your-package\n\\```\n\n### 基本用法\n\n\\```typescript\nimport { YourPackage } from 'your-package';\n\nconst client = new YourPackage({ apiKey: 'your-key' });\nconst result = await client.doSomething();\n\\```\n\n## 文档\n\n- [使用指南](./docs/guide.md)\n- [API 参考](./docs/api.md)\n- [常见问题](./docs/faq.md)\n- [更新日志](./CHANGELOG.md)\n\n## 示例\n\n更多示例请查看 [examples](./examples) 目录。\n\n## 贡献指南\n\n欢迎提交 Issue 和 Pull Request。请先阅读 [贡献指南](./CONTRIBUTING.md)。\n\n### 本地开发\n\n\\```bash\n# 克隆项目\ngit clone https://gitee.com/your-org/your-project.git\n\n# 安装依赖\nnpm install\n\n# 启动开发服务器\nnpm run dev\n\n# 运行测试\nnpm test\n\\```\n\n## 致谢\n\n- [依赖项目一](https://example.com) — 简要说明\n- [依赖项目二](https://example.com) — 简要说明\n\n## 许可证\n\n[MIT](./LICENSE)\n```\n\n## 常见问题与避坑指南\n\n### 问题一：机翻味\n\n**特征：** 句式生硬、不符合中文表达习惯。\n\n```\n# 机翻味\n这个函数被用来计算用户的折扣。如果你想要获取更多信息，请参考文档。\n\n# 自然中文\n这个函数用于计算用户折扣。更多信息请参考文档。\n```\n\n**要点：**\n- 避免被动语态（\"被用来\" → \"用于\"）\n- 避免冗余代词（\"你想要\" → 直接说）\n- 避免直译英文句式\n\n### 问题二：句式欧化\n\n**特征：** 长定语、多重从句、一句话说不完。\n\n```\n# 欧化句式\n这是一个可以帮助开发者在不需要手动配置复杂的构建工具链的情况下\n快速搭建现代化前端项目的脚手架工具。\n\n# 正常中文\n这是一个前端脚手架工具，帮助开发者快速搭建项目，免去手动配置构建工具链的麻烦。\n```\n\n**要点：**\n- 长句拆成短句\n- 把定语从句改成并列句\n- 一句话只说一件事\n\n### 问题三：过度翻译\n\n```\n# 过度翻译\n请打开您的\"终端模拟器\"，运行\"节点包管理器\"的安装命令。\n\n# 正常写法\n请打开终端，运行 npm install。\n```\n\n### 问题四：中英标点混用\n\n```\n# 坏：中文句子用了英文逗号和句号\n请先安装依赖,然后运行测试.\n\n# 好：中文句子用全角标点\n请先安装依赖，然后运行测试。\n\n# 坏：英文内容用了中文标点\nRun `npm install`，then `npm test`。\n\n# 好：英文内容用半角标点\nRun `npm install`, then `npm test`.\n```\n\n### 问题五：缺乏结构化\n\n```\n# 坏：一大段文字没有分段\n本系统使用 Redis 做缓存提高查询性能同时使用 MySQL 做持久化存储\n数据写入时先写 MySQL 再异步更新 Redis 缓存读取时先查 Redis 如果\n未命中再查 MySQL 并将结果回写缓存设置过期时间为 30 分钟……\n\n# 好：用列表和分段组织信息\n本系统的缓存策略如下：\n\n- **存储层：** MySQL（持久化）+ Redis（缓存）\n- **写入流程：** 先写 MySQL，再异步更新 Redis\n- **读取流程：** 先查 Redis → 未命中则查 MySQL → 回写 Redis\n- **缓存过期：** TTL 设为 30 分钟\n```\n\n## 写作检查清单\n\n在发布文档前，逐项检查：\n\n### 排版\n\n- [ ] 中英文之间有空格\n- [ ] 中文与数字之间有空格\n- [ ] 中文语境使用全角标点\n- [ ] 英文/代码部分使用半角标点\n- [ ] 没有全角半角标点混用\n\n### 术语\n\n- [ ] 专有名词保留英文原文\n- [ ] 首次出现的术语标注了中英对照\n- [ ] 没有过度翻译业界通用术语\n- [ ] 术语使用前后一致\n\n### 内容\n\n- [ ] 句子简短，没有欧化长句\n- [ ] 没有不必要的被动语态\n- [ ] 用列表和表格组织结构化信息\n- [ ] 代码示例可以直接运行\n- [ ] 没有\"机翻味\"\n\n### 格式\n\n- [ ] 标题层级正确（不跳级）\n- [ ] 代码块标注了语言类型\n- [ ] 链接可以正常访问\n- [ ] 图片有 alt 文本","tags":["chinese","documentation","superpowers","jnmetacode","agent-skills","agentic-coding","ai-coding","claude-code","code-review","cursor","gemini-cli","kiro"],"capabilities":["skill","source-jnmetacode","skill-chinese-documentation","topic-agent-skills","topic-agentic-coding","topic-ai-coding","topic-chinese","topic-claude-code","topic-code-review","topic-cursor","topic-gemini-cli","topic-kiro","topic-mcp","topic-npm-package","topic-prompt-engineering"],"categories":["superpowers-zh"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/jnMetaCode/superpowers-zh/chinese-documentation","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add jnMetaCode/superpowers-zh","source_repo":"https://github.com/jnMetaCode/superpowers-zh","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 1857 github stars · SKILL.md body (6,159 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-03T00:52:45.528Z","embedding":null,"createdAt":"2026-04-18T21:55:53.553Z","updatedAt":"2026-05-03T00:52:45.528Z","lastSeenAt":"2026-05-03T00:52:45.528Z","tsv":"'+08':408 '-03':403 '-15':404 '/api/v1/orders':271 '/badge/build-passing-brightgreen.svg)]()':475 '/badge/license-mit-blue.svg)]()':470 '/changelog.md':527 '/contributing.md':541 '/docs/api.md':523 '/docs/faq.md':525 '/docs/guide.md':520 '/examples':531 '/license':569 '/sparanoid/chinese-copywriting-guidelines)':30 '/your-org/your-project.git':549 '0':387 '00':407,409 '1':305 '100':162 '12':49 '2':331 '20':488 '200':61,174 '2024':402 '20240315001':394 '3':47 '30':406,666,691 '32':72,79 '40001':419 '40002':428 '40003':433 '5':58 '8.0':490 '8080':171 '8601':380 '95':76,83 '99.00':450,457 '9900':399,446 'abc123':329 'addr':334 'address':306,313,332 'alt':722 'amount':364,370,398,445,456 'api':184,258,521 'apikey':510 'application/json':279 'auth':273 'await':516 'balanc':214 'bash':492,543 'bearer':274 'boot':130 'bug':51 'build':471 'c':73,80 'cent':372 'chines':2 'chinese-document':1 'ci/cd':188 'cli':186 'client':507 'client.dosomething':517 'clone':546 'code':316,321,337,386,412,414,439 'commit':193 'const':506,514 'content':277 'content-typ':276 'control':211,238 'coupon':315,320,336,435,438 'cpu':74,81 'creat':263,373,377,400 'data':390 'dead':228 'debounc':200 'descript':290,347,416 'detail':139 'dev':556 'document':3,136 'error':411 'exampl':324,384,530 'example.com':88,93,562,565 'expir':436 'field':284,343 'found':423 'git':36,192,545 'gitee.com':548 'gitee.com/your-org/your-project.git':547 'github.com':29 'github.com/sparanoid/chinese-copywriting-guidelines)':28 'http':172,195 'id':292,296,298,307,311,314,327,333,349,352,354,392,426 'img.shields.io':469,474 'img.shields.io/badge/build-passing-brightgreen.svg)]()':473 'img.shields.io/badge/license-mit-blue.svg)]()':468 'import':500 'instal':191,494,552,620,635,643 'insuffici':430 'integ':300,365 'iso':379 'issu':535 'jenkin':39 'json':197,325,385 'key':513 'kubernet':180 'letter':229 'licens':114,121,467 'load':213 'markdown':261,465 'mb':59 'messag':224,388 'method':267 'middlewar':202 'mit':111,118,568 'ms':62 'mysql':182,489,654,657,664,672,678,685 'new':508 'node.js':487 'npm':190,493,551,554,558,619,634,637,642,645 'ord':393 'order':264,348,353,358,391 'orm':187 'packag':497,505 'paid':361 'paramet':282,341 'path':270 'pend':360,396 'post':268 'prod':328 'product':291,297,326,421,425 'pull':537 'quantiti':299,303,330 'queue':225,230 'react':179 'readm':463 'readme.md':137,460 'redi':181,248,652,659,661,674,680,683,687 'request':281,323,538 'requir':288 'respons':340,383 'rest':198 'result':515 'run':555,633,641 'sdk':185 'see':134 'servic':240 'session':250 'ship':312,362 'skill' 'skill-chinese-documentation' 'source-jnmetacode' 'spring':129 'status':355,359,395,472 'stock':431 'string':293,308,317,350,356,375 'success':389 'suggest':418 'summer2024':338 't10':405 'tcp/ip':196 'test':559,638,646 'throttl':201 'token':101,106,275 'topic-agent-skills' 'topic-agentic-coding' 'topic-ai-coding' 'topic-chinese' 'topic-claude-code' 'topic-code-review' 'topic-cursor' 'topic-gemini-cli' 'topic-kiro' 'topic-mcp' 'topic-npm-package' 'topic-prompt-engineering' 'total':363,369,397,444,455 'ttl':689 'type':278,286,345 'typescript':499 'v2.1.0':169 'v3.2.0':131 'version':210 'xyz789':335 'your-key':511 'your-packag':495,503 'yourpackag':501,509 '一句话只说一件事':607 '一句话说不完':596 '一大段文字没有分段':650 '一股机翻味':16 '不出戏':21 '不符合中文表达习惯':575 '不要用中文数字写技术参数':164 '不说明单位':453 '不跳级':718 '专业':19 '专有名词':178 '专有名词保留英文原文':704 '个':50 '个并发连接':163 '个新功能和':48 '中文与数字之间加空格':44 '中文与数字之间有空格':698 '中文使用直角引号':141 '中文句子用了英文逗号和句号':624 '中文句子用全角标点':628 '中文技术文档写作规范':4,9 '中文技术文档最常见的问题不是内容不够':11 '中文排版规范':31 '中文文案排版指北':27 '中文模板':461 '中文语境使用全角标点':96,699 '中文语境用全角括号':124 '中英文之间加空格':33 '中英文之间有空格':697 '中英文挤在一起没有空格':14 '中英标点混用':622 '中英混排最佳实践':175 '也可以使用弯引号':147 '今天气温':71,78 '他说':154 '代码块标注了语言类型':719 '代码示例可以直接运行':713 '代码部分使用半角标点':701 '以内':63 '优惠券已过期':434 '优惠券码':319 '会话':256 '你想要':588 '使用':35,247,253 '使用git进行版本管理':42 '使用指南':519 '使用死信队列':227 '使用率':75,82 '例外':67 '依赖项目一':561 '依赖项目二':564 '保留业界通用英文术语':236 '保留英文的情况':177 '修复':52 '做':249,255 '做持久化存储':655 '做缓存提高查询性能同时使用':653 '元':451 '先写':677 '先查':682 '克隆项目':544 '免去手动配置构建工具链的麻烦':603 '全角半角混用':15 '全角标点与英文':107 '内容':708 '内容服务于读者':25 '再异步更新':658,679 '写作检查清单':693 '写入流程':676 '减少购买数量或稍后重试':432 '分':368,448 '分钟':667,692 '创建时间':376 '创建订单':262 '协议':112,119 '协议和标准':194 '单位':367,447 '即':449 '参数名':283,342 '参考':522 '参考标准':26 '取消':145,151 '句子简短':709 '句式欧化':592 '句式生硬':574 '后续出现直接使用':232 '否':318 '启动开发服务器':553 '告别机翻味':8 '命令和代码':189 '和':536 '响应参数':339 '响应时间控制在':60 '响应时间控制在200ms以内':66 '响应示例':382 '商品':295 '商品不存在':420 '回写':686 '国内开源项目常用的':462 '图片有':721 '在':237 '在发布文档前':694 '在控制器层做参数校验':244 '坏':41,53,64,77,90,102,116,165,242,252,452,623,631,649 '基本信息':265 '基本用法':498 '处理建议':417 '处理消费失败的消息':231 '多重从句':595 '好':34,45,56,70,85,97,109,222,235,246,442,627,639,668 '好读':20 '如果':662 '如果你想要获取更多信息':578 '存储层':671 '安装':491 '安装依赖':550 '官方文档':87,92 '实现异步通信':226 '实现持续集成':40 '尽量中文':217 '层做参数校验':239 '层处理业务逻辑':241 '嵌套引号':153 '帮助开发者快速搭建项目':602 '常见问题':524 '常见问题与避坑指南':570 '并将结果回写缓存设置过期时间为':665 '库存不足':429 '度数':68 '开发':132 '引号的使用':140 '强行翻译反而看不懂':243 '必填':287 '快速开始':485 '快速搭建现代化前端项目的脚手架工具':599 '或更换优惠券':440 '技术名词可保留英文':218 '技术文档中统一使用半角数字':160 '技术术语首次出现时':220 '把定语从句改成并列句':606 '括号内有英文或数字时用半角括号':127 '括号的使用':123 '持久化':673 '按钮':157 '按钮关闭弹窗':146,152 '按钮触发表单提交':144,150 '排版':5,696 '排版服务于阅读体验':23 '接口文档模板':260 '推荐':142 '描述性短语':209 '支持最多':161 '支持最多一百个并发连接':166 '收货地址':310 '数字':158 '数字与单位之间加空格':55 '数字之间不加空格':108 '数字使用半角字符':167 '数据写入时先写':656 '数据库':205 '文件':115,122 '文件大小不超过':57 '文件大小不超过5mb':65 '文本':723 '文档':518 '文档中英对照格式':259 '文档标题和章节名':216 '明确说明单位':443 '是':294,301,309 '是元还是分':458 '是否正确':427 '更多信息请参考文档':582 '更多示例请查看':529 '更新日志':526 '最小值为':304 '有公认翻译的通用概念':204 '服务器':206 '服务层处理业务逻辑':245 '未命中再查':663 '未命中则查':684 '本地开发':542 '本技能提供一套完整的中文技术文档写作规范':17 '本次更新包含':46 '本次更新包含3个新功能和12个bug修复':54 '本系统使用':651 '本系统的缓存策略如下':670 '本系统采用消息队列':223 '术语':6,703 '术语使用前后一致':707 '术语处理原则':176 '机翻味':572,576,715 '标注中英对照':221 '标点符号':95 '标题层级正确':717 '核心原则':22 '格式':381,716 '框架':208 '检查':424 '概述':10 '欢迎提交':534 '欧化句式':597 '正常中文':600 '正常写法':616 '没有':714 '没有不必要的被动语态':711 '没有全角半角标点混用':702 '没有公认中文翻译的术语':199 '没有欧化长句':710 '没有过度翻译业界通用术语':706 '注意':98,103 '浏览器':207 '浮点数会有精度问题':459 '消息队列的消费者需要实现幂等性':233 '然后运行测试':626,630 '版本号':168 '版本控制':212 '特征':573,593 '特性':478 '特性一':479 '特性三':483 '特性二':481 '状态码':173 '环境要求':486 '用于':586 '用列表和分段组织信息':669 '用列表和表格组织结构化信息':712 '百分比等不加空格':69 '的安装命令':615 '目录':532 '直接说':589 '确定':143,149,156 '示例':528 '移除':437 '空格':32 '端口号':170 '简短一句话介绍项目是什么':476 '简要描述':480,482,484 '简要说明':563,566 '类型':285,344 '纯英文内容用半角括号':133 '终端模拟器':612 '结构':464 '结构一步到位':7 '缓存':251,257,675 '缓存读取时先查':660 '缓存过期':688 '缺乏结构化':648 '翻译为中文的情况':203 '而是':12 '自然中文':580 '致谢':560 '节点包管理器':614 '英文':700 '英文内容用了中文标点':632 '英文内容用半角标点':640 '获取更多信息':89,94 '行业通用缩写':183 '被用来':585 '要点':583,604 '规范服务于一致性':24 '视团队规范而定':148 '解决什么问题':477 '订单':351 '订单总金额':366 '订单状态':357 '让你的文档':18 '许可证':567 '设为':690 '该接口需要鉴权':99,104 '该项目基于':128 '详见':113,120 '详见下方说明':126 '说明':289,346,415 '请先安装依赖':625,629 '请先获取':100,105 '请先阅读':539 '请参考':86,91 '请参考文档':579 '请打开您的':611 '请打开终端':617 '请求参数':280 '请求方式':266 '请求示例':322 '请求路径':269 '请点击':155 '请运行安装命令':125 '读取流程':681 '读起来别扭':13 '负载均衡':215 '贡献指南':533,540 '购买数量':302 '过度翻译':609,610 '运行':613,618 '运行测试':557 '这个函数用于计算用户折扣':581 '这个函数被用来计算用户的折扣':577 '这是一个前端脚手架工具':601 '这是一个可以帮助开发者在不需要手动配置复杂的构建工具链的情况下':598 '进行版本管理':37 '远程字典服务':254 '逐项检查':695 '造成歧义':454 '避免冗余代词':587 '避免直译英文句式':590 '避免被动语态':584 '避免过度翻译':234 '配合':38 '配合jenkins实现持续集成':43 '金额表示约定':441 '鉴权方式':272 '链接前后加空格':84 '链接可以正常访问':720 '错误码':410,413 '长句拆成短句':605 '长定语':594 '问题一':571 '问题三':608 '问题二':591 '问题五':647 '问题四':621 '阿拉伯数字':159 '项目使用':110,117 '项目名称':466 '首次出现标注翻译':219 '首次出现的术语标注了中英对照':705","prices":[{"id":"cd528a36-99db-4e40-b5d2-d3af2b8e7658","listingId":"c2fd9e6d-996d-4758-b710-2842633d27f1","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"jnMetaCode","category":"superpowers-zh","install_from":"skills.sh"},"createdAt":"2026-04-18T21:55:53.553Z"}],"sources":[{"listingId":"c2fd9e6d-996d-4758-b710-2842633d27f1","source":"github","sourceId":"jnMetaCode/superpowers-zh/chinese-documentation","sourceUrl":"https://github.com/jnMetaCode/superpowers-zh/tree/main/skills/chinese-documentation","isPrimary":false,"firstSeenAt":"2026-04-18T21:55:53.553Z","lastSeenAt":"2026-05-03T00:52:45.528Z"}],"details":{"listingId":"c2fd9e6d-996d-4758-b710-2842633d27f1","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"jnMetaCode","slug":"chinese-documentation","github":{"repo":"jnMetaCode/superpowers-zh","stars":1857,"topics":["agent-skills","agentic-coding","ai-coding","chinese","claude-code","code-review","cursor","gemini-cli","kiro","mcp","npm-package","prompt-engineering","skills","superpowers","tdd","trae"],"license":"mit","html_url":"https://github.com/jnMetaCode/superpowers-zh","pushed_at":"2026-04-28T15:32:18Z","description":"🦸 AI 编程超能力 · 中文增强版 — superpowers（116k+ ⭐）完整汉化 + 6 个中国原创 skills，让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 16 款 AI 编程工具真正会干活","skill_md_sha":"2988e95ef1f364ef8229dd2ed8bc0fff546a8b24","skill_md_path":"skills/chinese-documentation/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/jnMetaCode/superpowers-zh/tree/main/skills/chinese-documentation"},"layout":"multi","source":"github","category":"superpowers-zh","frontmatter":{"name":"chinese-documentation","description":"中文技术文档写作规范——排版、术语、结构一步到位，告别机翻味"},"skills_sh_url":"https://skills.sh/jnMetaCode/superpowers-zh/chinese-documentation"},"updatedAt":"2026-05-03T00:52:45.528Z"}}