Skip to content

About

不止去 AI 味——教 AI 人情世故。把话说对的四步:搭骨架→定读者→调语气→当读者读一遍。Claude Code / Codex / Cursor 一键接入。

Topics

Resources

Stars

8 stars

Watchers

1 watching

Forks

Repository files navigation

writing-standard-skills

不止去 AI 味——教 AI 人情世故:哪句话会得罪人、对上汇报和对同事吐槽是两套语法、换个平台要换一副心智。
把话说对的四步:搭骨架 → 定读者 → 调语气 → 当读者读一遍。给 AI agent 和人共用的表达规范。

License Skills Claude Code Codex Cursor

writing-standard-skills 是集合名,不是 skill 名。 装进你 Agent 的是下面 10 个 skill,目录名即触发名;表里最后一行是参考文档,不会被触发。


写文档、提单、发动态、做客诉接待——内容对了但没人看完,或者看完了充斥着一股 AI 假人味,通常不是内容问题,是这四件事没按顺序做,且缺乏细颗粒度的场域与语气拼装:

① 搭骨架   结论先行 · SCQA 四句 · MECE 不重不漏
② 定读者   给人 or 给 agent;对上 or 对同侧;契合特定平台受众心智
③ 调语气   归因情境 · 自曝先行 · 去 AI 味 · 拒绝空洞升华 · 允许被推翻
④ 当读者   以第一次看的人的身份通读,带清单查错

跳过 ④ 的实测代价:一份 9918 字的技术报告,通读后揪出 20 处问题,19 处是通读才发现的——内容错位挂到邻节、引用已删章节、同一份文档两处结论互相打脸。脚本只能扫出词面残留。

九个 skill 与原子矩阵

目录名 = 触发名。装上后你的 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 原子表达组合矩阵:像拼积木一样拼装 [谁]×[在哪]×[场景]×[口吻]×[接待词]

自动化去 AI 味门禁(Linter)

自带开箱即用的静态检查脚本 scripts/lint-writing.mjs,无第三方依赖,可直接作为 Git pre-commit hook 或接入 CI,机械拦截假人过渡词、机械排比、高中作文腔与空洞正能量结尾:

# 本地自检
node scripts/lint-writing.mjs skills/
# 或通过 npm
npm test

一键接入全 Agent 与本地 GUI(装上就能用)

通过智能安装脚本,一秒全自动软链接接入 ~/.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.

About

不止去 AI 味——教 AI 人情世故。把话说对的四步:搭骨架→定读者→调语气→当读者读一遍。Claude Code / Codex / Cursor 一键接入。

Topics

Resources

Stars

8 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages