threerocks/article2media / skills/article-rewrite
article-rewrite
Verified改写(总结):把一篇文章读透、重组成一份和风格无关的结构化改写稿 content.json——核心主张、分页分节、每节的判断式标题、要点、金句、两张图表(柱状、流程、对比、结构等 20 多种)和数据面板,可选执行清单、核对数字、AI 插画;还能导出成一篇文章 rewrite.md(图表转成图片)。改写稿交给长图、卡片出图,rewrite.md 交给公众号排版。Use when the user wants an article summarized / restructured / 提炼 / 改写 / 整理成要点 for visual content, wants a 总结 before 长图、小红书卡片 or 公众号, or another article2media skill needs content.json; also when the user wants a structured summary article (总结稿) of a long post.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.8 KB |
| agents/openai.yaml | config | 286 B |
| examples/29meat-claude-code.json | config | 31.1 KB |
| examples/dan-koe.json | config | 31.6 KB |
| examples/eian-ai-video.json | config | 29.1 KB |
| examples/gallery.json | config | 8.7 KB |
| references/content-schema.md | markdown | 9.9 KB |
| references/figures.md | markdown | 9.1 KB |
| references/writing-guide.md | markdown | 7.0 KB |
| scripts/check.mjsexecutable | script | 858 B |
| scripts/doctor.mjsexecutable | script | 794 B |
| scripts/export.mjsexecutable | script | 800 B |
| scripts/illustrate.mjsexecutable | script | 804 B |
references/writing-guide.md
View on GitHub# 改写指南:把一篇文章变成几页总结图
目标读者:刷到图的人,**30 秒内看懂主旨,3 分钟读完能照着做**。这不是逐段摘要,而是**重组**。
## 1. 先读透,再规划
1. 通读全文,用一句话写出"作者的核心主张"。它会成为第一页的导语和最后的收束句。
2. 找出文章的**骨架**。常见的有三种:
- 为什么 → 是什么 → 怎么做(观点文、方法论,最常见)
- 问题 → 原因 → 方案
- 时间线 / 阶段
3. 一页对应骨架的一个"部分",每页 3–4 节。各页的 `part` 要构成一句完整的叙事,例如:
- 第一部分 · 技能、市场与团队(为什么)
- 第二部分 · 访谈、内容地图与第一个客户(怎么做)
- 第三部分 · 你的故事、你的调研与你的清单(落地)
4. 原文的推广、广告、自我介绍、"订阅我"之类的内容**丢掉**;但如果作者在推销自家产品时提到了一个普适的方法,就保留方法、注明"他在推销 X 时说的"。
5. 原文没有展开、读者却最需要的东西(例如"到底先做哪一步"),可以由编者补一节,但必须在标签或面板标题里标明"编者归纳"。
## 2. 每一节怎么写
| 字段 | 写法 | 反例 |
|---|---|---|
| `label` | 2–5 字的主题词,或"第 1 步" | "关于注意力的一些想法" |
| `heading` | 一个**判断**或**动作**,不是话题名。≤ 16 字,用 `\n` 在语义处断行 | "注意力"(只是话题) |
| `paragraphs` | 第一段讲作者的观点,用"他说/他认为"转述;第二段讲理由、条件或例子。每段 60–90 字 | 大段翻译原文 |
| `bullets` | 原文里具体的数字、例子、做法。每条 ≤ 30 字 | 重复正文 |
| `takeaway` | 一句能被截图转发的话,≤ 26 字 | "这很重要。" |
- 把这一节最关键的一句话**加粗**,每段最多加粗 1–2 处。
- 作者的原话、具体数字、人名、工具名**保留原样**;英文专有名词不翻译(Naval、Substack、Reels)。
- 语气:冷静、具体、像一本好的商业杂志。不用"!",不用"干货""绝绝子"这类网络腔。
## 2.5 人称:别人的文章,不写成"我"
大标题、封面、小红书标题、备选标题、发帖文案都是**转述**。原文作者讲"我的团队""我做了",你写成"他的团队""她""一位店主""作者"(不确定作者性别时用"作者"或名字);写成"我",发出去读者会以为是发帖人自己的经历。
- 好的写法:"一家社区面包店,一年营业额翻三倍"、"她把三个人的活交给一套流程"。不好的写法:"我的面包店一年翻三倍"、"三个人的活我一套流程搞定"。
- 引号里的原话可以保留"我"(「我整天都这么做」)。
- 文章就是发帖人自己写的,在 content.json 顶层写 `"voice": "self"`,可以用第一人称。
- 校验会对标题里的"我"给出提示,必须改掉。
## 3. 分清"他说的"和"编者加的"
这是总结图可信的关键。每个面板标题都写成 `<内容> · <出处>`:
- `· 他的原话`:直接翻译的引文(译成中文的也算,注明"编者译"更好)。
- `· 他的看法` / `· 他的数字`:转述作者的观点或数字。
- 作者是女性就写"她的…";不确定性别时写"作者的…"或用名字(`· 小晚的做法`)。
- `· 编者归纳`:你做的分类、对比、清单。
- `· 编者核对`:只在开启 `--verify` 并真的查证过之后才能写。在单元格里写清查证结果,例如"与 IAB 一致;2026 年为预测值"或"未找到出处"。
没有核对过的数字**不要**写成"核对"。图里画的数字必须来自原文或核对结果,否则在 `note` 里写"示意";是你换算出来的(比如两个数相除),`note` 里写"编者换算"。校验会把原文里找不到的数字逐个列出来,必须逐条处理。
页脚 `footnote` 写明:原文作者、标题、平台、日期;哪些是编者加工的;"插图仅作示意"。缺省时会自动生成。
## 4. 选图
- 先问"读者看这一节,最需要看见什么":一个数量变化?一个结构?一个对比?然后查 `figures.md` 的对照表。
- 两张图要互补:一张展示**结构/数据**,一张展示**观点/对比**。
- 原文没有数字时不要编数字。用 `stack`、`flow`、`compare`、`converge` 这类结构图。
- `caption` 写结论,不写图名。好的写法:"他给的三个选项。他预计多数人会选第三个。";不好的写法:"三个选项示意图"。
## 5. 收尾
- 每页 `closing` = 一句加粗的收束 + 下一页预告(最后一页换成全文总结)。
- 最后一页如果文章是方法论(读者读完要照着做),用一个 `checklist` 节把全文变成可执行清单;个人经验、观点类文章可以不做,用最后一节收尾。**不要为了放清单删掉原文的节**:一页放不下就多加一页(最多 4 页)。清单的要求:
- 按执行顺序分 3–6 个阶段,每个阶段 2–5 条可打勾的动作;
- 每个阶段写"做完的标准";
- `guard` 列出作者点名的失败模式。
## 6. 知识讲解:把对象、概念与结果接起来
讲概念、机制、方法时,读者要的不只是记住结论,而是下次遇到新情况知道**凭什么判断、何时适用、能推出什么**。写之前先用一句话想清:"读者面对什么新情形,应该认出什么、依据什么、推出什么?"
- **在同一段里接通**:眼前是什么对象 → 发生了什么动作或变化 → 哪个特征让它属于这个概念 → 关系靠什么条件成立 → 得到什么结果。只把例子放在术语旁边,连接仍然缺失。
- **用动作解释抽象词**:"需求被聚合"写成"顾客先向助手说要买什么,助手再把订单交给某家店";不要用另一个抽象词解释前一个。
- **判别依据要可见**:容易混淆的相似对象差在哪里?例子即使不参与证明,也可能承担"第一次认出概念"的工作,压缩时别删。
- **条件变化要写清**:换一个条件,关系还成立吗?作用变强、变弱还是不再适用?不要写成全有或全无。
- 补充的例子标明「补充假设例」,不冒充原文或真实观察;原文只支持倾向或局部结论时,保持原强度。
- 可以用一条"换个情形"收尾,让读者先判断再看解释;但它不能证明读者学会了。
文学、叙事和审美内容按自身目的组织,不强加这套路线。
## 7. 语言
改写可以顺带把外文写成中文(这是改写,不是翻译;要全文翻译、不删减时用 `article-translate`)。
- 默认输出简体中文(`lang: "zh"`)。如果用户要求英文,就用 `lang: "en"`,规则相同。
- 标题可以意译成更有力的中文,例如 "The most lucrative AI business to start in 2027" → "2027 年最赚钱的 AI 生意"。
- 中文与英文、数字之间加空格:"2027 年""YouTube 植入"。
- 金额保留原币种:$10k、$480B。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |