🔧 chore(standards): sync cpp playbook rules

Vendor standards live under docs/standards/playbook and are synced into .agents/cpp.

Add AGENTS.md entries so agents working in lsp-server follow the C++ ruleset and standards.
This commit is contained in:
csh
2025-12-14 17:57:26 +08:00
parent dbdde4ed48
commit 7c13d70d3a
9 changed files with 284 additions and 0 deletions
+34
View File
@@ -0,0 +1,34 @@
# 代码质量(Code Quality
本文件定义代理对代码质量的最低要求与审查清单(C++)。
## 1. 总体要求
- C++ 代码遵守 `docs/cpp/code_style.md``docs/cpp/naming.md`(在目标项目中通常 vendoring 到标准快照路径)。
- 统一使用 `clang-format`(Google 基线)保持格式一致;不要手工“对齐排版”制造 diff 噪音。
- 改动聚焦目标;避免“顺手重构”。
- API 变更要显式说明影响与迁移方式。
- 涉及三方依赖(例如 Conan)的改动必须说明动机、替代方案与影响面;默认不“顺手升级依赖”。
- 涉及 C++ Modules 的改动(`.cppm``export module` 变更)必须同步更新构建系统的模块清单与相关 target 配置。
## 2. 可读性
- 复杂逻辑拆分为具名函数/类型;避免深层嵌套与重复代码。
- 必要注释解释“为什么”而不是“做什么”。
## 3. 错误处理与资源管理
- 默认使用 RAII;避免裸 `new/delete`
- 失败路径必须可观测(返回值/异常/日志其一或按项目约定)。
## 4. 复杂度与规模
- 单函数尽量 ≤ 80 行;超过应说明原因或拆分(可按项目调整)。
- 单次 PR 尽量小步提交,便于 review。
## 5. Review 清单
- 是否有无关改动?
- 是否保持模块内风格一致?
- 是否引入不必要的复杂度/依赖?
- 是否有最小验证(构建/冒烟)步骤?