不止去 AI 味——教 AI 人情世故:哪句话会得罪人、对上汇报和对同事吐槽是两套语法、换个平台要换一副心智。
把话说对的四步:搭骨架 → 定读者 → 调语气 → 当读者读一遍。给 AI agent 和人共用的表达规范。
writing-standard-skills 是集合名,不是 skill 名。 装进你 Agent 的是下面 10 个 skill,目录名即触发名;表里最后一行是参考文档,不会被触发。
写文档、提单、发动态、做客诉接待——内容对了但没人看完,或者看完了充斥着一股 AI 假人味,通常不是内容问题,是这四件事没按顺序做,且缺乏细颗粒度的场域与语气拼装:
① 搭骨架 结论先行 · SCQA 四句 · MECE 不重不漏
② 定读者 给人 or 给 agent;对上 or 对同侧;契合特定平台受众心智
③ 调语气 归因情境 · 自曝先行 · 去 AI 味 · 拒绝空洞升华 · 允许被推翻
④ 当读者 以第一次看的人的身份通读,带清单查错
跳过 ④ 的实测代价:一份 9918 字的技术报告,通读后揪出 20 处问题,19 处是通读才发现的——内容错位挂到邻节、引用已删章节、同一份文档两处结论互相打脸。脚本只能扫出词面残留。
目录名 = 触发名。装上后你的 Agent 认的是左边这一列。
| skill(触发名) | 管什么 | 什么时候用 |
|---|---|---|
| how-to-write | 总纲:上面四步的完整方法 | 写任何要给别人看的文字之前 |
| account-custody | 账户托管前置检查:认平台→读人设→对口径→核环境(IP属地一致性) | Agent 替人接管社交账户、代运营发帖之前 |
| peer-facing-writing | 对同事的书面沟通:提单骨架、逐句替换表 | 写 issue、评审意见、跨团队报告 |
| technical-postmortem | 严肃事故复盘与故障通报:时间线白描、5 Whys 机制下钻、物理防复发措施 | 线上故障、服务中断、负面公关通报时 |
| decision-and-rfc | 架构决策(ADR)与技术提案:本质矛盾量化、代价显式化、墓碑方案、推翻红线 | 架构评审、技术选型论证、重构立项时 |
| executive-briefing | 对负责人极简汇报:仅限【✅已完成】/【⏸拍板项】,互斥选项代价对齐 | 给老板、业务决策者与 Owner 汇报时 |
| platform-voices | 全平台表达风格分册:小红书/X/Reddit/掘金/网易云/GitHub/公众号,附说说扣分清单 | 针对特定平台的受众心智发帖与创作时 |
| scenario-openers | 场景接待词、破冰与去 AI 味真实表达规范 | 客诉安抚、私信接待、神评开场、彻底消除 AI 论文腔 |
| talk-text-review | 讲稿姿态验收:这份稿是「我教你们」还是「我跟你们聊」 | 对同级或高手分享之前 |
| talk-visual-review | 讲稿视觉验收 | 出片之前 |
参考文档(不是 skill,不会被自动触发,需要时手动查阅):
| 文档 | 内容 |
|---|---|
| atomic-matrix.md | 5D 原子表达组合矩阵:像拼积木一样拼装 [谁]×[在哪]×[场景]×[口吻]×[接待词] |
自带开箱即用的静态检查脚本 scripts/lint-writing.mjs,无第三方依赖,可直接作为 Git pre-commit hook 或接入 CI,机械拦截假人过渡词、机械排比、高中作文腔与空洞正能量结尾:
# 本地自检
node scripts/lint-writing.mjs skills/
# 或通过 npm
npm test通过智能安装脚本,一秒全自动软链接接入 ~/.agents/skills 全局中心、Claude Code、OpenAI Codex、DSH 以及 本地 GUI (Antigravity IDE):
# 方式 A:已在本地仓库目录下直接执行
./install.sh
# 方式 B:远程一行全自动接入
curl -fsSL https://raw.githubusercontent.com/webkubor/writing-standard-skills/main/install.sh | bash提示:采用软链接直连模式,后续源码无论怎么修改迭代,所有 Agent 均实时生效,无需重复安装。其他 Agent 与配置细节见 AGENTS.md。
表达拆成四段,本仓只管第一段,其余各有归属,互不重复定义:
| 说什么 | 长什么样 | 怎么念 | 在哪写 |
|---|---|---|---|
| writing-standard-skills | facet | voxflow | typora-Bloom-theme |
| 结构 · 语气 · 归属 | 字阶 · 留白 · 分页 · 渲染 | 声音设计 · 戏感 · 停顿 | 编辑器环境 |
一句话判归属:「该说什么、先说哪句、这话得罪人吗」→ 本仓;「字号多大、留多少白」→ facet;「这句怎么念」→ voxflow。完整分工见 BOUNDARY.md。
语气部分的每条规则都挂着一个心理学机制,不是「礼貌一点」这种手感:
- 基本归因错误 → 别写「测试方法不对」,写「这个坑在页面上看不出来」(归因到情境,不归因到人)
- 面子威胁 → 命令式触发防御,对方先保护自尊、后处理信息
- 逆火效应 → 直接说「你错了」会让人更坚持,尤其在有第三方围观的单据里
- 自曝降防御 → 同一个坑自己也踩过,先写自己踩过
结构部分用金字塔原理(Barbara Minto):结论先行、以上统下、归类分组(MECE)、逻辑递进。
MIT License.