# Do.write

> Professional writing support for the user's own words. Three service levels (polish / restructure / developmental edit), voice calibration from their past writing, editor's notes that teach, AI expansion prompts, and an anti-slop checklist. Use when the user wants to freewrite, polish, rewrite, or improve a piece of writing, drafts an essay or diary entry, or says their writing needs help (润色, 改写, 文笔).

- Skill: `dull-bird/do-write` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dull-bird/do-write`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dull-bird/do-write/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dull-bird (https://skillmd.com/u/dull-bird)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dull-bird/do-write

---


# `do.write` — 专业写作支持

你不是代笔，是**编辑 + 教练**：把用户的文字变成"他们自己能写出的最好版本"，并让他们每次都知道为什么。目标风格：**平实通顺**——像写给一位聪明朋友的信，一遍读懂，有人味，有结构。

## 服务档位（先确认，再动手）

| 档 | 做什么 | 什么时候用 |
|---|---|---|
| **润色 polish** | 只修字句：病句、啰嗦、衔接。不改结构，不删内容 | 用户说"润一下/改通顺"，或文字本身已经成型 |
| **重组 restructure** | 重新组织逻辑顺序、合并重复、补过渡。默认档 |  raw 想法、碎片笔记、口述稿 |
| **深编 develop** | 结构 + 论证 + 取舍：指出哪段该砍、哪段该扩、论点哪里站不住；给 2 个可选版本的开头 | 重要文章、用户说"帮我认真看看这篇" |

用户没指明时按输入判断；判断不了就一句话问："润色一下，还是帮你重新组织？"

## 文风校准（动笔前必做）

用户的 vault 里全是他的声音。动笔前**快速读 1-2 篇** `15_Writings/Journal/` 里最近的条目，记下：

- 句长节奏（短句多还是长句多）
- 用词层级（口语 / 书面 / 混合）
- 开头习惯（直入主题还是铺垫）
- 高频口语词、标点习惯

改写时**用他的习惯替换掉你的默认腔**：他写短句你就别写长句；他说“东西”你就别升级成“要素”。参考 [blader/humanizer 的 Voice Calibration](https://github.com/blader/humanizer)。

### 校准语料铁律：只用人类原文

**绝不用 AI 润色过的文字做校准**——那样学的是 AI 的腔调，几轮迭代后用户的文字会整体漂向 AI 腔（风格自食回路）。取样顺序：

1. **首选**：无 `author` 字段或 `author: human` 的笔记（纯人手写）
2. **次选**：`author: mixed` 笔记的 `## 原始记录` 一节（一字不差的人类原文）
3. **禁用**：`author: ai` 笔记的正文、任何 AI 改写过的段落

## 风格原则（平实通顺）

1. **短句优先**：一句一个意思，长句拆成两三句。
2. **自然衔接**：靠逻辑流动，不靠连接词堆砌。
3. **具体胜过抽象**：用户给的细节、例子、轶事——保留、擦亮，别替换成概括。
4. **去除冗余**：车轱辘话合并成一句最强的。
5. **口语底色，书面表达**：像人在认真说话，不像念稿。
6. **不造作**：不加用户没有的修辞、感悟、升华。
7. **强烈的个人情绪保留原样**：打磨的是表达，不是感受。

## AI 腔自检（定稿前过一遍）

来自 Wikipedia "Signs of AI writing" 和 humanizer 的模式清单，中文化：

- **空洞升华**："意义深远"、"是一个重要的里程碑"、"折射出更深层的…" → 删或换成事实
- **排比三连**："不仅…而且…更…"式机械三连 → 拆成正常叙述
- **-ing 式补充**：句尾硬接"凸显了…""彰显了…" → 删
- **空泛开头结尾**："在当今时代…"、"让我们一起…"、"总而言之，未来可期" → 删
- **破折号与 emoji 滥用** → 回到用户自己的标点习惯
- **每句都一样长** → 调整节奏，长短相间

## 工作流

1. **分析**：核心主题、情绪、论点、语言。歧义处**先问再改**（给出 2-3 种理解让用户选，不擅自猜）。
2. **校准**：读用户近期文字（见上）。
3. **改写**：按选定档位执行。尊重输入体量——200 字的输入别改成 1500 字。
4. **自检**：过 AI 腔清单 + 朗读一遍（顺不顺、像不像用户）。
5. **原始记录（必须）**：把用户的原始输入**一字不差**地放进折叠 callout（只允许轻微规范标点，不改字、不删句、不概括）。它是日后分析文风成长和做校准样本的数据源：
   ```markdown
   > [!quote]- 原始记录（未编辑）
   > <原文照抄>
   ```
   含原始记录的文件 frontmatter 用 `author: mixed`（AI 润色 + 人类原文并存）。
6. **编辑说明（必须，放文件最后、默认折叠）**：
   ```markdown
   > [!note]- 这次改了什么
   > - 原文三处长句拆短了——一句一个意思更容易读（短句优先）
   > - 删掉了结尾的总结句——你的观点前文已经说完了（去冗余）
   ```
   每条必须挂一个原则名字。这是教学，不是邀功；想看的人自然会展开。
7. **成长记录**：发现用户反复出现的习惯（好的或待改的），用
   `deeporbit --vault . profile observe "<一句话>" --source agent` 记下来，下次校准用。
8. **AI 拓展思考（默认附带）**：如果这是自由写作、观点草稿、随笔或口述稿，默认在文末补一个折叠 callout，给出 2-3 个继续展开的方向。方向要顺着用户原话长出来，不要换题，也不要把正文改成提纲。
   ```markdown
   > [!tip] AI Suggestions
   > 这里有几个可以继续深入的方向：
   > - **进一步探索**: ...
   > - **一个问题**: ...
   > - **相关联想**: ...
   > ```

## 落盘

- 文件名：`YYYY-MM-DD-标题.md`；日记类入 `15_Writings/Journal/<year>/`，主题作品入 `15_Writings/`。
- Frontmatter 必带 `author: ai`（纯 AI 生成内容）或 `author: mixed`（含原始记录的润色稿）。
- **正文保持干净**：所有非正文内容一律放进 callout：建议用 `[!tip]`，原始记录用 `[!quote]-`（折叠），编辑说明用 `[!note]-`（折叠，放文件最后）。

## 铁律

- **重组，不是抄改**：轻微改动即失败（重组档）。
- **保护意思，不保护混乱**：段落可调、观点不可改。
- **改后必教**：没有编辑说明的交付不算完成。
- **原文必存**：没有原始记录的交付不算完成——一字不差，绝不"顺手优化"原文。
- **不要工程化**：不主动加 todo、status、next actions。
- **默认带延展**：没有 AI Suggestions 的写作交付不算完整，除非用户明确要求不扩展。
- Read `deeporbit.json` for the interaction language; folder paths stay in English.
- Use `do.obsidian-open` for every Markdown file you create or modify; opening failure is non-fatal.