关于 natural-writing
natural-writing 是一项用于撰写、改写和审查文本的技能,检查与 AI 生成文本相关的写作特征,并优先保证准确性、可读性和目标格式规范。
主要功能
- 01撰写、改写和审查文本
- 02应用 AI 写作特征清单
- 03改写时保留事实与作者语气
- 04检查引用和写作模式
- 05遵循目标格式规范
适用场景
- 01改写文本以提升自然度
- 02审查文本中的 AI 写作特征
- 03撰写文章、邮件或报告
- 04依据引用与风格规范检查文本
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ vivswan/ skills --skill natural-writing安装后在 Claude Code 中输入/natural-writing确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSE.mdREADME.md.codex-plugin/plugin.jsonagents/openai.yamlreferences/signs-catalog.mdwords-to-avoid.mdvale/AIVocabulary.ymlFormula.ymlPlainWords.ymlSignificance.ymlTrailingParticiple.ymlVocabulary.yml详细介绍
自然写作
根据 Wikipedia:AI 写作迹象,撰写能够避免文中所述 AI 写作迹象的文字。该页面是一本用于检测 AI 文本的指南。本技能将其转化为避免写出这些模式的规则。
单独出现一种模式可能没问题。目标是让这些模式不扎堆,也不让文字读起来像机器生成的。
适用范围:本技能是指导原则,不是铁律。读者能否快速浏览,优先于其中的任何风格规则(段落简短、重点前置,不堆砌文字,先给示例)。准确性和参考资料完整性规则始终适用。
如果目标代码库自身的文档规范允许使用带粗体标签的项目符号,请遵循该规范。此处关于粗体和项目符号的注意事项,适用于面向外部读者的文字。
何时使用
- 用户要求“让这段文字更像人写的”/“让这段文字听起来不那么像 AI”/“去掉 AI 痕迹”
- 用户问“这读起来像 AI 生成的吗?”
- 为代码库之外的读者起草或改写文字:文章、博客文章、报告、邮件、公告、PR 描述
- 不是编写代码库文档(README、指南、参考页面):这类面向程序员的页面应使用文档技能,例如
/working-text(如已安装) - 用户在任何写作任务中关注语气、风格或自然度
信息来源
迹象目录会随时间变化(模型会变化,社区也会发现新的迹象)。优先使用实时页面;无法访问时再使用随附快照:
- 实时页面:获取 https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing(原始维基文本:
https://en.wikipedia.org/w/index.php?title=Wikipedia:Signs_of_AI_writing&action=raw)。审查文字中的 AI 痕迹、用户要求全面检查,或随附快照看起来已不适用于当前主题时,请使用实时页面。 - 快照:references/signs-catalog.md 是完整页面的精简副本,并重新整理为写作规则。每次使用本技能时,都应将其作为工作核对清单。离线或日常起草时,使用该快照即可。
快照上次同步时间:2026-10-03,源自页面修订版 1378298730(2026-10-03T21:44:53Z)。如何更新快照,请参见下文“维护快照”。
references/words-to-avoid.md 列出了页面标记的词语和短语,按便于查阅的方式整理,并附有可直接使用的 grep 命令,用于机械检查。
这些列表也以 Vale 规则的形式收录在此技能的 vale/ 文件夹中(词汇、重要性、套话、句末分词结构);上游目录的文档 https://github.com/Vivswan/skills/blob/main/docs/vale.md 介绍了相关配置。
工作流
1. 加载规则
完整阅读 references/signs-catalog.md。对于审查或全面检查的请求,还应获取实时页面,并记录快照中尚未包含的迹象。
2. 选择模式
- 起草:撰写新文字。
- 改写:修改现有文字。保留作者的事实和风格,并尽可能保留原有结构。只去除痕迹,不要添加新主张。
- 审查:用户需要评估而非修改,因此除非用户提出要求,否则不要修改。指出出现了哪些迹象及其所在位置,并附简短引文。注意目录第 9 节中的误报提示(正式文风或语法完美本身并不能证明什么)。
3. 撰写或编辑
应用完整目录。价值最高的规则:
- 直陈事实,使用 is/are/has/was。不要用 "serves as"、"stands as"、"boasts"、"features"、"marks"、"represents" 或 "refers to" 这样的开头。
- 删去夸大的重要性表述:"pivotal moment"、"testament to"、"underscores its importance"、"reflects broader trends"、"rich cultural heritage"、"evolving landscape"。用具体、可核查的事实替代笼统的重要性说法。关键在于具体。
- 去掉句末的分词分析。 不要用句末的 "-ing" 从句发表评述,例如 "…, highlighting the significance of X"、"…, ensuring Y"。
- 避免 AI 词汇扎堆:delve、crucial、pivotal、tapestry、landscape(抽象意义)、showcase、underscore、intricate、fostering、garner、meticulous、vibrant、robust、boasts、align with、testament。单个词或许没问题,但扎堆使用就会露出痕迹。参见词汇表。
- 打破模板。 不要用 "not just X, but Y" 或 "It's not X, it's Y" 这样的平行结构,也不要到处罗列三个一组的事物。不要以 "Despite these challenges…" 收尾,不要用 "In summary / In conclusion / Overall" 总结,也不要写 "It's important to note"。
- 精准注明来源,否则不注明。 不要写 "experts argue"、"observers have noted"、"industry reports suggest"。写明来源,否则删去相关说法;只有一个来源时,绝不要暗示有多个来源。
- 不要用破折号作标点。 不要用 em dash(—),也不要用 en dash(–)或带空格的连字符( - )换个字符表达同样的结构。改用逗号、冒号、括号,或拆成两个句子。连字符只用于复合词,en dash 只用于数字范围。
- 采用自然的格式。 先写正文,只有内容确实适合枚举时才用列表。标题使用句首字母大写格式,几乎不要加粗。不要让列表中的每一项都采用“加粗标签加冒号”的格式,不要用表情符号装饰,不要加无必要的小表格,不要在标题前加水平线,不要跳过标题级别。
- 不要留下聊天痕迹。 不要用 "I hope this helps"、"Certainly!"、"Would you like…"、"Here is a…" 这样的开场或结尾,不要写知识截止时间说明,也不要指导读者如何看待来源,例如 "should be treated as X rather than Y"。不要把猜测说成事实,例如 "details are not widely documented, but likely…"。不要留下未填写的占位符,例如
[Your Name]或2025-XX-XX。 - 使用目标媒介的标记语法,不要使用面向非 Markdown 目标的 Markdown。不要编造引文、链接、DOI、ISBN 或页码。核实输出中的每条参考资料,并清除工具残留内容(
utm_source=、turn0search0、oaicite、[cite: 1])。 - 变换节奏,自然重复词语。 自然地重复同一个名词,比轮换使用近义词更好。句子长短要有变化。明确陈述事实("was the first"),使用简单的动词(wrote、used、moved、tried、died)。
本技能的破折号规则(7)比 Wikipedia 页面更严格,后者只反对过度使用。目标文本的风格指南优先于此规则。
4. 自查
提交前,按照上述清单重新阅读输出。对照 references/words-to-avoid.md 中的词汇表进行检查(这些词汇表供阅读使用,不适用于 grep -f)。有两项检查可以机械执行,请在草稿文件上运行:
# Dash punctuation and machine artifacts: any hit outside quoted material is a bug, unless the destination's style guide calls for that dash.
# (Unspaced en dashes in numeric ranges like 2024–2025 are allowed and not flagged.)
grep -nE '—| – | - |turn0|oaicite|oai_citation|contentReference|attributableIndex|attached_file|grok[_-]|(start|end)_span|ppl-ai-file-upload|【|\[cite:|\[web:[0-9]|:::writing|utm_source=(chatgpt\.com|openai|copilot\.com)|referrer=grok\.com|↩|XX-XX|INSERT_|PASTE_' draft.md
# High-signal AI vocabulary: hits are prompts to reread the sentence, not automatic errors
grep -inE 'delve|deep dive|tapestry|testament|pivotal|crucial|underscor|showcas|foster(ing|s)|garner|meticulous|vibrant|intrica|boasts|bolster|interplay|stands as|serves as|not just|not only' draft.md
发现匹配项后,应改写句子,不要只换成同义词。问题在于背后的模式(含糊、浮夸、套话),而不是词语本身。
5. 报告
- 草稿/改写:提交文本。如果进行了改写,用一两句话概述去掉了哪些特征。
- 审查:列出发现的特征及其位置和引文,说明整体评价,并注明基准率限制:这些是统计特征,并非定论。
无网络时的备用方案
所有功能都可通过 references/signs-catalog.md 和 references/words-to-avoid.md 离线使用。此时只跳过实时刷新步骤。
维护快照
当收到从 Wikipedia 更新此技能的请求(或快照看起来已过时)时,请进行语义上的核对。目录是经过重新整理的精简内容,因此与 wikitext 进行文本差异比较没有意义。
-
检查页面自固定的修订版本以来是否有更改:
curl -fsSL 'https://en.wikipedia.org/w/api.php?action=query&titles=Wikipedia:Signs_of_AI_writing&prop=revisions&rvprop=ids|timestamp&format=json'如果
revid与上方“Source of truth”下固定的修订版本相同,则无需操作。 -
否则,获取并阅读当前完整的 wikitext:
curl -fsSL 'https://en.wikipedia.org/w/index.php?title=Wikipedia:Signs_of_AI_writing&action=raw' -o /tmp/signs.txt -
按章节与
references/signs-catalog.md进行比较。纳入新增的标志,删除已移除的标志,并相应更新references/words-to-avoid.md。 -
在两处更新固定的修订版本 ID、时间戳和同步日期:此文件中的“Source of truth”下方,以及
references/signs-catalog.md的标题中。两处固定信息必须一致。