Everything Claude Code C++ Coding Standards Skill 是一套基于 C++ Core Guidelines 的现代 C++ 编码规范，专为 AI 编程助手（如 Claude Code、Codex、Cursor）场景设计。它系统化地规范了 C++17/20/23 项目的类型安全、RAII、不可变性、接口与资源管理、并发、模板、异常处理等关键领域，极大提升了 AI 辅助代码生成、审查、重构和团队协作中的一致性与安全性。通过 Skill 体系，你可以一键为项目启用生产级 C++ 规范，显著降低 Bug 和技术债。

Everything Claude Code C++ Coding Standards Skill：基于 C++ Core Guidelines 的现代、安全、惯用编码规范

在 AI 辅助编程时代，C++ 项目的代码质量和一致性直接影响到开发效率与系统安全。Everything Claude Code C++ Coding Standards Skill（以下简称 cpp-coding-standards Skill）是基于 C++ Core Guidelines 精炼而成的生产级编码规范，专为 Claude Code、Codex、Cursor 等 AI 编程助手生态打造。它不仅覆盖了现代 C++（C++17/20/23）最核心的最佳实践，还针对 AI 代码生成、审查和重构场景做了细致适配，是提升 AI 辅助 C++ 开发效率与质量的必备组件。

1. 这个 Skill 解决什么问题？

在没有 cpp-coding-standards Skill 的情况下，AI 生成的 C++ 代码常见如下痛点：

• 代码风格和接口设计不统一，团队协作和代码审查难度大
• 容易出现裸指针、资源泄漏、未初始化、未受约束模板等安全隐患
• 现代 C++ 特性（如 RAII、智能指针、constexpr、concepts）应用不充分，导致代码难以维护和扩展
• 代码生成/重构时，AI 难以自动对齐企业或开源项目的高标准要求

通过启用 cpp-coding-standards Skill，可以：

• 系统性约束 AI 生成或修改的 C++ 代码必须符合 C++ Core Guidelines 精华
• 自动识别并修正常见反模式（如裸 new/delete、C-style cast、未受约束模板等）
• 让代码审查、重构和团队协作流程高度标准化，减少主观争议
• 结合其他 Agent/Skill，形成“生成-审查-修复-验证”闭环，显著提升生产效率

2. 触发条件与激活时机

cpp-coding-standards Skill 适用于以下典型场景：

• 新建 C++ 模块/类/函数时：AI 生成的所有代码自动对齐现代 C++ 规范
• 代码审查（Code Review）或重构：AI 审查代理会基于此 Skill 检查并建议修正不规范代码
• 架构设计与接口评审：AI 参与接口设计决策，优先推荐强类型、不可变、RAII 等最佳实践
• 跨团队/多仓库协作：统一代码风格和安全基线，降低合并冲突和技术债

Skill 会被以下 Agent 自动调用：

• C++ Reviewer Agent：代码审查、风格和安全性检查
• C++ Build Resolver Agent：构建错误与模板/链接问题修复
• Code Reviewer Agent：跨语言代码质量审查时的 C++ 专项规则
• 以及任何支持 Skill 体系的自定义 Agent

3. 使用流程 Step by Step

步骤 1：安装与激活

1. 按照 Everything Claude Code 安装配置指南 安装插件，并在配置向导中勾选“cpp-coding-standards” Skill。
2. 在 .claude/skills.yaml 或项目 Skill 配置文件中，确保包含：

- name: cpp-coding-standards

3. 保存配置后，AI Agent 会在下次 C++ 相关操作时自动加载规范。

步骤 2：新建/修改 C++ 代码时自动应用规范

• 直接在 Claude Code、Cursor 等编辑器中让 AI 生成 C++ 代码，Skill 会自动约束输出风格和接口设计。
• 例如，AI 生成的类会默认使用 RAII、智能指针、explicit 构造、enum class、const 修饰等惯用写法：

// AI 生成的推荐写法
class FileHandle {
public:
    explicit FileHandle(const std::string& path);
    ~FileHandle();
    FileHandle(const FileHandle&) = delete;
    FileHandle& operator=(const FileHandle&) = delete;
    FileHandle(FileHandle&&) noexcept;
    FileHandle& operator=(FileHandle&&) noexcept;
private:
    std::FILE* handle_;
};

步骤 3：代码审查与重构

• 提交 PR 或运行 C++ Reviewer Agent 时，Skill 会自动扫描以下问题并建议修复：
  • 裸指针/裸 new/delete
  • 未初始化变量
  • C-style cast、magic number、未受约束模板
  • 非 enum class 枚举、全局变量、未加 const/constexpr
• 典型输出示例：

[cpp-coding-standards]
- 建议将 enum 替换为 enum class，避免命名污染
- 检查到成员函数未加 const，建议加上以提升不可变性
- 发现裸指针资源管理，建议使用 std::unique_ptr 并采用 RAII
- 检查到 C-style cast，建议使用 static_cast/const_cast

步骤 4：与其他 Agent/Skill 协作

• 搭配 C++ Testing Skill 可自动生成符合规范的 GoogleTest/CTest 测试代码
• 与 Verification Loop 结合，实现“生成→审查→测试→验证”全流程自动化
• 支持在 Rules 体系 中作为 C++ 规则集基础，可与 TypeScript/Java/Rust 等多语言规范并存

步骤 5：交付前 Checklist 快速自查

Skill 附带一份“交付前自查清单”，如：

• [ ] 禁止裸 new/delete，全部用智能指针或栈对象
• [ ] 全部变量初始化，默认 const/constexpr
• [ ] 枚举全部用 enum class
• [ ] 禁止 C-style cast、magic number
• [ ] 单参构造 explicit
• [ ] 模板参数有 concepts 约束
• [ ] 头文件自包含、无 using namespace
• [ ] 锁用 lock_guard/scoped_lock
• [ ] 异常为自定义类型，catch by reference

4. 输出示例

AI 生成的代码片段（Skill 自动应用）：

enum class LogLevel { debug, info, warning, error };

class Logger {
public:
    explicit Logger(std::string name) : name_(std::move(name)) {}
    void log(LogLevel level, std::string_view msg) const;
private:
    std::string name_;
};

审查输出示例：

[cpp-coding-standards]
- 建议将 int errorCode 替换为自定义异常类型并 throw by value
- 检查到成员变量未初始化，建议在构造函数初始化列表中初始化
- 建议将裸指针参数改为 const 引用或智能指针

5. 常见配套 Agent 与 Skill 协作

• C++ Reviewer Agent：对 C++ 代码进行深度规范性和安全性审查
• C++ Build Resolver Agent：解决构建、链接、模板相关的技术细节
• C++ Testing Skill：生成符合规范的单元测试和覆盖率报告
• Verification Loop Skill：自动化端到端验证，确保生成和修复后的代码符合规范
• Rules 体系：作为多语言项目的 C++ 规则集基础，与 TypeScript、Java、Rust 等规范并存

更多 Skill/Agent 组合方式可参考 Everything Claude Code 完全指南。

---

FAQ

Q: 这个 Skill 能自动修复不规范的 C++ 代码吗？
A: 可以。配合审查 Agent 使用时，AI 会自动识别并建议或直接修复常见规范问题。

Q: Skill 是否兼容旧版 C++ 或嵌入式项目？
A: Skill 主要针对 C++17/20/23，部分规则对极端嵌入式或 C 兼容项目需酌情适配。

Q: 如何与自定义项目规范协同？
A: 可在项目级 Skill 配置中扩展或覆盖部分规则，实现团队专属的 C++ 规范体系。

---