Agent skill · software engineering · affaan-m
cpp-coding-standards
基于C++核心指南（isocpp.github.io）的C++编码标准。在编写、审查或重构C++代码时使用，以强制实施现代、安全和惯用的实践。
Why this skill is useful
Codifies modern C++ coding standards and practices that the AI could infer but doesn't have to guess.
What it needs
About 9k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
C++ 编码标准（C++ 核心准则） 源自 C++ 核心准则 的现代 C++（C++17/20/23）综合编码标准。强制执行类型安全、资源安全、不变性和清晰性。 何时使用 编写新的 C++ 代码（类、函数、模板） 审查或重构现有的 C++ 代码 在 C++ 项目中做出架构决策 在 C++ 代码库中强制执行一致的风格 在语言特性之间做出选择（例如，enum 对比 enum class，原始指针对比智能指针） 何时不应使用 非 C++ 项目 无法采用现代 C++ 特性的遗留 C 代码库 特定准则与硬件限制冲突的嵌入式/裸机环境（选择性适配） 贯穿性原则 这些主题在整个准则中反复出现，并构成了基础： 1. 处处使用 RAII (P.8, R.1, E.6, CP.20)：将资源生命周期绑定到对象生命周期 2. 默认为不可变性 (P.10, Con.1-5, ES.25)：从 const/constexpr 开始；可变性是例外 3. 类型安全 (P.4, I.4, ES.46-49, Enum.3)：使用类型系统在编译时防止错误 4. 表达意图 (P.3, F.1, NL.1-2, T.10)：名称、类型和概念应传达目的 5. 最小化复杂性 (F.2-3, ES.5, Per.4-5)：简单的代码就是正确的代码 6. 值语义优于指针语义 (C.10, R.3-5, F.20, CP.31)：优先按值返回和作用域对象 哲学与接口 (P.\, I.\) 关键规则 规则 摘要 ------ --------- P.1 直接在代码中表达想法 P.3 表达意图 P.4 理想情况下，程序应是静态类型安全的 P.5 优先编译时检查而非运行时检查 P.8 不要泄漏任何资源 P.10 优先不可变数据而非可变数据 I.1 使接口明确 I.2 避免非 const 全局变量 I.4 使接口精确且强类型化 I.11 切勿通过原始指针或引用转移所有权 I.23 保持函数参数数量少 应该做 不应该做 函数 (F.\) 关键规则 规则 摘要 ------ --------- F.1 将有意义的操作打包为精心命名的函数 F.2 函数应执行单一逻辑操作 F.3 保持函数简短简单 F.4 如果函数可能在编译时求值，则将其声明为 constexpr F.6 如果你的函数绝不能抛出异常，则将其声明为 noexcept F.8 优先纯函数 F.16 对于 "输入" 参数，按值传递廉价可复制类型，其他类型通过 const& 传递 F.20 对于 "输出" 值，优先返回值而非输出参数 F.21 要返回多个 "输出" 值，优先返回结构体 F.43 切勿返回指向局部对象的指针或引用 参数传递 纯函数和 constexpr 反模式 从函数返回 T&& (F.45) 使用 vaarg / C 风格可变参数 (F.55) 在传递给其他线程的 lambda 中通过引用捕获 (F.53) 返回 const T，这会抑制移动语义 (F.49) 类与类层次结构 (C.\) 关键规则 规则 摘要 ------ --------- C.2 如果存在不变式，使用 class；如果数据成员独立变化，使用 struct C.9 最小化成员的暴露 C.20 如果你能避免定义默认操作，就这么做（零规则） C.21 如果你定义或 =delete 任何拷贝/移动/析构函数，则处理所有（五规则） C.35 基类析构函数：公开虚函数或受保护非虚函数 C.41 构造函数应创建完全初始化的对象 C.46 将单参数构造函数声明为 explicit C.67 多态类应禁止公开拷贝/移动 C.128 虚函数：精确指定 virtual、override 或 final 中的一个 零规则 五规则 类层次结构 反模式 在构造函数/析构函数中调用虚函数 (C.82) 在非平凡类型上使用 memset/memcpy (C.90) 为虚函数和重写函数提供不同的默认参数 (C.140) 将数据成员设为 const 或引用，这会抑制移动/拷贝 (C.12) 资源管理 (R.\) 关键规则 规则 摘要 ------ --------- R.1 使用 RAII 自动管理资源 R.3 原始指针 (T) 是非拥有的 R.5 优先作用域对象；不要不必要地在堆上分配 R.10 避免 malloc()/free() R.11 避免显式调用 new 和 delete R.20 使用 uniqueptr 或 sharedptr 表示所有权 R.21 除非共享所有权，否则优先 uniqueptr 而非 sharedptr R.22 使用 makeshared() 来创建 sharedptr 智能指针使用 RAII 模式 反模式 裸 new/delete (R.11) …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/cpp-coding-standards--cc7aa1