关于 impactful-writing
用于撰写和修改社交内容、文档、职场消息及长篇文章的写作技能。它提供清晰表达、内容结构、编辑清单和针对不同形式的写作指导。
主要功能
- 01运用清晰简洁的表达原则
- 02按便于浏览的方式组织内容
- 03精简文字并改用主动语态
- 04提供针对不同平台的写作指导
- 05使用编辑框架检查草稿
适用场景
- 01修改技术文档
- 02撰写社交内容和文章
- 03改善电子邮件与工作消息
- 04审阅 GitHub 评论和拉取请求
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ tenequm/ skills --skill impactful-writing安装后在 Claude Code 中输入/impactful-writing确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSE.txtreferences/clarity-science.mdemotional-impact.mdrevision-frameworks.mdstructure-patterns.md详细介绍
有影响力的写作
概述
运用经过研究验证、适用于各种平台和场景的原则,将任何内容转化为清晰、令人难忘且可付诸行动的文字。这项技能融合了 50 多年的可读性研究、记忆神经科学和平台互动研究成果,提炼出实用技巧。
核心洞见:无论在哪里,驱动互动的都是相同的心理学原理——清晰能减轻认知负担,具体能加深记忆,结构则便于快速浏览。掌握这些通用模式,并应用于任何写作场景。
何时使用此技能
- 撰写或编辑 Twitter/X 帖子、串文或社交媒体内容
- 创作博客文章、Medium 文章或长篇内容
- 起草文档、README 文件或技术文档
- 撰写电子邮件、Slack 消息或专业沟通内容
- 撰写 GitHub 评论、PR 描述或代码审查意见
- 编写更新消息、公告或变更日志
- 编辑任何现有内容,使其更清晰、更有影响力
通用写作原则
这些基于证据的原则适用于各种平台和场景。
1. 以简化实现清晰表达
句子长度决定理解程度:
- 14 个词:读者理解率超过 90%
- 25 个词:开始难以理解
- 43 个词:理解率低于 10%
目标:平均每句 15~20 个词,每句最多 25 个词。
措辞很重要:
- 简单词语的处理速度比术语快 76%
- 主动语态的处理速度比被动语态快 15%~20%
- 具体表达胜过抽象表达(能激活大脑的感觉区域)
2. 采用便于浏览的结构
79% 的读者会浏览,而不是逐字阅读。 应根据这一现实来设计内容:
- 将关键信息前置(倒金字塔结构)
- 每隔 3~4 个段落使用描述性标题
- 每段最多写 3~5 句
- 有 3 项或更多相关内容时使用项目符号
- 理想行宽:50~75 个字符
3. 引发情感共鸣
故事会触发催产素释放,从而促进共情和记忆形成:
- 以吸引人的内容开篇(问题、令人惊讶的事实或简短故事)
- 使用富有感官色彩的具体语言
- 留下好奇缺口(读者想要得到答案的具体问题)
- 以令人难忘的要点收尾(近因效应)
4. 具体胜于抽象
具体细节的效果胜过模糊说法:
- “增长 45%”胜过“显著增长”
- “用时 5 分钟”胜过“很快”
- “10 种方法”胜过“几种方法”
- 具体示例胜过抽象解释
快速入门工作流
撰写新内容
- 用一句话定义核心信息
- 以吸引人的内容开篇(问题、事实或故事)
- 用标题构建结构,方便快速浏览
- 使用短句(平均每句 15~20 个词)
- 以明确的要点或行动号召收尾
编辑现有内容
- 大声朗读,找出不通顺的段落
- 在不损失原意的前提下,将字数减少 10%~30%
- 将被动语态改为主动语态
- 用简单词语替换术语
- 增加结构(标题、项目符号、留白)
平台专项指南
Twitter/X 帖子
- 理想长度:71~100 个字符,以提升互动
- 首行吸引注意:必须在 3 秒内抓住读者
- 使用数字:“10 条经验”比“经验总结”更有效
- 串文结构:每条推文都必须独立成篇,同时彼此衔接
改写示例:
Before: "I learned a lot from this experience and want to share some thoughts"
After: "5 hard lessons from shipping 10,000 lines of code in 48 hours:"
博客文章/文章
- 理想阅读时长:7~10 分钟
- 标题:每 300~500 个词设置一个
- 首段:必须兑现内容承诺
- 结论:总结要点,并给出明确的下一步
技术文档
- 先说明目标:读者将完成什么?
- 展示胜于讲解:可运行的代码示例胜过文字说明
- 循序渐进地展开内容:基础 → 进阶
- 术语保持一致:每个概念只使用一个术语
专业沟通(电子邮件/Slack)
- 主题行:具体胜过巧妙(“Q4 报告草稿” > “快速更新”)
- 每条消息只谈一个主题:提高回复率
- 把待办事项放在前面:不要把请求埋在后面
- 最多半页:越长,阅读率越低
GitHub 评论 / PR 描述
- 从背景开始:这解决了什么问题?
- 使用项目符号列表:列出变更、决策和权衡
- 说明“为什么”:阐述理由胜过描述内容
- 直接但友善:批评代码,而不是批评人
修订检查清单
使用此清单修订任何内容:
Clarity Pass:
- [ ] Average sentence length < 20 words
- [ ] No sentence > 30 words
- [ ] Passive voice < 10% of sentences
- [ ] Jargon replaced with simple alternatives
Structure Pass:
- [ ] Opening hook captures attention
- [ ] Key message in first paragraph
- [ ] Headings every 3-4 paragraphs (for longer content)
- [ ] Bullet points for lists of 3+ items
- [ ] Clear call-to-action or takeaway at end
Conciseness Pass:
- [ ] Removed "very," "really," "quite," "just"
- [ ] Replaced multi-word phrases with single words
- [ ] Deleted redundant explanations
- [ ] Cut 10-30% from original word count
精简用词模式
常见的精简表达:
| 冗长表达 | 简洁表达 |
|---|---|
| 鉴于……这一事实 | 因为 |
| 为了 | 来 |
| 在此时此刻 | 现在 |
| 如果发生……的情况 | 如果 |
| 关于 | 关于 |
| 大量的 | 许多 |
| 尽管……这一事实 | 虽然 |
| 为了……的目的 | 来 |
需要简化的复杂词语:
| 复杂表达 | 简单表达 |
|---|---|
| 利用 | 使用 |
| 开始 | 开始 |
| 终止 | 结束 |
| 展示 | 展示 |
| 促成 | 帮助 |
| 后续的 | 之后 |
| 大约 | 大约 |
| 努力 | 尝试 |
有效的开场模式
提问式开场
以读者想要了解答案的问题开篇:
"What if everything you knew about productivity was wrong?"
统计数据式开场
以令人惊讶的数据开篇:
"90% of visitors who read your headline also read your CTA - yet most writers spend 10x more time on body copy."
故事式开场
以简短叙述开篇:
"At 3 AM, with the deploy failing for the sixth time, I realized the bug wasn't in the code."
陈述式开场
以鲜明的陈述开篇:
"Most advice about writing is wrong. Here's what actually works."
矛盾式开场
挑战某种假设:
"The best writers don't write more. They delete more."
记忆与影响力原则
令人印象深刻的内容遵循这些模式:
序列位置效应
- 最先出现的内容:约 70% 的回忆率(首因效应)
- 最后出现的内容:约 60% 的回忆率(近因效应)
- 中间的内容:约 40% 的回忆率
启示:把最重要的要点放在开头和结尾。
预测误差
违背预期会形成鲜明的记忆:
Before: "The meeting went exactly as planned."
After: "The meeting started with our CEO apologizing. In 15 years, I'd never seen that."
感官语言
激活多个脑区:
Before: "The code was messy."
After: "The code sprawled like tangled Christmas lights - one pull and everything breaks."
常见反模式
过度解释
问题:解释读者已经知道的内容 改进:相信读者的理解能力,只提供新信息
重点埋得太深
问题:关键要点直到第 3 段才出现 改进:把结论移到开头,再用细节支撑
密密麻麻的文字
问题:段落冗长,缺少视觉分隔 改进:添加标题、项目符号和留白
回避主动表达
问题:“犯了错误”(是谁犯的?) 改进:“团队错过了截止日期”(明确责任归属)
术语堆砌
问题:“我们协同了跨职能范式” 改进:“我们让各团队协同合作”
经实践验证的内容框架
AIDA(注意 → 兴趣 → 欲望 → 行动)
适用于任何有明确目标内容的经典说服结构:
Attention: "Most developers waste 3 hours/day on preventable bugs."
Interest: "Static analysis catches 85% of these before they ship."
Desire: "Teams using this approach ship 2x faster with fewer incidents."
Action: "Add this one-line config to your CI pipeline."
PAS(问题 → 激发关注 → 解决方案)
适用于博客文章、着陆页和说服性内容:
Problem: "Your documentation is outdated the moment you write it."
Agitate: "New devs waste days. Senior devs answer the same questions. Nobody trusts the docs."
Solution: "Generate docs from code comments. Always current, always trusted."
BAB(之前 → 之后 → 桥梁)
通过转变叙事引发情感共鸣:
Before: "I spent 6 hours debugging a production issue."
After: "Now I catch these problems before they deploy."
Bridge: "Here's the monitoring setup that changed everything."
1-2-3 结构
适用于指导性内容——简单、易浏览、可执行:
1. The Problem: What's wrong and why it matters
2. The Solution: What to do about it
3. The How: Specific steps to implement
详细参考资料
如需了解特定主题的深入指导:
- references/clarity-science.md:有关可读性、认知负荷和平实语言的研究,附具体指标
- references/emotional-impact.md:叙事、记忆和说服的神经科学
- references/structure-patterns.md:眼动追踪研究、浏览模式和格式
- references/revision-frameworks.md:专业编辑流程及修改前后示例
快速参考:CLEAR 框架
C - 简洁:删减 10-30%,同时保留原意 L - 价值优先:在首句点明要点 E - 以证据为依据:具体数据胜过模糊说法 A - 使用主动语态:主语-动词-宾语结构 R - 以读者为中心:他们需要了解什么?
验证:内容质量检查
写完后,请确认:
- 核心信息测试:能否用一句话概括?
- 意义测试:每段之后,能否回答“这有什么意义”?
- 外行测试:非专业人士能否理解要点?
- 行动测试:读者是否知道下一步该做什么?
- 删减测试:能否删除任何句子而不损失含义?
如果任何一项测试未通过,请修改相应部分。