軟體規格書撰寫指南

核心思想

只寫已經確認的內容；未確認的東西用「狀態」表達，不用「文字」填滿。

規格文件的價值不在於完整，而在於可信。一份有 10 章但每章都是真實決策的文件，遠勝過一份有 40 章、其中 30 章是推測的文件 —— 因為後者的讀者（人或 Agent）無法分辨哪些是決定、哪些是猜測，只能全部照做。

這份 Skill 的目的，是讓「文件涵蓋度」與「文件內容」分離：

• 內容寫進規格文件，只放確認過的東西
• 涵蓋度寫進 spec-coverage.yaml，記錄那 40 個考量項目各自的狀態

本 Skill 的用語

以下是這份 Skill 自訂的詞彙，不是業界通用術語，遇到時一律照這裡的定義理解：