ring:writing-skills

Writing Skills 是一套將流程文檔轉化為 AI 代理可執行與可測試代碼的系統化方法論。透過將文檔視為「生產代碼」，並將交互情境視為「單元測試」，此技能為所有流程指南強制執行嚴格的 RED-GREEN-REFACTOR 循環。它專為工程師、系統架構師和提示工程師設計，確保 AI 代理在複雜工作流程中始終如一地執行，而不會在壓力下偏離或合理化違規行為。流程始於定義基準失敗情境，觀察代理當前行為，撰寫文檔以解決具體差距，並持續迭代直到代理的表現對於常見失敗模式達到絕對可靠。

• 實作文檔創建的 RED-GREEN-REFACTOR 循環：定義失敗情境、執行測試、撰寫技能、並重構以填補漏洞。

• 利用子代理驅動的壓力測試，將 AI 代理推向邊緣情境，以驗證對文檔規則的遵守情況。

• 透過要求在創建文檔前提供基準失敗證據，有效防止代理進行「合理化」違規。

• 專注於創建可重複使用的技術、模式和參考指南，而非單次使用的解決方案。

• 提供 SKILL.md 結構化模板，包含名稱與描述的元數據欄位，確保透過代理搜尋優化 (ASO) 進行高效發現。

• 最適用於需要高可靠性工作流、合規性要求高或複雜技術程序的場景。

• 不適用於一次性解決方案或已有現成文檔的標準實務。

• 使用者需熟悉測試驅動開發 (TDD) 原則，以有效創建和重構壓力測試情境。

• 文檔應保持精簡以優化 Token 使用效率；利用特定觸發條件與症狀來引導代理自動載入。

• 在「紅色」階段務必記錄代理所有的具體合理化行為，以便在「綠色」階段建立更強大、更健全的文檔。