拆解 GitHub 9.9 萬星 Superpowers：連寫 skill 都有流程

Superpowers 把 skill 視為行為工程：Iron Law 結構與 TDD 等價，description 不能概括 workflow，每個設計選擇背後都有說服科學。拆解 writing-skills 的完整邏輯。 ⭐ 文章深度讀：實際記錄的 AI 合理化說詞清單，以及為什麼 description 說越清楚反而讓 AI 跳過指令 → https://heymaibao.com/superpowers-writing-skills-tdd/ ⚡ 章節重點 一行指令為什麼沒用 00:00 TDD：讓 AI 先失敗的工程心法 01:03 Iron Law：跳不過的第一步 02:07 描述陷阱：說越清楚越危險 03:50 說服心理學：為什麼要用強硬語氣 04:52 核心轉變：從作家到工程師 06:13 📝 懶人包 ∙ `writing-skills` 開宗明義：「skill 設計等同於把 TDD 應用在文件上。」Iron Law 的結構與 TDD 完全等價，沒有讓代理先失敗，就不能寫 skill。 ∙ Baseline failure 不是可選步驟：你必須先讓代理在沒有 skill 的情況下作選擇、失敗、合理化，記錄它用了哪些說詞，才知道 skill 要防堵的是什麼。 ∙ Description 若概括了 workflow，代理會直接照 description 行動而跳過讀 SKILL.md 本體，而這不是理論，是從真實測試觀察到的行為。 ∙ 我的觀察：Superpowers 把 instruction design 視為「在壓力下製造合規行為的工程問題」，而不是「把規則說清楚」的溝通問題。這個視角的轉變，比任何具體 skill 都更值得拿走。 📚 參考資料 Superpowers → https://github.com/obra/superpowers