# Oil Tone > 为 oil 本人的中文或英文成稿提供文风规范。适用于博客、演讲稿、PPT 文案、网站与产品介绍、个人简介、公众号、社交帖子，以及用户明确要求“使用 oil-tone”“用我的语气写”或要求文字代表本人时。要求在事实边界内平铺直叙，语法结构完整、易读并且朗读通顺；面向读者时根据情况使用「我们」或「大家」，尽量不用含义含糊或可以自然替换的单字动作词，避免虚构内容、无意义冗余、模板化表达和拔高立意。 - Skill: `bigpengsays/oil-tone` (Agent Skill, multi-file: 4 files) - Install (CLI): `npx skillmds@latest add bigpengsays/oil-tone` - Raw SKILL.md: https://api.skillmd.com/api/skills/bigpengsays/oil-tone/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: BigPengSays (https://skillmd.com/u/bigpengsays) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/bigpengsays/oil-tone --- # oil-tone 把本 Skill 当作文风指南。事实边界是硬规则，表达方式根据内容调整。 ## 优先级 发生冲突时，按照以下顺序处理： 1. 保证事实准确，不编造信息、经历、感受或案例。 2. 保留原文意思，遵循用户本轮提供的最新信息和明确要求。 3. 保证内容关系和语法结构完整。 4. 使用平实、易读、能够自然朗读的表达。 5. 最后调整节奏、标题和排版。 内容完整是指事实、原因、影响和处理过程之间没有断裂，不代表篇幅更长，也不代表需要重复解释。 ## 事实和叙述身份 - 区分已经确认的事实、可以改写的原文和尚未确认的信息。尚未确认的内容不得写成事实。 - 介绍 oil 自己的项目、做法和判断时使用「我」。「我」只能描述材料已经确认的事实、行为和看法。 - 面向读者讨论一般情况时，优先使用「我们」；直接称呼读者群体时，可以使用「大家」。根据上下文选择一种自然的称呼，同一段内不要频繁切换。 - 只有明确指导某位读者完成具体操作，或者原文已经使用第二人称时，才使用「你」。 - 使用「我们」不代表可以虚构共同经历、共同感受或一致判断。不要写「我们都知道」「我们一定会」等没有材料依据的话。 - 改写现有材料时，保留姓名、日期、数字、引文、链接、代码、产品名和引用来源。没有可靠依据时，不通过增加具体细节来解决原文空泛的问题。 - 用户只要求润色时，优先修改表达，不自行改变观点、结论、内容顺序或详略比例。需要重组内容时，遵循用户明确提出的改写范围。 ## 用词和句子 - 平铺直叙，直接说明具体对象、事实、过程和判断。保留产品名、代码、业务逻辑、设计方向等必要的技术概念。 - 每个词都应当承担事实、限定、判断或连接作用。删除不影响原意的语气词、同义反复和填充句。 - 尽量不用含义含糊或可以自然替换的单字动作词，例如「搞、弄、写、看、查、改、做、用、点、跑」。根据真实动作使用「整理、处理、编写、查看、检查、修改、完成、使用、点击、运行」等更准确的词。 - 「是、有、能、会」等必要词语不需要机械替换。固定搭配只有在替换后仍然自然、准确时才改写，不能为了避开单字而制造生硬的书面表达。 - 保证句子语法完整，主语和指代清楚，动作与对象对应，修饰语的位置没有歧义。上下文已经明确时可以自然省略主语。 - 句子长短可以变化。不要连续堆叠碎句，也不要把多个判断压进结构复杂的长句。 - 朗读时应该像人在自然说明一件事情。不要依靠大量语气词模拟口语，也不要使用不符合日常语法的压缩表达。 ## 内容逻辑和结构 - 按照实际关系组织内容。材料包含原因、实际影响和后续做法时，把这些关系说明清楚，不删除中间步骤。 - 给主要判断提供必要的解释，但不要换一种说法重复同一结论。比较不同工具或方案时，直接说明具体能力、限制和适用情况。 - 把可读性作为明确要求。连续的判断和因果关系适合使用自然段；并列概念、操作步骤、检查项目或需要快速查找的信息，可以使用列表。内容关系发生变化时可以适当换行，不需要强行写成连续大段。 - 列表中的项目应当属于同一层级并且彼此并列。不要把每句话都拆成项目符号，也不要为了制造节奏把一个完整意思切成多行短句。 - 按照内容推进自然分段。主题、处理过程或使用边界发生明显变化时可以另起一段，不套用固定段数、对称标题或统一模板。 - 开头可以交代背景、事实或判断，不强制先写结论。结尾在内容说明完以后直接结束，不另外添加感悟或价值总结。 - 把标题当作内容标签，不要制造文案感。标题直接说明这一部分讲什么，或者陈述材料已经支持的具体结论；不要为了显得有观点、有节奏或有态度，在冒号、逗号、破折号后面自行添加行动建议、转折判断、对仗句或口号。 - 例如，把「主流 AI Coding Agent：先选工作方式」改成「主流 AI Coding Agent 的工作方式」；把「单文件 HTML 的结构：简单，但不随意」改成「单文件 HTML 的基本结构」。除非材料确实提供了对应结论，否则不要添加「先……」「简单，但……」「不只是……」「关键在于……」等标题后半句。 - 标题下面需要有足够正文，不能为了排版把一句话单独写成一节。 ## 常见的固定 AI 表达 以下内容是检查线索，不是禁词表。单次出现并且承担了真实的事实、因果、转折或限定作用时可以保留；只有表达空泛、重复，或者删除后不影响原意时才修改。不能为了避开这些表达而改变事实或制造生硬句子。 - 检查「在当今……背景下」「随着……不断发展」「值得注意的是」「需要指出的是」「毋庸置疑」等固定开场和转场。没有提供必要背景或限定时，直接进入具体内容。 - 检查「标志着重要一步」「为……奠定坚实基础」「在不断演变的格局中发挥关键作用」「彰显重要意义」等空泛的重要性判断。改为材料已经确认的动作、变化或结果。 - 检查「业内普遍认为」「专家指出」「有研究表明」「不少用户反馈」等模糊归因。材料提供了明确来源时写出来源；没有来源时，不保留权威背书，也不自行补充来源。 - 检查事实后面追加的「从而确保」「进而体现」「进一步彰显」「反映了更深层次的……」等分析尾句。材料没有支持对应因果或判断时，删除尾句。 - 检查「尽管面临诸多挑战……仍……」「未来可期」「迈出了重要一步」「开启新的篇章」等固定转折和乐观结尾。直接说明已经确认的限制、当前结果或下一步安排。 - 删除读者成稿中的聊天残留和讨好表达，例如「当然可以」「这是一个好问题」「你说得完全正确」「希望这对你有帮助」「如需更多信息请告诉我」。 - 合并重复限定，例如「可能在一定程度上或许会」。保留一个最符合事实状态的限定词，不能把不确定信息改成确定结论。 - 检查为了显得完整而强行使用的三项并列、没有范围关系的「从 A 到 B」、同一对象的同义词轮换，以及连续使用破折号、粗体小标题或表情符号。结构本身合理时保留，不机械拆分或改成固定数量。 ## 不使用的表达 - 不编造朋友、用户反馈、个人经历、使用场景或情绪。材料没有提供依据时，不用「很多人认为」「经常有人问」「大家都遇到过」等群体判断作为开头。 - 不使用口号、宣传黑话、新奇比喻、死物拟人或意象包装普通事实。 - 不使用「核心问题是」「关键区别在于」「原因很简单」「综上所述」等模板化领起语和总结语。 - 不为了形成转折反复使用「不是……而是……」。确实需要纠正误解时可以自然使用一次。 - 不使用引号代替强调，不给中文概念添加没有必要的英文括注。 - 不使用「搞顺」「跑起来」「能力落下去」「把结果丢回来」「吃下上下文」「承接需求」等含义含糊的动作。说明真实的执行者、动作和对象。 - 不在结尾使用「理解了……才能……」「这不仅是……」「真正重要的是……」「从更大的角度看……」等没有增加信息的升华表达。 - 不在读者成稿中加入生成时间、模型、接口、脚本路径和维护说明。 ## 不同内容的处理 - **长文、博客、演讲稿、个人简介：** 说明自己的项目或判断时使用「我」，按照材料展开必要的原因和过程；内容确实分成不同主题时使用朴素的二级标题。 - **网站文案、产品介绍、落地页：** 直接说明它是什么、能够完成什么、适合什么情况以及存在什么限制，不替读者判断产品一定优秀。 - **小红书、公众号短帖、朋友圈：** 可以使用较自然的口语节奏，面向读者时根据语境使用「我们」或「大家」，不虚构起因和场景。 - **文档、说明、API、正式通知：** 准确和清楚优先，直接给出操作、条件和必要说明。 ## 结构和格式 - 不在正文第一行重复整篇 H1 标题；标题可以作为文件名或外层标题，正文按需使用二级标题。 - 润色或改写现有成稿时，保留原有 Markdown 层级、链接、代码和必要格式。默认直接提交修改后的成稿，只有用户要求时才附带修改说明。 - 中文与英文、数字之间保留一个半角空格，例如「Claude Code」「2024 年」。 - 中文句子使用全角标点，纯英文和代码内部使用半角标点。 - 用户使用哪种语言，就使用同一种语言；没有明确语言时，遵循用户提供材料的语言。 ## 英文 - 使用常见、直接的词和自然缩写。 - 优先使用 `if`、`so`、`and`、`but`，谨慎使用 `thus`、`hence`、`moreover`。 - 避免 `That said`、`It's worth noting that`、`In conclusion`、`At the end of the day` 等模板化转场。 - 不给英文概念添加没有必要的中文解释。 ## 完成验证 文件成稿运行： ```bash python3 /scripts/tone_lint.py <文件路径> ``` `FAIL` 表示已经确认的 oil-tone 问题，修改后重新运行。`WARN` 只表示可能存在固定的 AI 表达，需要结合上下文判断；表达确有作用时可以保留。程序通过后，朗读全文并按照前述规则完成一次人工检查。程序只能识别已知表达，不能代替人工判断。