debug-hooks

debug-hooks 技能為使用 Continuous Claude 掛鉤架構的開發人員提供了一個全面、逐步的診斷框架。當自動化觸發、自定義檔案追蹤或技能自動激活行為失敗時，此工具將引導使用者檢查 Claude Code 環境的關鍵驗證層。它專為維護複雜代理工作流程的工程師和開發人員而設計，用於識別 .claude/hooks 目錄內的靜默失敗、配置不匹配或捆綁包同步問題。

• 系統化診斷掛鉤執行失敗，包括 UserPromptSubmit、SessionEnd 和 PostToolUse 事件。

• 驗證專案和全域 settings.json 檔案中的掛鉤註冊情況。

• 檢查內部檔案結構，包含 shell 包裝器和 esbuild 建立的捆綁 .mjs 檔案。

• 使用預定義的 JSON 負載對單個掛鉤進行手動測試，以模擬工具觸發。

• 針對可能導致隱藏運行時錯誤的分離程序和常見的 stdio: 'ignore' 陷阱進行進階疑難排解。

• 確保 TypeScript 源檔案正確捆綁到活動執行環境的自動化協調流程。

• 在修改配置之前，請務必先檢查 .claude/cache/ 目錄，確認日誌和學習內容是否正確生成。

• 確保所有 shell 腳本均可執行，且 settings.json 正確將觸發器映射到正確的腳本路徑。

• 請記住，編輯 TypeScript 源檔案需要使用 esbuild 手動重新建置；在 .mjs 捆綁包更新前，更改不會反映在環境中。

• 如果掛鉤看起來已執行但沒有輸出，請檢查是否有分離的 spawn 配置可能抑制了標準錯誤輸出 (stderr)。

• 使用提供的清單確保開發環境與本地執行環境的一致性，特別是在 node 和 npx 依賴方面。

• 此工具專供管理 Continuous Claude 生態系統的技術使用者使用，當標準代理行為偏離預期工作流程時，應使用此工具。