A personal, battle-tested style guide (packaged as a Claude Code skill) for writing Traditional Chinese (Taiwan) tech longform in a postmortem voice: direct, opinionated, evidence-first, and stripped of AI-flavored sentence patterns. Extracted from seven rounds of revising one real article after readers called out its "AI 味".
用寫事故復盤的方式,寫技術長文。
一份個人風格指南,包成 Claude Code skill,記錄一個 SRE 怎麼寫自己的繁體中文技術長文:語氣、節奏、譬喻、結構、標點的完整規則,加上「去 AI 味」的句子層級手法。
它的來歷:一篇真實文章(TokenBar「Rust 的引擎,Swift 的外殼」重寫戰記,中英雙語)在 2026-06 反覆潤了七輪,被真實讀者回饋「內容很有料,但讀起來像 AI」之後,把修出來的每一條規則與教訓萃取成這份指南。所以每一條規則都有出處:被真實讀者罵過、修過、驗證過。
讀者說的「AI 味很重」,病灶在句子層級:句型、用詞、資訊密度,內容往往還被稱讚。所以去 AI 味動的是句子:直白、有意見、敢下判斷、一句講一件事、用具體踩雷的語言,並主動降低每句的資訊密度。
| 章節 | 內容 |
|---|---|
| §0 | 核心診斷:AI 味是句子層級 |
| §1 | 硬規則:破折號 genre 矩陣、中國用語對照表、全形標點、產品先於技術 |
| §2 | 句子層級去 AI 味:對比句、staccato、meta-announce、名詞小抄 |
| §3 | 語氣:熱情非 hype、敢下判斷、誠實(權威靠證據不靠身分、AI 協助揭露框成底氣) |
| §4 | 節奏:設問→解答、喘息空間 |
| §5 | 譬喻:功能性可、過度文藝=矯情 |
| §6 | 結構與起承轉合:case study 定位、版面順序、誠實的邊界 |
| §7 | 排版鐵則(HackMD/部落格) |
| §8 | 雙語(zh+en)紀律 |
| §9 | 潤稿 SOP(草稿 AI → voice 守門 → grep 驗證) |
| §10 | 對外部 AI 校稿的紀律(逐條對原始碼查核) |
| §11 | HackMD 發佈機制與踩雷 |
| §12 | Genre 邊界:長文 ≠ 社群貼文 ≠ GitHub PR |
| 附錄 | 發佈前 checklist |
✗ 我的安全網是紀律,不是 backstop。 (AI 對比句型)
✓ 這裡沒有兜底的 backstop。真正撐住邊界的,是紀律。
Claude Code:
git clone https://github.com/Nanako0129/postmortem-prose ~/.claude/skills/postmortem-prose之後在 session 裡以 /postmortem-prose 觸發,或在寫技術長文時讓它自動套用。內容是純 Markdown,不用 Claude Code 的話當一般文件讀也成立。
這是個人指南。規則反映我的偏好(例如中文零破折號)、我的 persona(SRE 寫復盤)。直接拿去用會寫出「我的」文章;比較好的用法是把 §1 的偏好與 §3 的 persona 換成你自己的,保留方法論(§0、§2、§4、§6 的部分可直接通用)。
MIT