用途:用于系统化根因调试,核心原则是“先调查根因,再写修复”,避免只修复表面症状导致反复出现新问题。
主要能力:按阶段推进调查,包括收集症状、阅读代码、检查近期变更、复现问题、模式分析、假设验证、实施修复;提供常见缺陷模式参考(竞态、空值传播、状态损坏、集成失败、配置漂移、过期缓存、导入/模块错误);要求编写先失败后通过的回归测试;规定报告格式(症状、根因、修复、证据、回归测试、相关项、状态)。
使用方式:以 /investigate 命令调用,可附带错误信息或问题描述,例如: /investigate TypeError: Cannot read properties of undefined (reading 'map') /investigate the payment flow is silently dropping some transactions /investigate
调查中给出的示例命令包括: grep -rn "ComponentName|function_name|error_string" src/ --include="*.{ts,js,py,rb,go}" | head -30 git log --oneline -15 -- <affected-file> git show <commit-hash> -- <affected-file> git diff HEAD~3..HEAD -- <affected-directory>
限制与规则:无法复现时不修;不得声称“应该能修好”,必须验证;一次调查不修超过3个无关问题;提交前移除所有调试日志;连续3次假设失败则停止并考虑架构问题或升级。修复涉及超过5个文件时需先确认。状态可为 DONE、DONE_WITH_CONCERNS、BLOCKED。相关命令有 /review-pr、/qa、/ship。其余收费、平台、价格等信息暂未提供。