一个 SKILL.md 如何变成 AI 写作助手?anti-defensive-writing 技能实现原理拆解
发布时间:2026/10/16 2:49:02 锦皓数字建站

【免费下载链接】anti-defensive-writingCodex skill for removing defensive writing and strengthening prose.项目地址https://gitcode.com/gh_mirrors/an/anti-defensive-writing点击查看免费下载anti-defensive-writing 是一个把写作规则写成 Markdown 指令的 Codex skill整个技能只有 SKILL.md 一个文件装进 Codex 或 Claude Code 后AI 就会变成一个反防御性写作助手——删掉多余的免责声明、口头禅式的弱化措辞和道歉式表达同时保留必要的范围限定与证据强度。这篇文章拆解它的实现原理文件怎么被触发、规则如何分层、五步重写流程如何落地以及它为什么零代码、零依赖。它解决什么问题什么是防御性写作学术论文和申请书中常见一种写法观点还没说先忙着声明本文不声称……我们并不认为……。这种防御性表达defensive writing会不断削弱说服力。SKILL.md 开头的一组对照最能说明问题防御性我们并不认为这些案例能够代表所有情境。 更直接这些案例展示了该机制在三种制度环境中如何运作。注意这个技能的目标不是把文章吹得满纸显著领先而是删掉只示弱、不提供信息的句子让表达更清晰、简洁、自信、有逻辑。仓库结构一览为什么核心只有一个文件整个仓库围绕单文件技能设计安装后进入技能目录的只有一个 SKILL.md文件作用SKILL.md技能正文唯一被安装的文件skill/anti-defensive-writing/SKILL.md可安装副本与根目录逐字一致skill.json包元数据名称、安装方式、安装清单install.sh / install.ps1macOS/Linux 与 Windows 的一行安装器examples/academic-introduction.md论文引言改写案例examples/methods-and-contributions.md方法与贡献陈述改写案例examples/grant-proposal.md基金申请书改写案例tests/test_install.py验证安装器行为与产物skill.json 中的installed_files: [SKILL.md]明确声明除了技能正文其他什么都不装。不下载仓库压缩包不需要 Git、Python 或任何包管理器。拆解 SKILL.md三层结构如何让规则生效SKILL.md 全文约 560 行按触发 → 核心规则 → 论文级扩充 → 中文版的顺序组织本质是一份写给 AI 的、可执行的操作手册。第一层YAML frontmatter——技能的触发条件SKILL.md 的开头是标准的 frontmattername: anti-defensive-writing description: Reduce defensive writing in drafts and revisions by removing unnecessary caveats...description不只是简介而是一串触发条件它罗列了删掉不必要的限定、免责声明、过度解释等动作也罗列了适用场景——论文、摘要、引言、贡献陈述、讨论、结论、基金申请、产品文案、政策文本……Agent 会先读description判断当前任务是否匹配匹配后才加载正文。所以写长而具体的 description是技能能否被正确触发的关键。第二层核心规则——把写好点翻译成五步流程正文的核心规则SKILL.md只有一句话直接推进你的主张Advance the claim directly。随后把怎么写拆成了可执行的步骤保留必要的限定SKILL.md给出 5 条判断标准——省略某限定是否影响观点成立、证据解读、适用范围、研究设计或读者正确使用结果。影响就保留且只说一次、放在方法或讨论部分。检测清单SKILL.md10 项自查如不必要的免责声明、叠加的保留措辞、以局限开头的段落、自毁式贡献陈述、多余的不是 X 而是 Y结构。重写流程SKILL.md五步——先给防御句分类免责声明 / 范围限定 / 真实局限 / 概念对比 / 证据限定 / 冗余澄清再删掉无信息量的把防御性局限改写成正向范围用精确性替换模糊 hedging最后围绕主旨重排段落。句式白名单与黑名单SKILL.md推荐本文研究……证据表明……避免本文并不声称……值得注意的是……。示例与最后检查SKILL.md多组 before/after 对照并要求输出前再删一遍只为防备假想质疑而存在的句子。这一层的精髓是把写作要好一点这种模糊要求变成了分类 → 检查 → 改写的确定性流程AI 才能一步步执行而不是自由发挥。第三层扩充规则——从句子级到整篇论文级Additional Rules 把视野从单句拉到整篇论文核心主线先确定论文的主要贡献新能力、新机制、降成本还是可扩展性摘要、引言、实验、结论都围绕它组织指标与主张某项指标落后时说清具体权衡如延迟从 100 ms 降至 60 ms准确率 89% 对比基线 90%而不是把单指标劣势写成对整个方法的否定每个实验的作用每个实验至少回答方法是否有效、优势来自哪里、能否排除其他解释、在什么条件下适用之一不利结果处理流程写清条件、指标与发现原因不明不编造解释中英文表达规则中文针对仅仅做了初步尝试仍有很大提升空间等习惯性谦辞英文针对 stacked hedges如 may potentially suggest...could possibly防事实虚构边界SKILL.md示例只教句式、不提供事实禁止为了让句子更有力而补造数据、机制或因果关系。SKILL.md 的后半部分是完整的中文版规则结构与前文一一对应保证中英文稿件都能按同一套标准改写。从文件到行为AI 是如何执行这个技能的整个技能没有任何可执行代码它的运行时就是 Agent 的提示词机制安装install.sh 只下载SKILL.md一个文件先校验首行是---确保 frontmatter 完整放进临时目录验证通过才替换旧安装——失败时原安装保持不动触发Agent 在技能目录中读取SKILL.md的description判断当前任务是否匹配写论文、改摘要、申请书中出现防御性表达执行匹配后正文被注入为写作指令AI 按检测清单 → 五步重写 → 最后检查的顺序处理你的文本。所以它的原理一句话概括用结构化的自然语言规则替代代码用清单式流程约束 AI 的自由度。这也解释了为什么 skill/anti-defensive-writing/SKILL.md 是根目录 SKILL.md 的逐字镜像——对 Agent 来说一个文件就是全部。三个真实案例改写前后的对比examples/ 收录了三组完整案例每组都标注了原文问题examples/academic-introduction.md论文引言从虽然这 modest 的初步研究无法解决长期争论……改为直接陈述研究发现并指出原文三个问题——开头长篇预防性道歉、模态词堆叠、过度解释显然的局限examples/methods-and-contributions.md方法贡献陈述从我们并不声称架构在所有基准上更优改为在标准 32k-token 基准上吞吐量提升 2.4 倍用量化数据替代表态examples/grant-proposal.md基金申请从我们当然不指望一夜之间改变……改为具体部署方案与精度指标把风险写进工程保障而不是写进犹豫。共同模式贡献前置、范围用证据界定、不确定性的来源说清楚——这正是 SKILL.md 规则的落地形态。安装后如何使用安装到对应技能目录后Codex 为~/.agents/skillsClaude Code 为~/.claude/skills项目级安装则用相对路径.agents/skills/.claude/skills直接以技能名调用Codex$anti-defensive-writing 修改下面的段落删掉多余的防御性表达保留必要限定不增加原文没有的事实。Claude Code/anti-defensive-writing …也可以直接对 Agent 说用 anti-defensive-writing 技能修改这段。如果安装后技能未出现重启 Agent 即可在网页聊天工具里则可以把 SKILL.md 直接粘贴或上传为写作指令无需安装。小结触发靠 descriptionfrontmatter 里的长描述既是技能说明也是触发条件规则分层核心规则管句子级重写扩充规则管整篇论文结构中文版一一对应流程化是关键分类 → 检测 → 改写 → 最后检查把主观审美变成可执行清单零代码零依赖一个 Markdown 文件就是全部技能安装器也只下发这一个文件。想动手验证可以从 examples/academic-introduction.md 的 Before 段落入手让装好技能的 Agent 改一遍对照 After 感受差异。赞分享【免费下载链接】anti-defensive-writingCodex skill for removing defensive writing and strengthening prose.项目地址https://gitcode.com/gh_mirrors/an/anti-defensive-writing点击查看免费下载相关推荐TREK 插件管理完全指南隔离原理、权限审查与安全部署的 5 个阶段TREK 插件管理完全指南隔离原理、权限审查与安全部署的 5 个阶段 TREK 插件系统让第三方代码在不改源码的前提下扩展你的自托管实例。本文以 Admin后端前端AI 应用深入拆解Antigravity Skills的SKILL.md结构一个AI Agent技能的完整解剖深入拆解Antigravity Skills的SKILL.md结构一个AI Agent技能的完整解剖 Antigravity Skills 是为 Google如何用 Claude Cowork 的 setup-writing-style 技能采集个人语料并生成写作风格 profile如何用 Claude Cowork 的 setup writing style 技能采集个人语料并生成写作风格 profile 当你让 Cowork 代你起草大模型人工智能提示工程上一篇把 QQ 空间发过的说说全部备份下来GetQzonehistory 一键导出 6 份 Excel 完整档案下一篇ARIS Manual Review MCP 服务器实战指南零 API 成本的人工中转跨模型评审创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
锦
锦皓数字建站
深耕本土企业品牌数字化升级,专注原创端正雅致商务官网,从视觉设计到稳定运维全程保驾护航。