用途:用于撰写与审校中文技术文档、产品文案和界面文案,统一表达风格与排版规范。主要能力:规定中英文、数字之间在正文中加空格,中文正文使用「」而非弯引号;禁止直接称呼读者(你/您/同学),避免营销式夸张与套话(赋能、抓手、闭环等);避免机械翻译英文状态词,如 Success 应写「请求已完成 / 操作成功」而非「成功」;统一术语大小写,如 ID、HTTP、URL、JSON、API、AI、JavaScript、HTML5、LLM、AIGC、RAG;可检出常见中文错别字,如阀值→阈值、登陆→登录、布署→部署等;并为落地页、API 与参数文档、错误码文档、FAQ、更新日志、按钮与界面文案给出结构规则。使用方式:通过 npx skills add https://github.com/Fenng/tech-doc-style-chinese 安装,可加 -a codex -g 做全局安装;也可用 git clone --depth 1 --branch v0.1.0.2.4 固定版本安装到 CODEX_HOME 下的 skills 目录,并用 test -f "$CODEX_HOME/skills/tech-doc-style-chinese/SKILL.md" && echo "installed" 验证。检查脚本运行:python scripts/lint_copy_rules.py,可指定文件或目录。在任务中显式引用,如 Use $tech-doc-style-chinese to rewrite this Chinese technical copy。适用场景:技术文档、接口与参数说明、错误码表、FAQ、更新日志、落地页与界面文案。限制:空格规则不适用于代码字面量、JSON 键、URL、API 路径、数据库字段名等机器可读标识;代码块内内容会被检查脚本跳过,若误报可将其移入代码块;项目专属约定建议写入 references/Project-Overrides.md,而非改动核心技能;安装后需重启 Codex 才能加载。收费与价格信息暂未提供。
tech-doc-style-chinese
写作与研究
更新于 10-15 23:43