superpowers writing-skills 是什麼、怎麼用：用測試驅動的方式寫 Skill（先看智能體失敗，再寫規則）

本文根據 obra/superpowers 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 20.6 萬次；所在倉庫 obra/superpowers 在 GitHub 約 29.7 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

多數人寫 Skill 的方式是憑經驗把注意事項列出來，然後預設它有效。writing-skills 的主張是：寫技能就是把測試驅動開發用在流程文檔上。description：創建新技能、編輯已有技能，或在部署前驗證技能是否有效時使用。

對應關係是這樣的：測試用例 = 用子智能體跑的「壓力場景」；看測試失敗 = 觀察智能體在沒有技能時的基線行為；寫實現 = 寫技能文檔；看測試通過 = 確認智能體裝上技能後照做；重構 = 堵住它找到的漏洞。核心原則沿用 TDD 的那句：如果你沒看過智能體在沒有這個技能時失敗，就不知道技能教的是不是對的東西。

說明裏把技能分成幾類——技術類（怎麼做）、模式類（思維方式）、參考類（文檔與 API），以及專門約束紀律的規則類——每類的測試方法不同。篇幅最大的部分講「防合理化」：模型在壓力下會給自己找理由繞過規則，所以規則類技能要把每個漏洞明確堵上，包括那句著名的「違反字面就是違反精神」。還覆蓋目錄結構、技能間如何互相引用、什麼時候該用流程圖。

怎麼安裝

writing-skills 是 Superpowers 插件裏的一個技能，不單獨發佈：作者的設計是整套一起安裝，由會話開始時注入的引導指令決定各技能何時觸發。Claude Code 裏輸入（命令來自倉庫 README）：

text
/plugin install superpowers@claude-plugins-official

Codex 在 /plugins 裏搜尋 superpowers 安裝；Gemini CLI 用 gemini extensions install https://github.com/obra/superpowers。裝好後在命令選單裏以 /superpowers:writing-skills 的形式出現，也會按場景自動觸發。

倉庫整體介紹和其他安裝方式，詳見本站《Superpowers 是什麼、怎麼安裝和使用：Claude Code / Codex 最熱門的 Skills 開發流程框架》。

怎麼用

• 「我想寫一個 skill，要求智能體提交前必須跑代碼檢查，用 writing-skills 的方法來」——它會先設計一個誘使智能體跳過檢查的場景，跑基線，再起草。
• 「這個 skill 經常被繞過，幫我找漏洞並加固」。
• 寫個人技能時，它會把文件放到所用工具的技能目錄（Claude Code 是 ~/.claude/skills/）。

目錄裏有幾份參考：Anthropic 的技能最佳實踐摘錄、說服原則、用子智能體測試技能的方法，以及畫流程圖的約定和渲染腳本。

適合誰 / 侷限

適合要寫「規矩類」技能的人——讓智能體在趕時間、嫌麻煩時仍然守規則，這類技能最需要測試。寫一份查資料用的參考型技能，用它就偏重了。與 Anthropic 官方的 skill-creator 相比，它更強調對抗性的壓力測試，後者更強調評測打分和觸發描述優化，可以互補。

注意事項

• 許可：MIT。
• 用量：基線加驗證要跑多輪子智能體。
• README 說明該項目一般不接受新增技能的貢獻，寫出的技能更適合放在自己的倉庫或個人目錄。