writing-skills

Writing-skills 提供了一套基於測試驅動開發 (TDD) 的結構化方法，專門用於建立、優化和驗證軟體代理技能。該系統將文件視為代碼，要求開發者在起草實際文件之前，透過子代理設定特定的壓力場景，以建立代理行為的基準。這確保了每個技能都經過實證驗證——觀察代理在沒有技能的情況下失敗、編寫技能來解決該失敗、並透過後續測試驗證合規性。它專為在 Claude Code 或 Codex 等環境中構建自定義技能的工程師和高階使用者而設計，確保文件具有可操作性、準確性，並能抵禦幻覺或誤解。

• 實作流程文件的 RED-GREEN-REFACTOR 循環。

• 支援建立壓力測試場景以驗證技能的有效性。

• 提供扁平且可搜尋的命名空間，用於管理複雜的代理專用技能。

• 將文件分為技術、模式和參考類型以實現模組化。

• 利用 YAML 前置元數據（frontmatter）進行機器可讀的觸發條件設定。

• 防止「工作流總結」陷阱，避免代理忽略邏輯而選擇過度簡化的描述。

• 在起草任何內容之前，務必先運行基準測試，以觀察代理原始的解釋方式。

• 使用此技能來建立可重複使用的技術、模式或工具，而非處理一次性問題或專案特定的約定。

• 如果任務可以透過正則表達式或自動化驗證來解決，請優先考慮自動化而非手動編寫文件。

• 使用以「Use when...」開頭的明確觸發條件來建構文件。

• 維持嚴格的模組化目錄結構，以便於查找和整合。

• 與 Claude Code 或 Codex 環境搭配使用，以標準化開發週期中的代理行為。

• 確保文件保持簡潔，優先採用可操作的模式和代碼比較，而非敘事性描述。