writing-standard-skills

agent
Security Audit
Pass
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 16 GitHub stars
Code Pass
  • Code scan — Scanned 1 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

把话说对的四步:搭骨架(金字塔/SCQA/MECE)→ 定读者(人 or agent)→ 调语气(心理机制驱动)→ 当读者通读自检。6 个 Agent skill + 5D 原子表达矩阵,给 AI agent 和人共用的表达规范。writing / technical writing / 写作 / 去 AI 味 / 一行安装

README.md

writing-standard-skills

把话说对的四步:搭骨架 → 定读者 → 调语气 → 当读者读一遍。
给 AI agent 和人共用的表达规范。

License Skills Claude Code Codex Cursor

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


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

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

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

六个 skill 与原子矩阵

目录名 = 触发名。装上后你的 Agent 认的是左边这一列。

skill(触发名) 管什么 什么时候用
how-to-write 总纲:上面四步的完整方法 写任何要给别人看的文字之前
peer-facing-writing 对同事的书面沟通:提单骨架、逐句替换表 写 issue、评审意见、跨团队报告
platform-voices 全平台表达风格分册:网易云/小红书/X/GitHub/公众号 针对特定平台的受众心智发帖与创作时
scenario-openers 场景接待词、破冰与去 AI 味真实表达规范 客诉安抚、私信接待、神评开场、彻底消除 AI 论文腔
talk-text-review 讲稿姿态验收:这份稿是「我教你们」还是「我跟你们聊」 对同级或高手分享之前
talk-visual-review 讲稿视觉验收 出片之前

参考文档(不是 skill,不会被自动触发,需要时手动查阅):

文档 内容
atomic-matrix.md 5D 原子表达组合矩阵:像拼积木一样拼装 [谁]×[在哪]×[场景]×[口吻]×[接待词]

一键接入全 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.

Reviews (0)

No results found