来源:
AGENTS.md
CONTRIBUTING.md
ai/project-map.yml
ai/test-matrix.yml
commit d32b9cc880a8
docs-explanation
常见贡献任务¶
先读取根 AGENTS.md，再读取最近的子目录说明。下表只负责找到入口；路径与命令仍需
在实际修改的源码 commit 上核对。
| 目标 | 首先检查 | 首个验证 |
|---|---|---|
| 修复 C++ 行为 | 所属 src/ 类型、调用者、相关 tests/ |
C++ 格式与聚焦 Catch2 测试 |
| 增加 JSON 内容 | 当前相似数据与 loader/factory | JSON 格式、完整加载、ID 检查 |
| 修改 EOC | EOC 数据、解析注册、talker/context 测试 | JSON 加载与聚焦 EOC 解析/测试 |
| 修改 Lua v5 | Manifest Schema、LuaLS、native 注册、清单 | 声明、parity、coverage、示例 |
| 更新捆绑 Mod | modinfo.json、依赖、interactions |
加载该 Mod 与受支持组合 |
| 定位构建失败 | 精确平台、preset/options、第一个失败 | 重跑最窄失败阶段 |
| 上游移植 | 精确来源 commit/PR 与 CCB 分歧 | 聚焦行为和兼容检查 |
| 修改文档 | Catalog 条目与声明的源码路径 | 生成/check、strict build、内部链接 |
创建 PR 前¶
- 检查最终 diff 没有无关修改、误改生成文件、缓存、凭据或本机路径。
- 指定 Responsible human，并提供有效 Summary。
- 分开列出 Passed、Failed、Not run，包含平台和准确命令。
- 填写 Documentation impact、Related CCB-Docs PR、Affected documentation IDs 与 Generated reference impact。
- 兼容敏感变化需明确说明存档、ID、Mod、Lua API 和平台影响。