piaoxuemoli Defense Docs (答辩材料)
为 Kaiwu_2026 仓库编写和维护答辩材料。
When to Use
- 团队要求补充/更新答辩材料
- 新增创新点需要记录
- 基础设施、工具链、工程实践有新内容需要写入答辩文档
- 整理某个维度（特征/奖励/网络/训练/工程）的答辩内容
Don't use for: wiki/ 索引更新（用 wiki-sync）、代码变更记录（用实验记录）
文档结构
docs/答辩材料总结/
├── 答辩总文档.md # 主文档，按维度分类全部创新点
├── 特征/ # 特征工程相关
├── 奖励/ # 奖励设计相关（如需）
├── 网络/ # 网络架构相关
├── 训练/ # 训练策略相关
├── 经典问题/ # 深度技术分析
└── 工程/ # 工程实践、基础设施、工具链
写作规范
1. 内容格式
每个创新点遵循「三段式」：
### X.Y 标题
**官方做法**：简述官方基线怎么做的，有什么问题
**我们的做法**：详述我们的方案，含代码片段/公式/架构图
**核心价值**：一句话总结为什么这样做更好
2. 技术细节要求
- 代码片段：展示关键实现，不超过 15 行，加 Python/伪代码注释
- 维度/权重表：用 Markdown 表格列出具体数值
- 对比分析：与官方基线、马可波罗队、2025 老版本对比
- 理论依据：引用论文或经典结论时给出出处
3. 答辩总文档更新
新增内容时：
- 在
答辩总文档.md对应章节末尾添加摘要段落 - 用
> 详见 [子目录/文件名.md](子目录/文件名.md)链接详细文档 - 摘要不超过 10 行，核心信息用表格呈现
- 如有新维度，在「九、附录：创新点统计」表中更新计数
4. 答辩话术
重要创新点应附带 30 秒话术模板：
### 答辩话术（XX 秒）
> "一句话点明问题 → 我们的方案 → 核心数据/对比"
Git 提交规范
答辩材料提交严格遵守 AGENTS.md 规范：
身份
git -c user.name="QoobeeHermes" -c user.email="qoobeehermes@kaiwu2026" commit -m "..."
Commit Message
docs(wiki): <描述>
- 用
docs类型 - scope 用
wiki（答辩材料属于文档类） - 描述简洁，中文即可
操作步骤
# 1. 查看变更
git status
# 2. 只 add 答辩材料相关文件（禁止 git add .）
git add "docs/答辩材料总结/工程/新文件.md"
git add "docs/答辩材料总结/答辩总文档.md"
# 3. 提交（QoobeeHermes 身份）
git -c user.name="QoobeeHermes" -c user.email="qoobeehermes@kaiwu2026" \
commit -m "docs(wiki): <描述>"
# 4. 推送到 dev（禁止推 master）
git push origin dev
Pitfalls
- 不要混合提交：答辩材料的 commit 不要夹带代码改动
- 不要
git add .：必须指定文件路径 - 中文路径转义：git status 显示的中文路径是八进制转义，add 时用引号包裹原始中文路径
- 主文档链接：新增的详细文档必须在答辩总文档中有对应的摘要+链接，否则答辩时找不到
信息收集
写答辩材料前，先从以下来源收集信息：
- 代码文件：读取相关 .py 文件的实际实现
- 参考资料/：官方文档、赛制说明
- wiki/：已有的架构/API 索引
- git log：相关 commit 的改动和 message
- AGENTS.md：仓库结构和成员信息
- 服务器环境：
uname -a、python3 --version等实际配置
验证清单
- 内容遵循三段式格式
- 代码片段有注释，不超过 15 行
- 数值/维度有表格支撑
- 答辩总文档有摘要 + 链接
- 创新点统计表已更新（如需）
- git commit 用 QoobeeHermes 身份
- 只 add 了答辩材料文件，未混入其他改动
- 推送到 dev 分支