agentleFS
WanghaoyihaoyiWanghaoyihaoyi/agent-skills/skills/hunt/SKILL.md

hunt

Skill3 starsChanged 35 days agoMITView on GitHub

Diagnoses failures and completes authorized repairs with evidence. Use when something errors, crashes, regresses, or used to work. 也用于关键路径、尾延迟、排队积压、跨服务卡点、CI 负载优化和偶发失败的证据诊断。不用于代码审查或新功能设计。

15 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use apply.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • proficientlyjobsSkill

    apply

    Fill out a job application on Greenhouse, Lever, or Workday

    Also in 3 projects that use this

The file

Files
SKILL.md

Hunt: Diagnose and Resolve

来源:基于 Tw93 / Waza 的 hunt 技能 改编。保留 Tw93 的 MIT 版权声明。

用证据定位故障,在有效授权内修复并验证。按完整任务语境判断权限:“排查”“看看”不自动撤销同一任务的实施授权;明确只读、只问原因时交付诊断。修复不扩展发布、生产或数据操作权限。

找到能解释症状的原因

从用户实际入口和预期出发,核对相关代码、运行版本、日志与状态。记录能区分假设的证据;多种症状可以有不同原因,不强行合并。历史仅提供线索,当前证据优先。

选择能缩小不确定性的下一步:直接读调用链、最小复现、对照已知正常版本、日志或受控事件。修改行为前,应能说明具体原因、证据和修复为何有效;不要求固定句式或所有故障都走完同一验证阶梯。纯逻辑问题可由代码与确定性检查确认,时序判断需要实际事件顺序的证据。

一次未复现不能证明没有问题;假设被证据否定就调整。反复失败时检查真正执行的入口、版本和下层状态,不继续盲改常量或重复重启。工具失败先核对错误与实际终态,采用已授权的等效路径;受理未知的操作先查结果,避免重复副作用,不重置凭据。

按问题选择诊断方法

  • 版本回归:先比较已知正常版本与当前相关差异。确需 bisect 时,用有明确通过/失败标准的命令在隔离工作树中执行,结束后 reset 并清理自己的临时工作树;不影响用户改动。
  • 输入或事件太复杂:在隔离副本逐步缩减,持续确认是同一种失败,保留必要前置状态。缩减用于定位条件,修复仍回到原始场景验证。
  • 重复故障、缓存或执行版本不符:参考 故障模式,按具体迹象选择,不每次通读。已有截图或正常产物可作为对照,但要区分明确回归与风格偏好。
  • 卡顿、无响应或缺观测:日志与原生卡顿。临时诊断只回答具体问题,完成后移除无用插桩;有效故障证据按项目要求保留。
  • 性能、成本、跨服务卡点:关键路径与可观测性。先测端到端基线再定位、复测,不用“感觉更快”替代结果。
  • CI 负载与偶发失败:CI 历史与稳定性。不把重跑变绿当修复。
  • PDF、字体或打印渲染:渲染诊断;IME 与 Unicode:输入与编码。

跨端时追踪请求、会话、资源归属和实际副作用;需要项目的跨层行为能力时沿用已取得证据,不重新调查一轮。

修复与验证

在原因所属边界用最直接的方案修复,必要的关联调用方与合同一起处理,不因跨文件而重复询问。按根因搜索受影响调用链和同类入口;有证据的同根因遗漏继续处理,无关问题单独说明,不自动扩成全仓治理。

按 test-audit 选择独立预期和最小充分验证,复用已有证据。优先确认原失败被捕获、修复后通过及相关合法行为仍成立;无法核对修复前失败就说明,不能以导入失败冒充复现。

涉及部署或设备时核对实际运行版本,重启或覆盖前保存所需证据。视觉问题需要实际渲染证据,存储问题需要相关存储边界证据;编译成功、接口受理和模拟结果不替代真实业务验收。缺环境时先自行寻找授权内可行路径;只有确实无法取得的条件才交给用户,并给最小可执行步骤。

目标故障、直接影响和必要门禁已有充分证据就完成交付。新线索支持继续调查时主动推进;没有新证据的重复操作应停止并换方法。资源、决定或授权阻塞某项时,继续其余可行工作,报告已查明、仍未知及最小阻塞。

最终先说结果,再说明原因、修复、实际验证范围和未验证项。长期保障优先落到实现或有效回归检查,不把每次故障追加成一条通用规则。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.