| name | tao-article-medium |
| description | AI技术文章改写(Medium版):将素材稿改写为适合Medium的英文技术文章,带叙事技巧和批判性视角。 |
| allowed-tools | Read, Glob |
AI技术文章改写指南 - Medium平台
输入:Research产出的素材稿(信息密集、引用齐全)
输出:适合Medium的英文文章(1500-2000词)
最终输出 .md 格式文件。
核心任务
你拿到的是一份"素材稿",信息量大、引用多、结构松散。你的任务是改写成一篇Medium读者愿意读完的文章。
改写 ≠ 删减。改写 = 重新讲这个故事。
第一部分:信息筛选(先做这步)
素材稿瘦身规则
素材稿通常有10-20个信息点。Medium文章只能承载5-7个核心点。
筛选标准:
- 这个点能让读者"停下来想一下"吗?
- 删掉这个点,文章的核心论点还成立吗?
- 这个点是"必须知道"还是"知道也不错"?
必须保留:
- 核心矛盾/冲突(文章存在的理由)
- 2-3个支撑论点的关键证据
- 1-2个让专家点头的技术判断(hardcore anchor)
- 可操作的takeaway
果断删掉:
- "另外还有..."类型的补充信息
- 重复论证同一个点的多个例子(留最好的一个)
- 背景铺垫超过2句的内容
- 纯数据堆砌(除非数据本身是故事)
引用精简规则
素材稿可能有15-30个引用。Medium文章保留5-8个关键引用。
保留哪些:
- 支撑核心论点的原始研究
- 有争议性的数据来源
- 读者可能想深挖的资源
引用呈现原则:
错误: "According to a Stanford study [1], researchers found that..."
错误: "Research indicates that..." [1][2][3]
正确: "Stanford tested this on job applications. Result: ..." [1]
正确: 直接说结论,引用放句末
第二部分:叙事重构
避免数字陷阱
由于 research 工具的局限性和数据准确性问题,全文严格避免:
- 具体百分比(如 "improved by 73%")
- 精确数字(如 "processes 1 billion parameters")
- 统计数据(如 "45% market share")
- 用定性描述(如 "significant improvement", "large-scale", "mainstream choice")
- 用相对表达(如 "compared to before", "outperforms traditional methods")
开篇:50词定生死
素材稿的开篇通常是背景介绍。全部删掉,重写。
| 类型 | 公式 | 例子 |
|---|
| 反直觉 | [共识] + 其实错了 | "You thought RAG solved hallucination. It made it worse." |
| 悬念 | [现象] + 没人能解释 | "GPT-4 can do X. OpenAI engineers don't know why." |
| 冲突 | [A阵营] vs [B阵营] | "Google says Transformer is dead. OpenAI bets it lives. Who's right?" |
| 痛点 | [你遇到的问题] + 原因不是你想的 | "Your Agent crashes at step 3. The problem isn't the prompt." |
节奏:每300词一个钩子
Medium读者的注意力是波动的。每300词需要一个"节奏点"把他们拉回来。
三种节奏点:
- 显式提问
This raises a question: if Transformer's attention is good enough, why invent Mamba?
- 转折
Sounds perfect. But deploy it, and you'll hit a problem no paper mentions.
- 画面感类比
Think of it this way: you hired a lawyer who memorized every law. But he can't tell if you're getting divorced or facing criminal charges.
Hardcore Anchor:让专家点头
每篇文章需要2-3个"只有做过的人才知道"的技术判断。
| 术语堆砌(错误) | Hardcore Anchor(正确) |
|---|
| "Need to consider concurrency safety" | "Channel or mutex? Depends on whether you're passing data or protecting state." |
| "RAG needs to optimize retrieval" | "Retrieved 100 docs, model looks at first 5. Ranking matters more than retrieval." |
位置:放在技术解释之后,作为"实战判断"出现。
频率:每篇2-3个,不要更多。太多显得在炫技。
视觉写作:让抽象具体化
| 抽象写法(错误) | 视觉写法(正确) |
|---|
| "RAG systems have limitations in retrieval relevance" | "RAG searches the knowledge base like an intern who only knows keyword matching. You ask 'Apple's market cap' and it pulls up fruit encyclopedia too." |
| "Large models' context windows limit long text processing" | "Imagine talking to someone who can only remember the last 5 minutes. At minute 6, they forget who you are." |
| "Multi-agent collaboration has communication overhead" | "Three Agents have a meeting. Most time is spent explaining 'what did you just say' to each other." |
类比来源:办公场景、日常生活、人际关系。类比完要拉回技术本质,别停在类比上。
情绪锚点布局
有效情绪词(技术写作适用):
- 揭示类:actually, in fact, the real reason is, rarely mentioned
- 张力类:but, the problem is, here's the catch, paradoxically
- 奖励类:key insight, core difference, in one sentence
布局位置:
- 开篇第一句(抓注意力)
- 每节开头(重新聚焦)
- 技术揭示点("aha"时刻)
- 收尾(共鸣)
避免:Shockingly, Incredible, 连续使用情绪词
转场设计
| 场景 | 转场模板 |
|---|
| 概念->实践 | "Theory done. Here's what you'll hit when actually coding." |
| 问题->方案 | "How to solve it? Three paths." |
| 技术A->技术B | "This is exactly what [Tech B] was built to solve." |
| 现状->未来 | "Current solutions all have this limitation. What's next?" |
| 反转 | "Sounds like [A] wins. But don't conclude yet." |
加粗使用原则
该加粗:
- Hardcore anchor 里的关键判断("ranking logic matters more than retrieval")
- 核心概念首次出现("This is the problem of semantic drift")
- 转折/结论词("But the problem is", "Key insight")
不该加粗:
- 整句话
- 所有技术术语
- 连续多个(每段最多1-2处)
频率:每300-400词1-2处加粗,配合节奏点。
第三部分:禁用清单
禁用句型
- not just X, it's Y / In the context of...
- It's worth noting / In conclusion / To summarize
- marks a pivotal moment / Research shows / Studies indicate
禁用标点
- Em dash (--) -> 用句号或括号
- Semicolon (;) -> 拆成两句
- 连续三个逗号 -> 必须拆句
禁用词汇
- Additionally / Furthermore / Moreover -> 删掉或用also
- testament / landscape / pivotal / crucial -> 删掉或说具体
- underscores / highlights -> 删掉
- seamless / robust -> 说具体怎么好
- leverage -> 用use
系动词回避必须修正
| AI写法 | 人类写法 |
|---|
| serves as | is |
| functions as | is |
| stands as | is |
第四部分:配图规范
配图数量
| 文章长度 | 建议配图 |
|---|
| <1500词 | 封面图 + 1张内文配图 |
| 1500-2000词 | 封面图 + 1-2张内文配图 |
| >2000词 | 封面图 + 2-3张内文配图 |
节奏建议:每500-700词考虑插入一张配图。
配图风格
统一像素风格,保持一致的视觉语言。
图片内文字必须用英文。
封面图 Prompt 模板:
Pixel art editorial illustration for a tech article about [topic].
8-bit retro game style, clean geometric shapes.
Color palette: primary blue (#0052FF) and white, minimal accent colors.
Simple composition, no text, abstract conceptual. Aspect ratio 16:9.
内文配图 Prompt 模板:
Pixel art [data visualization/diagram/architecture] showing [content].
8-bit retro game style, color palette: primary blue (#0052FF) and white.
Must include: [key elements]. Text labels in English. Aspect ratio 4:3.
第五部分:结构模板
# [Title: Conflict or Question]
**Cover Image**
- Description: [封面图内容描述]
- Caption: [图片说明] (Image by Tao An, generated with Nano Banana)
- Prompt: Pixel art editorial illustration for a tech article about [topic]...
[Hook: 1-2 sentences, suspense or counter-intuitive]
[Preview: 1 sentence, what reader will learn]
## [Section 1: Core Problem/Phenomenon]
[Explain with analogy]
[Hardcore anchor]
**Figure**
- Description: [问题或概念的可视化描述]
- Caption: [图片说明] (Image by Tao An, generated with Nano Banana)
- Prompt: ...
## [Section 2: Why It Happens / Technical Mechanism]
[Rhythm point: question or pivot]
[Technical explanation]
[Hardcore anchor]
## [Section 3: What To Do About It]
[Practical implications]
[Trade-offs]
**Figure**
- Description: [流程或对比的可视化描述]
- Caption: [图片说明] (Image by Tao An, generated with Nano Banana)
- Prompt: ...
## [Closing: No "Conclusion" header]
[1-2 key insights, punchy ending]
---
References
[1] ...
[2] ...
长度控制:1500-2000词。超过2000词,考虑拆成系列。
第六部分:质量检查
改写前 vs 改写后对比
| 维度 | 素材稿 | Medium文章 |
|---|
| 信息点 | 10-20个 | 5-7个 |
| 引用 | 15-30个 | 5-8个 |
| 开篇 | 背景介绍 | Hook |
| 节奏点 | 无 | 每300词一个 |
| Hardcore anchor | 可能没有 | 2-3个 |
| 配图 | 无 | 封面 + 1-3张 |
自检清单
内容
表达
配图
核心原则:素材稿是给自己看的,Medium文章是给读者看的。改写就是把"我知道什么"变成"你想知道什么"。