SuperAPI AI 工具集

systmt-dbggng

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:用于处理任何技术问题,包括测试失败、生产环境 Bug、异常行为、性能问题、构建失败与集成问题。核心原则是必须先找到根因再修复,症状层面的修补视为失败,其铁律为“未完成根因调查不得提出修复”。

主要能力:将调试拆为四个阶段。阶段一根因调查:仔细阅读错误与堆栈、稳定复现、检查近期变更、在多组件系统中为每个边界添加诊断日志、沿调用栈向上追踪数据来源,并建立 DEBUG.md 记录证据。阶段二模式分析:寻找可用的相似实现、完整阅读参考实现、列出工作与故障代码间所有差异、理解依赖与配置假设。阶段三假设与测试:先列 3-5 个假设并记录支持与冲突证据,做最小改动一次只验证一个变量。阶段四实现:先写可复现的失败测试,再做单一根因修复并验证无回归;同一方向两次失败须换新假设,累计 3 次以上失败应停下来质疑架构。

使用方式:文档给出 Hermes 工具集成(search_files、read_file、terminal、web_search/web_extract),可用 delegate_task 派发调查子代理,并与 test-driven-dev 配合(先红后绿)。示例命令保持原样:pytest tests/test_module.py::test_name -v、git log --oneline -10、python -m compileall。还包含工具输出脱敏、Rust 仓库漂移与截断快照等补充经验。

适用场景与限制:适合紧急、看似简单或已多次修复失败的情形。限制在于未提供具体版本、安装命令或收费信息;部分辅助流程依赖特定 Agent 工具与仓库环境。