writing-plans skill 是什麼、怎麼用：Superpowers 把需求拆成可執行實施計劃的 Skill

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

這個 Skill 做什麼

設計確認之後直接開寫，中途很容易跑偏或做一半忘了前提。writing-plans 要求先落一份書面計劃。description 只有一句：手裏有多步驟任務的規格或需求時，在碰代碼之前使用。

它對計劃的讀者有個明確設定：一位沒見過這個代碼庫、也沒讀過這份需求的工程師。這位工程師知道接口和測試長什麼樣之後能寫出地道的代碼，也會在計劃留白處做合理選擇；他不可能知道的是你做了哪些決定——動哪些文件、函數叫什麼、簽名是什麼、需求裏的哪些數值、哪些測試能證明任務完成。計劃要記錄的正是這些。寫法上要求把整件事拆成小塊任務，遵循 DRY、YAGNI、測試驅動和頻繁提交。

說明裏依次規定了：範圍檢查（太大的需求先拆成幾份計劃）、先列文件結構、任務怎麼定大小、每一步寫多細、計劃文件的固定抬頭、寫完後的自查。計劃儲存到 docs/superpowers/plans/ 下，文件名帶日期和功能名。最後把選擇權交還給你：用子智能體逐任務執行，還是在當前會話裏直接執行。

怎麼安裝

writing-plans 是 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-plans 的形式出現，也會按場景自動觸發。

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

怎麼用

• 走完 brainstorming 之後它會自動接上，並先聲明「我在用 writing-plans 技能寫實施計劃」。
• 手裏已有需求文檔時：「按這份 spec 寫實施計劃，先不要寫代碼」。
• 看完計劃覺得哪一步不對，直接讓它改計劃文件，再開始執行。

這個技能只有一份 SKILL.md，沒有腳本。

適合誰 / 侷限

適合要連續做幾個小時的中大型功能：計劃寫在文件裏，換會話、清上下文之後還能接着幹。小改動不值得寫計劃；計劃質素取決於前面需求聊得多清楚，需求含糊時它會把含糊也寫進計劃。

注意事項

• 許可：MIT。
• 會在倉庫裏新增文件：計劃文檔預設放在 docs/superpowers/plans/，是否提交進版本庫由你決定。
• 計劃裏會寫具體代碼片段和文件路徑，執行前花幾分鐘讀一遍，比事後返工便宜。