safe-debug

safe-debug

../../references/agent-operating-principles.md

适用场景

• 用户提供回溯信息、终端错误或具体的训练/推理失败症状。
• 用户希望在修改代码前先进行诊断、缩小根本原因范围，并获得最小化补丁建议。
• 用户需要一个安全的调试流程，在进行代码变更前需获得明确的人工批准。

不适用场景

• 用户希望在无活跃故障的情况下进行广泛的仓库遍历。
• 任务为推测性实验或代码适配。
• 用户要求进行大规模重构或可读性重写。

明确边界

• 先诊断。
• 默认不修改仓库代码。
• 若需要补丁，提出最小化修复方案，并要求先获得明确批准。
• 在进行中高风险变更前，需先创建保存点或分支。
• 调试修复并非自动等同于研究贡献；若其改变了实验的含义或可比性，请明确说明。

输出预期

• debug_outputs/DIAGNOSIS.md

• debug_outputs/PATCH_PLAN.md

• debug_outputs/status.json

注意事项

references/debug-policy.md

../../references/research-rigor-principles.md

references/research-pitfall-checklist.md