log-debug-issue

log-debug-issue 技能为 VRP-Toolkit 项目的调试生命周期提供了系统化的文档记录框架。它专为需要追踪复杂问题、非预期行为以及随机优化模型或 ALNS 启发式算法中反复出现错误的开发者、研究人员及维护者所设计。通过在 .claude/DEBUG_LOG.md 中强制执行一致的记录格式，此代理程序能建立一个可搜索的知识库，有助于防止回归问题、加速根源分析并简化长期维护工作。

• 捕捉结构化的问题元数据，包括日期、环境上下文（操作系统、Python 版本、包版本）以及针对不稳定 ALNS 结果或随机失败的精确重现步骤。
• 记录反复的调查过程，详列初步假设、失败的实验与诊断测试，这为艰苦的调试阶段提供了决策流程的可视性。
• 追踪根本原因、实现的修复方法、临时替代方案以及长期预防策略（如单元测试或架构重构），将解决方案正式化。
• 维护“常见模式与解决方案”区块以促进知识转移，让团队成员能快速参考先前解决的问题，如导入错误、索引错误或依赖冲突。
• 将调试工作与项目管理桥接，确保日志中未解决的问题能正确追踪为 CLAUDE.md 中的阻碍事项或待办任务。
• 建议将问题 ID 包含在 Git 提交信息中，以便追踪调试工作与版本控制之间的关联。

当出现异常（如 ALNS 算法的非预期输出、连续近似模型中的数值不稳定或 PDPTW 测试套件的失败）时，用户应触发此技能。该技能要求用户输入问题描述、症状细节以及调查结果。预期的输出是一个符合项目规范、填入结构化 Markdown 模板的日志条目，确保文档在所有项目模块中标准化。在调试时，请务必将“经验教训”区块填写完整，这对于未来优化 VRP 框架至关重要。限制包含须确保所有条目皆新增至指定路径 .claude/DEBUG_LOG.md，以维持存储库整洁并符合项目开发流程。