create-technical-spike 是做什麼的?
建立限時技術調研文件 (Technical Spike),用於在實作前研究並解決關鍵的開發決策問題。
概述
此技能(Skill)會自動產生結構化的限時技術調研文件(Technical Spike),幫助開發團隊在正式實作之前,系統性地研究與評估關鍵的技術決策。它的核心價值在於透過時間盒(Time-boxed)機制來控制研究範圍,避免無止盡的探索,並強制產出具體結論、可行方案與建議。此技能主要支援 GitHub 平台,透過建立 Issue 或 Pull Request 來啟動調研流程。文件內容通常會包含問題描述、研究目標、探索過的方案、實驗結果、風險評估以及最終建議,讓團隊能基於事實做出更穩健的技術選擇,從而降低實作階段的風險與不確定性。
使用方式
- 在 GitHub 上建立一個新的 Issue 或 Pull Request。
- 將此技能 (Skill) 指派給 Issue 或 Pull Request。
- 技能會自動產生並附加限時技術調研文件。
文件結構
產生的技術調研文件將包含以下章節:
- 問題陳述:清晰描述需要解決的技術問題或決策。
- 研究目標:列出在時間盒內需要達成的具體目標。
- 探索方案:記錄所有被探索過的技術方案或方法。
- 實驗結果:說明進行過的實驗、測試結果與觀察。
- 風險評估:分析每個方案的潛在風險與影響。
- 建議:根據研究結果提出最終建議與下一步行動。
最佳實踐
- 設定明確且合理的時間盒(例如:2-4 小時或 1 天)。
- 專注於回答特定的技術問題,而非全面性的解決方案。
- 記錄所有探索過的選項,即使最終未採用。
- 確保文件中的結論具有可操作性,提供清晰的後續步驟。
支援平台
- GitHub