SuperAPI AI 工具集

help-me-debug

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能只做诊断,不写实现。适用于用户报告缺陷、失败、回归且根因不明,或团队需要在编码前获得结构化诊断包(人类报告 + LLM 上下文)的场景。

主要能力:从用户输入界定问题(症状、预期与实际行为、频率、范围、紧急度、受影响用户、已知绕过方式、错误文本、环境与复现细节);建立项目定位快照(项目类型、运行时、入口、框架、包管理器、测试/构建命令、相关文档与配置);梳理内部依赖(模块、共享工具、生成代码、schema/迁移、数据存储、队列/任务、服务、配置、特性开关、测试与构建工具)与外部依赖(第三方包、SDK、API、SaaS、基础设施、认证/支付/存储、网络边界、环境变量、版本约束),并为每条架构/依赖结论记录证据。

工作方式:先做深度只读代码调查,再按决策树推进——可复现性、范围(孤立或横切)、变更面(行为变更、配置漂移、依赖/版本变化、数据形态漂移)、失败模式(逻辑错误、状态/异步竞态、数据/契约不匹配、运行时集成故障、校验缺失或错误)、置信度。每次只问一个能直接降低诊断不确定性的针对性问题,提问后暂停等待回答;若存在可由人回答的高影响未知项,必须先提问再定稿。

输出:在工作区根目录生成 debug_human_report.md 与 debug_llm_context.md。前者含问题摘要、预期与实际对比、症状与影响、架构与依赖摘要、原因(先确认后可能)、调用路径追踪(按阶段用 -> 逐行展示跳转与分支条件)、证据表、置信度与未解未知项、修复方向、提问日志;后者按固定小节组织:Project Overview、Architecture Map、Internal Dependencies、External Dependencies、Critical Call Paths、Fault Surface Inventory、Implementation Approach、File-by-File Change Guide、What NOT to change、Constraints、Dependencies & Libraries、Test files to update、Acceptance Criteria。若项目或范围内无测试,需写“No tests present”。

限制:绝不实现代码、编辑产品文件、创建 issue、发布到 GitHub、运行 create-git-issue 或 run-with-it、启动实现代理或调用外部编码代理;仅可创建或更新上述两个文件。技能执行期间为唯一活动权威,外部技能不得自行激活。若存在待回答的针对性问题,需回复“Awaiting user answer: <question>”并停止,不得生成最终产物。