[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78BGAATT87X7N2RHERM2EST":3,"skill-same:01M78BGAATT87X7N2RHERM2EST":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":15,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M78BGAATT87X7N2RHERM2EST","zh-tech-writing",null,"中文技术文档写作规范。写或修改中文技术文档、开发文档（README、设计文档、接口说明、教程）时使用。","Ghost233\u002Fghost-agent-market","Ghost233","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F888208?v=4","01M78BD4FT9J35NN2PD8TPFMQ7","01M78BD4GJ5HRGACGPP3DKSQFH",0,"MIT","https:\u002F\u002Fgithub.com\u002FGhost233\u002Fghost-agent-market\u002Fblob\u002Fmain\u002Fcodex-market\u002Fplugins\u002Fghost-agent-skills\u002Fskills\u002Fzh-tech-writing\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FGhost233\u002Fghost-agent-market\u002Fblob\u002Fmain\u002Fcodex-market\u002Fplugins\u002Fghost-agent-skills\u002Fskills\u002Fzh-tech-writing\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: zh-tech-writing\ndescription: 中文技术文档写作规范。写或修改中文技术文档、开发文档（README、设计文档、接口说明、教程）时使用。\n---\n\n# 中文技术文档写作\n\n目标：写出像资深工程师写的中文技术文档。**平实**、**具体**、**短句**。\n\n## 流程\n\n**写新文档：**\n\n1. 先想清楚读者是谁，读完要能做成什么事。一句话说不清，先问用户。\n2. 按下面的“句子”“语气”“段落与结构”“排版”写。\n3. 自检：拿“AI 腔清单”逐条对照全文，命中的全部改掉。\n4. 跑 `autocorrect --fix \u003C文件>`，修空格和标点。命令不存在就跳过，改为按“排版”手动检查。\n5. 手动检查 autocorrect 管不到的：引号、省略号、破折号。\n\n**修改已有文档：**\n\n1. 通读全文，再动手。\n2. 用户只要意见：按“原句 → 改后 → 原因”列出问题，不改文件。\n3. 否则直接改，然后做上面的第 3～5 步。最后用两三句话说明改了哪几类问题。\n\n每一步都做完才算完成。第 3 步的标准是：清单每一条都对照过，全文没有命中。\n\n## 句子\n\n- 用逗号隔开的每一截，尽量在 20 字以内。超过 30 字就拆开。整句不超过 100 字。\n- 一句只说一个意思。多用简单句和并列句，把长定语拆出去。\n  - 差：那个昨天生病的人没有参加会议。\n  - 好：他昨天生病了，没有参加会议。\n- 用肯定句，不用双重否定。\n  - 差：请确认没有接通装置的电源。 → 好：请确认装置的电源已关闭。\n  - 差：没有删除权限的用户，不能删除此文件。 → 好：用户必须有删除权限，才能删除此文件。\n- 用主动语态，少用“被”。\n  - 差：假如此软件尚未被安装 → 好：假如还没安装这个软件\n- 动词直接用，不套“进行”“做出”。\n  - 差：对配置文件进行修改 → 好：修改配置文件\n- “这”“其”“该”只指一个明确的对象。可能有歧义就把名词重复一遍。\n- 名词前的修饰语不超过两层，多了就拆成两句。\n- 用现代汉语常用词，不用文言、生造词。\n  - 差：这是唯二的方法。 → 好：只有这两种方法。\n- 分清“的、地、得”：开心的笑容、开心地笑、笑得开心。\n\n## 语气\n\n- 像给同事讲清楚一件事：口语化可以，网络流行语不用。\n- 称呼读者用“你”，称呼项目方用“我们”。\n- 用陈述语气，句末用句号。\n- 用事实代替形容词：给出数字、命令、文件名、报错原文。\n  - 差：性能得到了大幅提升。\n  - 好：p99 延迟从 120 ms 降到 40 ms。\n- 确定的事直接说。不确定就说清楚哪里不确定、怎么验证。\n\n## 段落与结构\n\n- 每段第一句说这段的重点，后面的句子为它服务。一段一个主题。\n- 一段最好不超过 4 行，最多 7 行。\n- 标题用二级、三级为主：\n  - 一级标题下直接接二级，不跳级。\n  - 同级标题只有一个时，去掉这层标题。\n  - 下级标题不重复上级标题的名字。\n  - 需要四级标题时，改用 `**（1）xxx**` 或列表。\n  - 标题末尾不加句号、逗号、冒号。\n- 列表只放真正并列、可以单独扫读的条目。有因果、转折关系的内容，写成段落。\n- 加粗只给读者必须注意的警告或关键词，一屏最多一两处。\n- 引用别人的内容或图片，注明出处。\n\n## 排版\n\n每篇都要守的规则：\n\n- 中文与英文、数字之间加一个半角空格：`在 Linux 上安装 5 个包`。\n- 中文句子用全角标点：`，。：；？（）`。整句是英文时用半角标点。\n- 英文、数字后面紧跟全角标点时，中间不加空格：`他用的是 MacBook Air。`\n- 引号用全角 `“ ”`，引号里再套引号用 `‘ ’`。\n- 并列的词用顿号 `、` 隔开，最后一项用“和”连接：`Google、腾讯和百度`。\n- 省略号写成 `……`，不写 `...` 或 `。。。`，也不和“等”连用。\n- 数字一律用半角。\n\n数字（千分位、单位、范围、倍数）、括号、冒号、连接号、英文缩写的细则，见 [references\u002Ftypography.md](references\u002Ftypography.md)。文档里出现这些内容时读它。\n\n写一整套产品手册或文档站、需要规划目录和文件名时，读 [references\u002Fmanual-structure.md](references\u002Fmanual-structure.md)。\n\n## AI 腔清单\n\n自检时逐条对照。左边是要找的写法，右边是改法。\n\n| 找这种写法 | 改成 |\n|---|---|\n| 开场套话：“随着……的发展”“在当今……”“值得注意的是”“需要指出的是”“让我们来看看”“接下来我们将介绍” | 删掉，第一句直接说内容 |\n| 结尾套话：“总的来说”“综上所述”“总而言之”，或重复前文的总结段 | 删掉。确实需要结尾，只写新信息，比如下一步做什么 |\n| 客套话：“希望对你有帮助”“如有问题欢迎交流” | 删掉 |\n| 对比句式：“不是 A，而是 B”“与其说 A，不如说 B” | 直接说 B |\n| 递进句式：“不仅……而且\u002F更……” | 拆成两个陈述句 |\n| 硬凑三个：三个排比形容词、每组都是三项的列表 | 有几项写几项 |\n| 设问自答：“关键是什么？答案很简单：”“原因很简单：” | 直接给结论 |\n| 宣传腔形容词：强大、灵活、无缝、全面、极致、优雅、轻松、一站式 | 换成具体事实，没有事实就删 |\n| 黑话：赋能、抓手、闭环、链路、沉淀、对齐、颗粒度、维度、底层逻辑、范式、打通 | 换成白话。代码或业务里的正式名称（如“调用链路”）保留 |\n| 破折号 `——` 用来插入解释 | 改用逗号、冒号、括号，或拆成两句。全文最多一两处 |\n| 翻译腔：“进行 + 动词”“通过……的方式”“作为一个……”、一句里多个“的” | 直接用动词，拆开长定语 |\n| 过度含糊：“在某种程度上”“在一定情况下可能会” | 确定就直接说；不确定就说清条件 |\n| 感叹号、emoji 标题或列表符号 | 句号，纯文字标题 |\n| 每段都加粗、一两句话也拆成列表、小标题比段落还密 | 按“段落与结构”重排 |\n","# 中文技术文档写作\n\n目标：写出像资深工程师写的中文技术文档。**平实**、**具体**、**短句**。\n\n## 流程\n\n**写新文档：**\n\n1. 先想清楚读者是谁，读完要能做成什么事。一句话说不清，先问用户。\n2. 按下面的“句子”“语气”“段落与结构”“排版”写。\n3. 自检：拿“AI 腔清单”逐条对照全文，命中的全部改掉。\n4. 跑 `autocorrect --fix \u003C文件>`，修空格和标点。命令不存在就跳过，改为按“排版”手动检查。\n5. 手动检查 autocorrect 管不到的：引号、省略号、破折号。\n\n**修改已有文档：**\n\n1. 通读全文，再动手。\n2. 用户只要意见：按“原句 → 改后 → 原因”列出问题，不改文件。\n3. 否则直接改，然后做上面的第 3～5 步。最后用两三句话说明改了哪几类问题。\n\n每一步都做完才算完成。第 3 步的标准是：清单每一条都对照过，全文没有命中。\n\n## 句子\n\n- 用逗号隔开的每一截，尽量在 20 字以内。超过 30 字就拆开。整句不超过 100 字。\n- 一句只说一个意思。多用简单句和并列句，把长定语拆出去。\n  - 差：那个昨天生病的人没有参加会议。\n  - 好：他昨天生病了，没有参加会议。\n- 用肯定句，不用双重否定。\n  - 差：请确认没有接通装置的电源。 → 好：请确认装置的电源已关闭。\n  - 差：没有删除权限的用户，不能删除此文件。 → 好：用户必须有删除权限，才能删除此文件。\n- 用主动语态，少用“被”。\n  - 差：假如此软件尚未被安装 → 好：假如还没安装这个软件\n- 动词直接用，不套“进行”“做出”。\n  - 差：对配置文件进行修改 → 好：修改配置文件\n- “这”“其”“该”只指一个明确的对象。可能有歧义就把名词重复一遍。\n- 名词前的修饰语不超过两层，多了就拆成两句。\n- 用现代汉语常用词，不用文言、生造词。\n  - 差：这是唯二的方法。 → 好：只有这两种方法。\n- 分清“的、地、得”：开心的笑容、开心地笑、笑得开心。\n\n## 语气\n\n- 像给同事讲清楚一件事：口语化可以，网络流行语不用。\n- 称呼读者用“你”，称呼项目方用“我们”。\n- 用陈述语气，句末用句号。\n- 用事实代替形容词：给出数字、命令、文件名、报错原文。\n  - 差：性能得到了大幅提升。\n  - 好：p99 延迟从 120 ms 降到 40 ms。\n- 确定的事直接说。不确定就说清楚哪里不确定、怎么验证。\n\n## 段落与结构\n\n- 每段第一句说这段的重点，后面的句子为它服务。一段一个主题。\n- 一段最好不超过 4 行，最多 7 行。\n- 标题用二级、三级为主：\n  - 一级标题下直接接二级，不跳级。\n  - 同级标题只有一个时，去掉这层标题。\n  - 下级标题不重复上级标题的名字。\n  - 需要四级标题时，改用 `**（1）xxx**` 或列表。\n  - 标题末尾不加句号、逗号、冒号。\n- 列表只放真正并列、可以单独扫读的条目。有因果、转折关系的内容，写成段落。\n- 加粗只给读者必须注意的警告或关键词，一屏最多一两处。\n- 引用别人的内容或图片，注明出处。\n\n## 排版\n\n每篇都要守的规则：\n\n- 中文与英文、数字之间加一个半角空格：`在 Linux 上安装 5 个包`。\n- 中文句子用全角标点：`，。：；？（）`。整句是英文时用半角标点。\n- 英文、数字后面紧跟全角标点时，中间不加空格：`他用的是 MacBook Air。`\n- 引号用全角 `“ ”`，引号里再套引号用 `‘ ’`。\n- 并列的词用顿号 `、` 隔开，最后一项用“和”连接：`Google、腾讯和百度`。\n- 省略号写成 `……`，不写 `...` 或 `。。。`，也不和“等”连用。\n- 数字一律用半角。\n\n数字（千分位、单位、范围、倍数）、括号、冒号、连接号、英文缩写的细则，见 [references\u002Ftypography.md](references\u002Ftypography.md)。文档里出现这些内容时读它。\n\n写一整套产品手册或文档站、需要规划目录和文件名时，读 [references\u002Fmanual-structure.md](references\u002Fmanual-structure.md)。\n\n## AI 腔清单\n\n自检时逐条对照。左边是要找的写法，右边是改法。\n\n| 找这种写法 | 改成 |\n|---|---|\n| 开场套话：“随着……的发展”“在当今……”“值得注意的是”“需要指出的是”“让我们来看看”“接下来我们将介绍” | 删掉，第一句直接说内容 |\n| 结尾套话：“总的来说”“综上所述”“总而言之”，或重复前文的总结段 | 删掉。确实需要结尾，只写新信息，比如下一步做什么 |\n| 客套话：“希望对你有帮助”“如有问题欢迎交流” | 删掉 |\n| 对比句式：“不是 A，而是 B”“与其说 A，不如说 B” | 直接说 B |\n| 递进句式：“不仅……而且\u002F更……” | 拆成两个陈述句 |\n| 硬凑三个：三个排比形容词、每组都是三项的列表 | 有几项写几项 |\n| 设问自答：“关键是什么？答案很简单：”“原因很简单：” | 直接给结论 |\n| 宣传腔形容词：强大、灵活、无缝、全面、极致、优雅、轻松、一站式 | 换成具体事实，没有事实就删 |\n| 黑话：赋能、抓手、闭环、链路、沉淀、对齐、颗粒度、维度、底层逻辑、范式、打通 | 换成白话。代码或业务里的正式名称（如“调用链路”）保留 |\n| 破折号 `——` 用来插入解释 | 改用逗号、冒号、括号，或拆成两句。全文最多一两处 |\n| 翻译腔：“进行 + 动词”“通过……的方式”“作为一个……”、一句里多个“的” | 直接用动词，拆开长定语 |\n| 过度含糊：“在某种程度上”“在一定情况下可能会” | 确定就直接说；不确定就说清条件 |\n| 感叹号、emoji 标题或列表符号 | 句号，纯文字标题 |\n| 每段都加粗、一两句话也拆成列表、小标题比段落还密 | 按“段落与结构”重排 |\n",{"name":5,"description":7},"main","cd29de78be377945ec163da4ca4516fd95e20300","codex-market\u002Fplugins\u002Fghost-agent-skills\u002Fskills\u002Fzh-tech-writing","https:\u002F\u002Fgithub.com\u002FGhost233\u002Fghost-agent-market","https:\u002F\u002Fgithub.com\u002FGhost233","2026-11-13 18:58:32",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add Ghost233\u002Fghost-agent-market --skill zh-tech-writing",{"tool":36,"command":37},"bunx","bunx skills add Ghost233\u002Fghost-agent-market --skill zh-tech-writing",{"tool":39,"command":40},"pnpm","pnpm dlx skills add Ghost233\u002Fghost-agent-market --skill zh-tech-writing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FGhost233\u002Fghost-agent-market\u002Fblob\u002Fmain\u002Fcodex-market\u002Fplugins\u002Fghost-agent-skills\u002Fskills\u002Fzh-tech-writing\u002FSKILL.md",true,[44,50,54,58],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"agents\u002Fopenai.yaml","REFERENCE","参考文档",271,"https:\u002F\u002Fgithub.com\u002FGhost233\u002Fghost-agent-market\u002Fblob\u002Fmain\u002Fcodex-market\u002Fplugins\u002Fghost-agent-skills\u002Fskills\u002Fzh-tech-writing\u002Fagents\u002Fopenai.yaml",{"path":51,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":15},"LICENSE","许可证",1067,{"path":55,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fmanual-structure.md",1362,"https:\u002F\u002Fgithub.com\u002FGhost233\u002Fghost-agent-market\u002Fblob\u002Fmain\u002Fcodex-market\u002Fplugins\u002Fghost-agent-skills\u002Fskills\u002Fzh-tech-writing\u002Freferences\u002Fmanual-structure.md",{"path":59,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Ftypography.md",2379,"https:\u002F\u002Fgithub.com\u002FGhost233\u002Fghost-agent-market\u002Fblob\u002Fmain\u002Fcodex-market\u002Fplugins\u002Fghost-agent-skills\u002Fskills\u002Fzh-tech-writing\u002Freferences\u002Ftypography.md",[63],{"skillNo":64,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":65,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M78BE7HV1GV72D58EAMAVRVR","https:\u002F\u002Fgithub.com\u002FGhost233\u002Fghost-agent-market\u002Fblob\u002Fmain\u002Fclaude-code-market\u002Fplugins\u002Fghost-agent-skills\u002Fskills\u002Fzh-tech-writing\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FGhost233\u002Fghost-agent-market\u002Fblob\u002Fmain\u002Fclaude-code-market\u002Fplugins\u002Fghost-agent-skills\u002Fskills\u002Fzh-tech-writing\u002FSKILL.md",[],[]]