jean-claude-dev

此技能為 Jean Claude 框架的維護與發展提供了全面的開發指南。它是專為貢獻者和維護者設計的專業助手，涵蓋了修改框架源代碼、核心編排邏輯及系統架構所需的機構知識、架構模式和測試協議。旨在將抽象的專案目標與具體的實作細節相結合，確保複雜的 AI 驅動工作流的一致性。當您執行涉及 Jean Claude 核心 SDK、事件溯源架構或工作流編排組件的深入開發任務時，請使用此技能。

• 提供有關雙代理工作流（Opus 與 Sonnet 協作）、基於 SQLite 的事件存儲模式以及代理與協調器之間異步信箱通訊的詳細架構指導。

• 涵蓋 Jean Claude 的開發標準，包括 Git 工作樹隔離策略以及用於代理與人類協調的 ntfy.sh 升級機制。

• 提供全面的測試模式，包括強制性的模擬（Mock）修補規則（在引用點而非定義點進行修補）、正確的測試夾具（Fixture）層級架構，以及針對異步函數的 AsyncMock 約定。

• 規範化文檔工作流，包括回顧紀錄（Retrospectives）、技術決策紀錄（ADR）以及針對新功能的研發整合文檔。

• 指導運行專案專屬診斷工具、儀表板監控（SSE 串流）以及代理編排管道中的記憶體洩漏識別。

• 專供開發 Jean Claude 代碼庫或內部架構的貢獻者使用；請勿將此用於一般終端用戶的 CLI 操作或簡單的工作流執行。

• 要求熟悉專案結構，特別是 src/jean_claude/ 下的編排、核心持久化及 CLI 命令模組。

• 強調專案特有的原則，例如可測試的業務邏輯（避免過度模擬 Pydantic 模型或內部 CLI 框架）以及安全的並行測試執行。

• 與專案的知識管理系統（計劃、研究及決策資料夾）整合，確保代碼變更符合既定的架構意圖。

• 遵循嚴格的質量限制，如強制性的 ABOUTME 文件標頭，以及使用 conftest.py 文件中的集中式夾具管理，以減少技術債務和冗餘的代碼模式。