steering-specs-generator

Steering Specs Generator 是一個強大的工具，旨在彌合人類專業知識與機器可讀文件之間的差距。它擅長捕捉開發團隊中常見、通常未被明文記載的隱性工程知識。透過執行結構化、具備情境意識的訪談，此代理程式能提取關鍵的領域與架構見解——範圍涵蓋設計不變量 (design invariants)、業務合約到程式碼庫拓撲——並將其轉換為高品質、可執行的文件，即所謂的「指導規範」(steerings)。專為架構師、技術主管與團隊領導者設計，確保團隊獨特的實務、約定與品質標準被條理化，供人類開發者與未來的 AI 代理程式準確遵循。

• 透過智慧儲存庫掃描，自動發現現有的專案約定、README 檔案與架構文件。
• 提供八種不同的訪談套件，涵蓋程式碼庫拓撲、業務領域合約、安全性、測試策略等面向。
• 支援自訂主題，讓團隊能記錄特定的、利基的作業流程或內部函式庫限制。
• 具備互動式與快速模式訪談功能，以適應不同程度的使用者參與度與時間限制。
• 產出標準化、Markdown 格式的輸出，遵循「意圖 (Intent)-規則 (Rules)-實踐 (Practices)-中繼資料 (Meta)」結構，確保最大清晰度。
• 智慧工作階段管理，允許使用者在多次工作間隔中暫停、儲存並恢復知識提取工作階段。

使用場景包括需要記錄團隊約定時，或新成員需要快速熟悉現有實務時。對於建立一致的架構分層、依賴管理規則與品質保證流程特別有效。此工具需要具備類似 AskUserQuestion 的標準 IO 工具與任務執行能力。初始化時，代理程式會掃描現有的 .sessions/ 資料夾以自動偵測先前的作業。產生的指導規範應儲存於如 ./steerings/ 或 .memory-bank/ 等專用位置，以利與其他開發者工作流程順暢整合。使用者應將輸出保持在儲存庫結構內，確保產生的知識庫能隨實際程式碼同步演進，成為工程最佳實踐、安全性要求與歷史技術債的即時維護文件。