writing-skills

Writing-skills 是一套專為軟體工程代理程式設計的專業方法論，旨在將測試驅動開發 (TDD) 原則應用於其流程文件。透過將文件視為程式碼來處理，此技能可確保說明文件保持準確、可執行，並能對抗代理程式的誤解。它專為需要管理複雜多步驟工作流，同時保持嚴格遵循專案標準的開發者與 AI 代理所設計。

此技能的核心是應用於文件的 RED-GREEN-REFACTOR 循環。代理程式不會編寫靜態指南，而是創建壓力場景來測試自身對說明的理解。若代理程式在基準測試中違反規則 (RED)，此技能要求更新文件以解決違規的根本原因。接著代理程式執行驗證 (GREEN)，確保文件能防止先前的失敗。這種方法消除了模糊性，強化了清晰度，有效地將文件轉變為可靠且可執行的參考系統。

• 為技術文件與代理程式說明實現測試驅動開發 (TDD)。

• 利用子代理壓力場景模擬真實工作環境，實現自動化驗證。

• 執行迭代重構，以堵住漏洞並解決代理程式常見的偏差理由。

• 提供強大的映射系統，確保文件與預期行為一致，防止長期專案中的行為漂移。

• 標準化技能開發流程，包含 Frontmatter 規範與目錄結構。

• 當你需要教導代理程式一套可在多個專案中應用的可靠技術或模式時，請使用此技能。

• 若代理程式無法遵守規則，請使用此技能來編碼修復方案，並透過測試進行驗證。

• 非常適合用於記錄複雜的系統模式、API 使用指南以及需要高度精確的工程工作流。

• 在建立技能前，務必先進行基準檢查以觀察代理程式的失敗模式，隨後編寫針對性的文件來填補這些差距。

• 文件內容應精簡並聚焦於觸發條件，使用「Use when」句型來優化代理程式在執行任務時的搜尋與檢索效率。

• 避免將此機制用於一次性任務；請將此流程保留給具備持久性與廣泛適用性的工程技巧、模式或工具。