CC-03 · ClaudeCode
01 / 18
Claude Code 的调试、测试与评审
把一个故障变成可复现原因、针对性修复和有证据的交付。
- 明确输入、预期、实际与最小复现。
- 用假设缩小问题，不同时改多个未知因素。
- 选择能发现原问题的验证，并写清覆盖范围。
CC-03 · ClaudeCode
02 / 18
调试与评审架构
CC-03 · ClaudeCode
03 / 18
问题报告
| 信息 | 大小写教学故障 |
|---|---|
| 触发与输入 | 读取 T_Rock.PNG |
| 预期与实际 | 允许 PNG 大写；却被漏检 |
| 环境与政策 | Python 3.12；后缀忽略大小写 |
| 范围 | 保持中文路径与其他规则 |
CC-03 · ClaudeCode
04 / 18
最小复现与基线
Path('资产/T_Rock.PNG').suffix
# 正常小写样本
T_Rock.png
# 导致问题的样本
T_Rock.PNG- 保留故障所需条件，删除无关数据。
- 同时保留正常基线，观察影响范围。
- CSV 文本存在不证明磁盘资产存在。
CC-03 · ClaudeCode
05 / 18
假设与证据
| 假设 | 区分它的检查 |
|---|---|
| 后缀未归一化 | 输出 suffix 并看比较条件 |
| 中文路径损坏 | 读取并比较完整字符串 |
| CSV 字段缺失 | 检查 fieldnames |
| 政策不允许大写 | 回查实际规则与任务 |
CC-03 · ClaudeCode
06 / 18
调查步骤及日志
01
保存失败输入、命令、报错和环境。
02
一次检查一个可区分的假设。
03
根据新观察缩小原因，再决定改动。
04
没有新信息的重复尝试不能替代调查。
CC-03 · ClaudeCode
07 / 18
修复范围
本任务需要
- 允许大写：归一化后比较。
- 规定大小写敏感：保留原值。
- 答案以当前需求为准。
其他规则另有条件
- 名称前缀与重复判定。
- 路径存在性与读取权限。
- 依赖、UI 或数据库不顺手加入。
CC-03 · ClaudeCode
08 / 18
兼容性和异常路径
- 对正常样本确认原有行为仍符合需求。
- 缺列、空表、缺文件不能误报成功。
- 检查输出格式与退出码对下游的影响。
- 政策变化同步规则、样本答案和说明。
CC-03 · ClaudeCode
09 / 18
验证层次
| 层次 | 证明什么 | 不代替什么 |
|---|---|---|
| 函数样本 | 局部规则行为 | 真实环境集成 |
| CLI | 读取、报告、退出码 | 配置实际触发 |
| 集成与环境 | 数据交接和执行 | 主观质量判断 |
| 人工评审 | 可读性和取舍 | 可执行正确性检查 |
CC-03 · ClaudeCode
10 / 18
有价值的测试案例
- 预期来自需求与独立分析，不抄实现条件。
- 对问题表核对行号、规则和正常行。
- 至少一个样本修复前失败、修复后通过。
- 测试数量之外，说明发现了哪种真实错误。
CC-03 · ClaudeCode
11 / 18
真实环境差异
| 证据 | 覆盖 | 没有覆盖 |
|---|---|---|
| Hook fixture | 脚本输入合同 | Claude 真实触发 |
| 进程替身 | 事件与退出链 | 模型决策质量 |
| 静态 UE 调用 | 代码路径 | 地图导入与保存 |
| 数据核对 | 字段和数值 | 真实视觉场景 |
CC-03 · ClaudeCode
12 / 18
代码评审重点
- 先看触发条件与需求，再看代码和验证。
- 关注正确性、数据影响、接口和复杂度。
- 意见说明具体输入、错误行为和出处。
- 重要自动评审发现要复现，不能只接受自述。
CC-03 · ClaudeCode
13 / 18
资产清单故障案例
9
固定扩展名样本
3
修复前被识别的政策违例
- 旧示例规定大小写敏感，buggy 错误接受大写。
- fixed 恢复该政策，九项符合预期。
- 另一教学任务允许大写，修复方向相反。
CC-03 · ClaudeCode
14 / 18
问题到修复的证据链
01
问题：当前规则下大写 PNG 被漏检。
02
原因：后缀比较条件与需求不一致。
03
改动：归一化后缀，保持其他规则各自政策。
04
结果：修复前 False、修复后 True；固定答案匹配。
CC-03 · ClaudeCode
15 / 18
交付说明
行为与结果
- 描述触发问题和实际变化。
- 列相关文件和复现命令。
- 给出检查结果与固定答案。
范围与接续
- 脚本已运行，模型未调用。
- 真实资产与引擎没有检查。
- 剩余问题和下一步可以复查。
CC-03 · ClaudeCode
16 / 18
练习与验收
- 引入一项规则缺陷，让固定答案先发现它。
- 修复后确认原故障消失、正常样本仍符合要求。
- 提交最小输入、原因、差异和实际结果。
- 写一条能回到代码或输入的评审意见。
CC-03 · ClaudeCode
17 / 18
调试与评审思维导图
CC-03 · ClaudeCode
18 / 18