sherlock-review

Sherlock-review 是一種專業的質量工程技能，專為法庭式代碼分析和開發者主張的嚴格驗證而設計。它採用福爾摩斯式的軟件維護方法，要求代理在對錯誤修復、功能實作或性能改進下結論之前，必須收集經驗證據。該技能超越了表層閱讀，要求代碼必須被執行並通過獨立測試驗證，以確保代碼確實執行了 PR 說明中所聲稱的操作。此工具適用於資深工程師、品質保證專家和調查人員，他們需要解決技術報告中的歧義，並確保修復方案解決的是根本原因而非症狀。對於「在我的機器上能運行」不足以作為解釋的高風險調試會議特別有效。

• 使用 git diff、日誌分析和本地測試執行進行自動化證據收集。

• 實作結構化的三步調查工作流程：觀察（收集數據）、演繹（比較主張與現實）和結論（附帶證據的判決）。

• 對調查結果實行嚴格的分類系統：TRUE、PARTIALLY TRUE、FALSE 或 NONSENSICAL。

• 強制執行最低調查結果權重門檻，確保每次調查都能產生可操作的高品質情報。

• 提供標準化的調查模板，以確保報告和文檔的一致性。

• 具備與車隊協調工具的整合功能，允許根據主張類型觸發並行的領域特定審核（如安全性、性能、測試）。

• 始終優先考慮可重現性；只信任通過驗證測試斷言的代碼。

• 準備好識別危險信號，例如靜默吞噬錯誤、在玩具數據集上進行性能測試，或使用臨時變通方案代替真正的架構修復。

• 此技能需要訪問存儲庫的 git 歷史記錄、測試套件和環境特定的運行時配置。

• 對於所有報告，請使用提供的調查模板，以維持其他自動化流水線代理預期的輸出格式。

• 若調查結果暗示系統性疏忽或重複的架構故障，可結合 brutal-honesty-review 使用。