Skill 多語言閱讀指南
writing-plans用途、用法與原始來源
在編寫程式碼之前，如果您已經有了多步驟任務的規格或要求，請使用此方法。
原文擷取時間:
- 來源儲存庫
- obra/superpowers
- SKILL.md
skills/writing-plans/SKILL.md- 儲存庫 Star
- 309,479
- 儲存庫最近更新
- 2026-10-30
- 能力分類
- Agent 工作流程
- 最近採集時間
授權：MIT
流程片段用來協助閱讀上游說明。本頁沒有執行第三方 Skill，不屬於實測評測。
下面的用途與操作片段來自上游文件，由本站整理並翻譯，和另行標示的 Codez 編輯分析分開呈現。
這個 Skill 能做什麼
在編寫程式碼之前，如果您已經有了多步驟任務的規格或要求，請使用此方法。
如何使用：上游操作流程
概述
為從未見過此程式碼庫或規範的工程師編寫實作計劃。假設他們在了解確切的介面和測試案例後，會使用專案語言編寫符合規範的程式碼，並且在計劃中留有空白處，他們會做出合理的選擇。他們不能知道的是你的決定：哪些文件、哪些名稱和簽名、規範中的哪些值、哪些測試案例來驗證每個任務。將這些內容記錄下來。將整個計劃拆分成易於執行的小任務。遵循 DRY（Don't Repeat Yourself，不要重複自己）原則。遵循 YAGNI（You Aign I Need It，你不需要它）原則。遵循 TDD（測試驅動開發）原則。頻繁提交。在開始時聲明：「我正在使用編寫計劃的技能來創建實現計劃。」背景：如果在一個隔離的工作樹中工作，則應該已經通過以下方式創建：superpowers:using-git-worktrees執行時的技巧。保存計劃至：docs/superpowers/plans/YYYY-MM-DD-.md
步驟包含哪些內容
當實現者能夠根據該步驟編寫出一個合理的結果時，該步驟即完成。這就是全部要求：明確無誤，而非完整無缺。每種步驟都包含使其明確無誤的要素，僅此而已：測試步驟：測試名稱及其斷言（以代碼形式），斷言中包含規範中規定的確切值。程式碼步驟：確切的程式碼簽章（名稱、參數、傳回類型）、程式碼所在的文件以及規格中規定的具體值。實現者編寫程式碼主體。程式碼主體僅用於程式碼簽署和測試無法確定的演算法，或規格中規定的精確複製。驗證步驟：要執行的命令以及表明驗證通過的輸出。
原文片段 · L140 ↗環境與相依需求
本次未從該檔案選出獨立的環境需求片段，不代表無須相依套件。請繼續核對儲存庫的安裝說明和引用檔案。
限制與結果檢查
本次未從該檔案選出獨立的限制片段，不代表適用於所有輸入或環境。請閱讀完整原文，並自行驗證實際結果。
開始使用前
- 先核對支援的 Agent 宿主和儲存庫安裝說明。保留完整 Skill 目錄及其引用的腳本、資源和文件，只複製 SKILL.md 可能遺漏相依需求。
- 向 Agent 提供實際輸入、預期輸出和驗收標準。呼叫方式與可用工具取決於宿主環境，本站不假定存在通用的安裝指令。
- 先在暫存專案或輸入副本上試用。涉及修改檔案、遠端服務或計費資源的操作，應逐項核對後再授權。
- 依照原文檢查項目和自己的需求驗證輸出。成功觸發或儲存庫 Star 較高，都不能證明結果正確。
繼續閱讀原始文件
相關 Skill
翻譯與介紹範圍
本頁從固定版本的上游 SKILL.md 整理用途與操作片段，譯文使用輔助翻譯。它不是完整手冊，也不代表經過相容性實測；使用前請核對原文及其引用檔案。
介紹依據下方列出的固定版本；目前儲存庫動態和目錄擷取時間分開呈現。
- 固定版本來源
- 閱讀原文 ↗
- 原文擷取時間
- 來源提交版本
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- 原文 SHA-256
a6c67c1900064347c2a329990dd3c555657c51c3ec53b259a08aa01a2c26139a