研究技能
有效調查技術問題,並將所學持久化,讓團隊永遠不必重複調查相同的主題。
1. 界定範圍
從使用者的訊息中提取(僅在真正不清楚時才提問):
- 主題 slug:kebab-case 格式的資料夾名稱,例如
bluetooth-audio-routing - 技術棧:平台/語言/框架
- 症狀:觀察到的行為 vs. 預期行為
- 已知:已嘗試過的假設
2. 準備工作區
執行 scripts/init-research.sh {topic-slug} 以建立 docs 資料夾。
3. 平行啟動 3 個預設代理
每個代理獲得一句話的角度以及共用上下文。當你需要確切的提示措辭時,請參閱 reference/agent-prompts.md。
- 程式碼庫分析(探索代理)— 找出相關程式碼、缺口、檔案:行號參考。
- 根本原因理論(網頁代理)— 在作業系統/框架/協定層級為什麼會發生。
- 解決方案與驗證(網頁代理)— 原生 API、函式庫、社群確認的修正。
僅在使用者明確要求比較函式庫或跨平台 API 深入探討時,才生成第 4/5 個可選代理。
4. 統整
確切建立以下兩個檔案:
docs/{topic}/NOTAS.md— 原始發現、程式碼片段、URL、快速觀察。docs/{topic}/RESEARCH_CONSOLIDADO.md— 結構化的主文件。
僅在需要完整範本時使用 reference/consolidated-template.md。可選的詳細檔案(03_android_api.md、04_librerias.md 等)僅在發現合理時才建立。
5. 完成
執行 scripts/finalize-research.sh {topic-slug} 以驗證主文件是否存在並附加一個迭代行。然後向使用者回報:
- 根本原因(如果適用,附上檔案:行號)
- 前三項非顯而易見的發現
- 已建立的檔案
- 建議的下一步行動
保持聊天報告簡潔;詳細內容存在於文件中。