为中文或英文文案提供自然、易读、通顺、清楚的写作规范,同时守住事实边界。适用于博客、演讲稿、PPT 文案、网站与产品介绍、个人简介、公众号和社交帖子。规则有明确倾向,但不会要求所有内容套用同一种结构。
| 常见写法 | oil-tone 的处理 |
|---|---|
主流 AI Coding Agent:先选工作方式 |
主流 AI Coding Agent 的工作方式 |
单文件 HTML 的结构:简单,但不随意 |
单文件 HTML 的基本结构 |
先把流程搞顺 |
说明需要检查、修改或确认的具体对象 |
真正重要的是,我们理解了工具的边界 |
内容说明完成后直接结束 |
这些修改不是为了把句子统一改短,而是删除材料没有支持的态度、节奏和升华,让标题与正文继续提供有效信息。
- 事实是否来自现有材料,第一人称内容是否有依据。
- 面向读者时,是否根据情况自然使用“我们”或“大家”。
- 动词和对象是否准确,是否存在
搞顺、跑起来等含糊动作。 - 句子语法、因果关系和操作过程是否完整。
- “的”“了”等虚词是否为了压缩或显得书面而被删掉;是否结合语境保留,而不是机械增删。
- 段落、换行和列表是否真正提升可读性。
- 标题是否直接说明内容,而不是自行制造文案感。
- 结尾是否添加了没有新信息的感悟或价值总结。
- 是否出现固定开场、空泛重要性、模糊归因、聊天残留和通用乐观结尾等常见 AI 表达。
仓库中的 Skill 位于 skills/oil-tone/。
在 Codex 中,可以使用内置安装脚本:
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
--repo oil-oil/oil-tone \
--path skills/oil-tone也可以手动安装:
git clone https://github.com/oil-oil/oil-tone.git
cp -R oil-tone/skills/oil-tone ~/.codex/skills/oil-tone安装后,在下一轮任务中使用 $oil-tone 调用。
直接把 Skill 和写作任务放在一起:
使用 $oil-tone,把这份产品介绍改成可以直接发布的中文成稿。
使用 $oil-tone,检查这份 PPT 文案。保留技术细节,删除空泛标题和总结。
使用 $oil-tone,按照我的材料写一篇博客。不要编造个人经历。
如果我们准备把它改成自己的文风,可以 fork 仓库,再调整 skills/oil-tone/SKILL.md 中的叙述身份、称呼习惯和禁用表达。
Skill 附带一个只使用 Python 标准库的检查脚本。它会用 WARN 提醒你复核可能空泛或重复的表达,不会替你决定是否改写:
python3 ~/.codex/skills/oil-tone/scripts/tone_lint.py draft.md运行脚本自检:
python3 ~/.codex/skills/oil-tone/scripts/tone_lint.py --self-test表达自然且意思准确时可以保留。没有提示也不代表文章自然易读;脚本不能判断事实是否可靠,也不能代替通读和朗读检查。
oil-tone/
├── assets/readme/hero.svg
├── skills/oil-tone/
│ ├── agents/openai.yaml
│ ├── scripts/tone_lint.py
│ └── SKILL.md
├── LICENSE
└── README.md
如果你发现一类稳定出现的 AI 文案问题,可以提交 Issue 或 PR。请同时提供:
- 原句。
- 问题在哪里。
- 更自然、准确的改法。
- 这条规则适用和不适用的情况。
这样可以避免为了修复一个例句,增加一条会伤害其他内容的机械规则。
文风规范不需要外部账号或 API Key;可选的检查脚本只使用 Python 标准库。支持能够读取 Markdown Skill 的 Agent。
文风规则不提供事实依据;未确认经历不能写成事实。来源数值与计算矛盾时先核对,不因保留原文而延续错误。
使用示例:
用 oil-tone 润色这篇文章,保留事实和限制。
把 仓库地址 交给 Agent,要求按 README 安装;也可运行:
npx skills add oil-oil/oil-tone安装后由宿主重新加载 Skill。