Skill 撰寫與審查程序

依照下列步驟產出或審查符合 agentskills.io 規範與 progressive disclosure 原則的 skill。

語言與行文風格

• 所有 skill 內容一律以**繁體中文（台灣用語，zh-TW）**撰寫。專有名詞（框架、工具、API、指令、檔案路徑）保留原文，不進行翻譯。
• 行文須流暢、切中要點、不灌水。一句話能說清楚的就不寫兩句。刪除贅字與模糊語氣。
• 避免過於口語。 維持技術文件的專業語氣：不使用句尾語氣詞（喔/啦/耶/欸）、不使用網路用語、不使用 emoji。
• 使用台灣標準術語（例：軟體而非软件、檔案而非文件、程式而非程序、伺服器而非服务器、請求而非请求）。

核心設計原則

• 流程而非散文。 Skill 是 agent 執行的工作流程，不是供閱讀的參考文件。每一份 skill 都要有步驟、檢查點與結束條件。
• 反合理化機制。 每份 skill 都要附上一張表格，列出 agent 常用來跳過步驟的藉口（例如「測試晚點再補」），並附上書面化的反駁論點。
• 驗證不可妥協。 每份 skill 結尾都要有證據要求——測試通過、建置輸出、執行時資料。「看起來沒問題」永遠不夠。
• Progressive disclosure。 SKILL.md 是進入點。支援用的 reference 僅在需要時才載入，以此降低 token 使用量。

判斷模式