用途：avoid-ai-writing 是一项写作编辑技能，目标是识别并清理让文字显得像机器生成的"AI 写作痕迹"（AI-isms）。技能说明强调它只是写作质量工具，不是判定作者身份的结论：这些模式在 LLM 输出中更常见，但赶稿的真人、非母语写作者和某些技术文体也会出现类似特征，因此不应把标记结果作为学术诚信、招聘、出版或署名等重大决定的唯一依据。
主要能力：技能分为三种模式。rewrite 为默认模式，先审计并指出具体 AI-isms 所在文本，再返回清理后的版本，并简要说明改动及原因。detect 只标记不改写，适合作者想自行决定修改内容、模式可能是有意为之、文本不宜改动或只想快速扫描的情况。edit 针对用户指定的文件就地修改，用最小范围、针对性的编辑处理被标记的片段，保留已具人味的段落，不改动引文、代码块或他人署名的文字，修改后重新读取文件确认问题已解决。
使用方式：直接用自然语言即可触发，例如要求改写为某种语气、就地编辑某个文件、或只扫描不改写。进阶用户可传入选项：--mode rewrite|detect|edit、--voice casual|professional|technical|warm|blunt、--context linkedin|blog|technical-blog|investor-email|docs|casual、--file PATH、--iterate N（上限 2）。rewrite 模式本身已含一次纠正性第二遍，因此 --iterate 不会在其上叠加；当用户要求反复迭代直到干净时，重复审计到改写循环，直到无标记或达到 N 遍，并报告用了几遍。
检查范围：格式方面，要求替换破折号（— 与 --），每千字最多一个，标题同样适用，但列表项中以粗体词或 Markdown 链接开头的分隔破折号属排版用法不计入；削减粗体滥用，每个主要章节最多一处；删除标题中的 emoji（社交帖子可少量使用）；把堆砌的列表改为段落；弯引号与弯撇号视为弱信号，仅在纯文本/代码情境中建议改为直引号，已发表内容与符合语言习惯的标点保留；随意语境中过度工整的排版也只作佐证信号，反向而言，编辑他人随意文本时应保留其错别字与个人化大小写。句法方面，限制"不是 X 而是 Y"结构（含拆成两句的变体与多重否定倒数），削减空洞强调词、模糊背书（worth reading 等）、模糊限定、缺失的段落衔接，以及强迫性三段式。词汇分为三级：Tier 1 始终替换，其中 1A 为 AI 高频标记词（delve、landscape、tapestry、robust、leverage、pivotal、seamless、game-changer 等，附替换建议），1B 为清晰度编辑（utilize、in order to、due to the fact that、commence、ascertain 等），技能明确 1B 命中不构成机器写作证据，检测时应与 1A 分开报告；Tier 2 在同一段落出现两个及以上时才标记；Tier 3 按密度标记，约占全文 3% 以上时处理。技能也说明匹配词形变化，并举例 load-bearing 需带连字符才算痕迹、修饰实体结构名词时为正常建筑术语不标记，谓语用法仍会误报。
适用场景与限制：适合作者清稿、审阅稿件可读性、判断文本是否读起来像 AI 生成，以及在不改动原文的前提下做扫描。限制包括：标记是信号而非证明，非母语写作、赶稿文本和技术文体可能触发规则；部分 1A 词频倍数是沿用既有说法而非本仓库实测；个别规则存在已知误报；技能不承诺检测准确率或规避任何检测工具。文档中提及的检测器误报率等外部研究数据属背景说明，本条目不作效果保证。工具形态为 Claude Code 技能，具体安装与托管方式暂未提供。