根 CLAUDE.md 从 80 行压缩到 15 行,详细规则拆分到按需加载位置: - .claude/rules/development.md — 开发规则、测试要求、commit 规范 - .claude/rules/release.md — 发版流程、纪律、Release Notes 格式、构建说明 - docs/CLAUDE.md — docs 目录导航,要求检索前先读子目录 README - src/lib/bridge/CLAUDE.md — bridge 模块关键约定(runAdapterLoop 时序、 bridgeModeActive 互斥、offset 安全水位、adapter 扩展方式) 目的:减少每次会话的固定上下文消耗,非相关模块的文档不加载到上下文。 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.0 KiB
1.0 KiB
Development Rules
提交前必须详尽测试:
- 每次提交代码前,必须在开发环境中充分测试所有改动的功能,确认无回归
- 涉及前端 UI 的改动需要实际启动应用验证(
npm run dev或npm run electron:dev) - 涉及构建/打包的改动需要完整执行一次打包流程验证产物可用
- 涉及多平台的改动需要考虑各平台的差异性
新增功能前必须详尽调研:
- 新增功能前必须充分调研相关技术方案、API 兼容性、社区最佳实践
- 涉及 Electron API 需确认目标版本支持情况
- 涉及第三方库需确认与现有依赖的兼容性
- 涉及 Claude Code SDK 需确认 SDK 实际支持的功能和调用方式
- 对不确定的技术点先做 POC 验证,不要直接在主代码中试错
Commit 信息规范:
- 标题行使用 conventional commits 格式(feat/fix/refactor/chore 等)
- body 中按文件或功能分组,说明改了什么、为什么改、影响范围
- 修复 bug 需说明根因;架构决策需简要说明理由