mcpField
I
impactful-writing

impactful-writing

github.com/tenequm创意与媒体4090 次安装5 天前更新
代码仓库

关于 impactful-writing

用于撰写和修改社交内容、文档、职场消息及长篇文章的写作技能。它提供清晰表达、内容结构、编辑清单和针对不同形式的写作指导。

主要功能

  1. 01运用清晰简洁的表达原则
  2. 02按便于浏览的方式组织内容
  3. 03精简文字并改用主动语态
  4. 04提供针对不同平台的写作指导
  5. 05使用编辑框架检查草稿

适用场景

  1. 01修改技术文档
  2. 02撰写社交内容和文章
  3. 03改善电子邮件与工作消息
  4. 04审阅 GitHub 评论和拉取请求

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/tenequm/skills --skill impactful-writing

安装后在 Claude Code 中输入/impactful-writing确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

LICENSE.txt
references/
clarity-science.md
emotional-impact.md
revision-frameworks.md
structure-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 种方法”胜过“几种方法”
  • 具体示例胜过抽象解释

快速入门工作流

撰写新内容
  1. 用一句话定义核心信息
  2. 以吸引人的内容开篇(问题、事实或故事)
  3. 用标题构建结构,方便快速浏览
  4. 使用短句(平均每句 15~20 个词)
  5. 以明确的要点或行动号召收尾
编辑现有内容
  1. 大声朗读,找出不通顺的段落
  2. 在不损失原意的前提下,将字数减少 10%~30%
  3. 将被动语态改为主动语态
  4. 用简单词语替换术语
  5. 增加结构(标题、项目符号、留白)

平台专项指南

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

详细参考资料

如需了解特定主题的深入指导:

快速参考:CLEAR 框架

C - 简洁:删减 10-30%,同时保留原意 L - 价值优先:在首句点明要点 E - 以证据为依据:具体数据胜过模糊说法 A - 使用主动语态:主语-动词-宾语结构 R - 以读者为中心:他们需要了解什么?

验证:内容质量检查

写完后,请确认:

  1. 核心信息测试:能否用一句话概括?
  2. 意义测试:每段之后,能否回答“这有什么意义”?
  3. 外行测试:非专业人士能否理解要点?
  4. 行动测试:读者是否知道下一步该做什么?
  5. 删减测试:能否删除任何句子而不损失含义?

如果任何一项测试未通过,请修改相应部分。

评论

支持 Markdown