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 文件中的集中式夹具管理，以减少技术债务和冗余的代码模式。