AI DAILY / 2026-09-26
zh-tech-writing:基于阮一峰规范的中文技术文档写作Agent Skill
leter/zh-tech-writing
中文翻译暂未生成,以下为原文节选。
zh-tech-writing一个写中文技术文档的 Agent Skill。用它写 README、设计文档、接口说明和教程,读起来像工程师写的,没有 AI 腔。 规则基于阮一峰的《中文技术文档的写作规范》整理,另外补充了一份“AI 腔清单”。 适用于 Claude Code,以及其他支持 Agent Skills 的工具。 效果下面是一段常见的 AI 写法: 随着微服务架构的不断发展,配置管理已经成为一个不容忽视的问题。值得注意的是,ConfigHub 不仅提供了强大的配置管理能力,更实现了与现有系统的无缝集成——让你轻松应对各种复杂场景! 用这个 skill 以后: ConfigHub 用来集中管理多个服务的配置。修改配置后,服务会在 5 秒内加载新值,不用重启。接入时,在启动命令里加上--config-hub=<地址>即可。 改动有三处: 删掉开场套话和感叹号。 去掉“不仅……更……”这种句式和破折号。 用具体事实替换“强大”“无缝”这类形容词。 事实需要来自你的项目。skill 找不到事实时,会删掉空话,或者直接问你。 安装用skills命令行工具安装到全局: npx skills add leter/zh-tech-writing -g也可以手动安装。把skills/zh-tech-writing目录复制到~/.claude/skills/下面: git clone https://github.com/leter/zh-tech-writing.git cp -r zh-tech-writing/skills/zh-tech-writing~/.claude/skills/安装 autocorrect(推荐) autocorrect是一个命令行工具。它会自动在中英文之间补空格,并把中文句子里的半角标点改成全角。装了它,AI 写完文档后会按 skill 的要求运行一遍;没装就跳过这一步。 #macOS brew install autocorrect#Linux:从 Releases 页面下载二进制文件,放到 PATH 里的任意目录#https://github