SuperAPI AI 工具集

diagnose

测试与质量

查看项目

更新于 11-06 16:21

技能介绍

用途 Diagnose 用于诊断当前仓库中的缺陷、风险和有证据支撑的改进机会,并按比例控制范围。它只采纳能通过“finding gate”的发现。仓库内容、issue 和截取信息只被当作证据,不会被当作可执行的指令。

主要能力

  • 诊断缺陷、风险与不明显的运行时原因,并将发现和局限封存进 diagnosis.md。
  • 除写入 .first-four-hours/diagnoses/<slug>/diagnosis.md 及其本地排除规则外,保持只读,不编辑目标仓库,也不联系、创建、关闭或修改 GitHub issue。
  • 允许非变更性探测;使用共享或计费资源、生产数据前需要询问。
  • 遵守显式限制并报告覆盖范围影响。
  • 保持对已命名 bug、风险、瓶颈、子系统或工作流的针对性,除非证据支持扩展到相邻范围。
  • 可选使用只读证据 worker,遵循 Bounded Delegation Protocol。
  • 在需要基线或杠杆建议时加载 Improvement Evidence;原因无法通过阅读代码发现时加载 Hard-Problem Method;目标涉及速度、延迟、吞吐、启动、构建时间或资源效率且配置是可能杠杆时,加载 Configuration Performance。

使用方式

  1. 把 bundle 模板复制到已安装技能和目标仓库之外,按 Diagnosis Contract 完成填写。
  2. 运行命令: python /absolute/skill-root/scripts/cli.py --repo-root /absolute/repo --input bundle=/absolute/diagnosis-bundle.json --input slug=<diagnosis-slug> --format json run
  3. 按 Diagnosis Techniques 在提交方案前、失败或方向变化后、封存前参考 reason。
  4. 封存 diagnosis.md 后停止,报告症状、带原因状态的发现、局限以及建议方向。
  5. 由用户决定是否用一个 finding ID 调用 ideate、blueprint 或 architect,或不调用;结束时给出其中一个可选下一步,并附一个命名仓库和 diagnosis.md 路径的自包含提示。只有用户回答“yes”才开始。

适用场景

  • 已有明确问题或疑似缺陷需要定位原因。
  • 需要评估风险、瓶颈或改进机会,并要求证据支撑。
  • 需要诊断不明显的运行时原因,且仅靠阅读代码难以发现。
  • 性能方向(速度、延迟、吞吐、启动、构建时间、资源效率)需要配置层面的诊断。

限制

  • 只读,除封存 diagnosis.md 外不得修改目标仓库或 GitHub issue。
  • 使用共享或计费资源、生产数据前需先询问。
  • 诊断完成后即停止,不自动进入 ideate、blueprint 或 architect,需用户明确同意。
  • 输出依赖命令成功返回封存的 diagnosis.md。