القائمة
在编写、修改或评审 C++ 代码（.cpp/.cc/.hpp、类、模板、RAII、智能指针、C++ 测试、C++ ABI 边界）时使用。提供资源管理、所有权签名、类设计、错误策略、模板纪律与 ABI 的具体规则与正反例。只适用于 C++；C 或其他语言代码使用对应语言自己的 coding-standards 技能。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
在规格、设计、测试或代码需要独立评审时使用：阶段产物完成后的把关、人要求 review、或对既有产物做专项检查时。评审必须由作者之外的独立上下文执行，产出 findings 与 verdict。
在实现任何功能或修复任何缺陷、即将编写实现代码时使用；设计确认后的整个实现期都适用。强制测试先行的 RED→GREEN→REFACTOR 循环。不用于规格编写、设计决策或纯文档修改。
在车载软件工作项（ECU、域控、车载服务、整车平台）的规格、设计、实现或评审中使用，涉及功能安全/ASIL、车载 SOA 服务、DTC/诊断、整车启动/休眠/唤醒、SELinux 或跨 ECU 协同时。只承载车载专属约束；内存/实时性、通用服务接口或其他相邻领域规则由命中 description 的领域技能叠加，语言级规则见适用 `<language>-coding-standards`。
在后端/服务端工作项（HTTP/REST/GraphQL API、服务与仓库层、数据库访问、缓存、鉴权、限流、后台任务、可观测性、配置与机密、弹性容错、生产就绪）的规格、设计、实现或评审中使用，涉及接口契约、分层与依赖方向、配置与机密、错误模型、数据一致性、幂等、认证授权、依赖超时重试熔断、过载保护、优雅停机时。只承载服务端/API 领域约束；客户端/UI、行业专属服务或其他相邻领域规则由命中 description 的领域技能叠加，语言级规则见适用 `<language>-coding-standards`。
在编写、修改或评审 C 代码（.c 源文件、.h 头文件、C 单元测试、C ABI 边界）时使用。提供指针所有权、手动内存与资源释放、缓冲区容量、整数转换、宏、头文件、错误返回的具体规则与正反例。只适用于 C 语言；其他语言或 C++ 代码使用对应语言自己的 coding-standards 技能。
在需要为某种编程语言新建或修订 coding-standards 技能时使用：把团队内部编码规范文档转化为符合 DevFlow 形态的 <language>-coding-standards 技能，或把新的团队规则并入既有语言技能。不用于编写业务代码或直接做代码评审。
| name | cpp-coding-standards |
| description | 在编写、修改或评审 C++ 代码（.cpp/.cc/.hpp、类、模板、RAII、智能指针、C++ 测试、C++ ABI 边界）时使用。提供资源管理、所有权签名、类设计、错误策略、模板纪律与 ABI 的具体规则与正反例。只适用于 C++；C 或其他语言代码使用对应语言自己的 coding-standards 技能。 |
现代 C++ 的核心承诺：资源安全可以由结构保证，而不是靠每个人小心。 本技能在 devflow-clean-code 之上叠加 C++ 规则，不能替代通用 clean-code 自检；取向与 C++ Core Guidelines 一致，项目声明了 AUTOSAR C++ / 团队子集时以项目为准。
每种资源（内存、文件、锁、硬件句柄）由一个对象的生命周期管理，构造获取、析构释放。手动配对调用在第一个提前 return / 异常处就会泄漏：
// ❌ 手动配对：中间任何一条提前退出路径都泄漏
void update() {
mutex_.lock();
auto *buf = new uint8_t[kFrameSize];
if (!fetch(buf)) { mutex_.unlock(); return; } // 忘了 delete[]
...
}
// ✅ 结构保证：任何退出路径都正确释放
void update() {
std::lock_guard<std::mutex> lock(mutex_);
std::vector<uint8_t> buf(kFrameSize);
if (!fetch(buf.data())) return;
...
}
new/delete：容器、std::make_unique/std::make_shared、或项目的池分配器lock_guard/unique_lock/scoped_lock，不裸 lock/unlock签名就是所有权文档，按下表选型：
| 意图 | 签名 |
|---|---|
| 只读借用，不存指针 | const T&（可能为空时 const T*） |
| 可变借用 | T& |
| 转移唯一所有权 | std::unique_ptr<T>（按值传/返回） |
| 共享所有权（确有共享需求才用） | std::shared_ptr<T> |
| 观察但不拥有、生命周期由外部保证 | 裸指针/引用 + 契约注释 |
unique_ptr；shared_ptr 必须能回答"谁是第二个 owner"——答不上来就是用它来逃避所有权思考const shared_ptr<T>& 表达借用——借用就传 const T&/T*，不强迫调用方持有特定智能指针weak_ptr，要么在契约中写明注销时序并在析构中强制注销=delete/=default）explicit（隐式转换是事故源）；不打算被继承的类不写 virtual；要继承的基类析构 virtual，重写函数标 overrideinit() 二段构造的设计先回 devflow-design 审视struct 并保持纯数据expected<T, E>（或项目等价 Result 类型），出错路径显式可见；启用时：构造失败抛异常，析构永不抛，边界（C 回调、线程入口、ABI 边界）全部 catch 并翻译[[nodiscard]] 标注可失败的返回值，让"忘了检查"变成编译警告：[[nodiscard]] Result<void> apply_config(const Config &cfg);
noexcept——容器依赖这一点选择 move 还是 copyconst 就 const；多线程下 const 成员函数必须真的线程安全（内部缓存要加锁或 mutable atomic）constexpr，查表数据 constexpr 数组（进只读段）const&；返回值直接按值返回（RVO/move 已解决性能顾虑），不为"省拷贝"返回内部引用而泄漏生命周期static_assert / concepts，按项目标准版本）devflow-design §抽象纪律处理detail 命名空间或 .cpp）devflow-specify 的 modify 流程评估消费者auto 用于右侧类型显然或冗长（迭代器、lambda）；接口边界与数值类型写明确类型enum class 优先于裸 enum{} 防窄化；nullptr 不用 NULL/0[&] 默认捕获——悬垂引用高发区）-Wall -Wextra，项目允许时 -Werror）；clang-tidy 按项目配置，新增项修复或带理由抑制shared_ptr 有真实的第二 owner；存储型观察指针有生命周期契约[[nodiscard]]；析构/move noexcept