用途:为 C++ 项目提供统一的编码规范与最佳实践,帮助开发者或 AI 代理按一致风格编写与评审代码。
主要能力:覆盖基础原则(英文代码与文档、显式声明类型、Doxygen 注释、遵循单一定义规则)、命名约定(类用 PascalCase、变量与函数用 camelCase、常量与宏用全大写、文件目录用 snake_case)、函数规范(短小单一职责、谓词式布尔命名、提前返回减少嵌套、使用标准库算法与 lambda)、数据与类设计(封装、const 与 constexpr、std::optional、SOLID、组合优于继承、五法则或零法则)、异常与错误处理(异常用于意外错误,std::optional、std::expected 或错误码用于可预期失败)、内存管理(智能指针与 RAII)、测试(Arrange-Act-Assert、Given-When-Then、为每个公共函数与模块编写测试)、项目结构(include/src/test/lib/doc 目录划分、CMake、头文件与实现分离、命名空间),以及标准库与并发(std::thread、std::mutex、std::atomic)。
使用方式:作为编码约定参考直接套用;附带一套内存协议,要求开始前执行 cat .claude/context/memory/learnings.md,完成后记录新发现的模式或例外。
适用场景:C++ 代码编写、代码评审与规范统一。
限制:未提供具体版本要求、编译器约束、完整代码示例与工具链配置;内存协议中的文件路径依赖具体项目环境。