pattern-detection

Pattern-detection 技能在 The Agentic Startup 框架中扮演專業代碼庫分析師的角色。它系統性地發現、驗證並記錄跨越命名、架構、測試和組織這四大核心領域的重複慣例。透過對多個檔案進行調查，該代理程式能區分刻意的實踐與意外的偏差，確保新代碼能無縫整合到現有的儲存庫生態系統中。

• 自動化調查：分析每個模組中 3-5 個代表性檔案，以偵測命名慣例（如 kebab/PascalCase）、架構層級（如 MVC/Hexagonal）及測試檔案放置策略。

• 衝突解決：自動浮現不一致之處，例如發散的命名風格或導入順序，並根據記錄的風格指南或專案內的流行程度提供可執行的建議。

• 基於證據的報告：生成結構化的 PatternReport，包含已確認的模式、已識別的衝突以及具備明確檔案行數參考的實施建議。

• 具備工具感知決策：優先採用由 linter 配置（如 ESLint、Prettier）或現有 CONTRIBUTING.md 指南強制執行的模式，以維護技術治理。

• 特定情境指導：根據正在修改的特定目錄或功能量身定制建議，確保即使在全域標準不明確時，也能尊重局部慣例。

• 非常適合剛接觸新代碼庫、執行代碼審查或實施需要嚴格一致性的新功能的開發人員使用。

• 使用方式為將檔案、目錄或模組路徑作為參數傳遞；代理程式會掃描相關檔案以建立代碼庫「DNA」的完整狀態。

• 限制條件包括要求進行多檔案驗證；為了防止誤報，代理程式拒絕僅基於單一實例聲明模式。

• 強調一致性勝過個人偏好；即使現有的專案模式並非行業標準的最佳實踐，代理程式也會優先推薦使用既有模式。

• 當與 /specify 或 /implement 命令搭配使用時效果極佳，能確保新的實施計畫與既有的架構約束保持一致。