gds-investigate

Investigate bugs and code areas with evidence-graded findings recorded in a structured case file.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ArchaonHW/MingGoRTS --skill gds-investigate-archaonhw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-investigate
Source: https://github.com/ArchaonHW/MingGoRTS/tree/main/.agents/skills/gds-investigate
Command: npx skills add https://github.com/ArchaonHW/MingGoRTS --skill gds-investigate-archaonhw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Debugging and code exploration often rely on guesswork and lose context across sessions. This Skill enforces evidence-first investigation, grading every finding as Confirmed, Deduced, or Hypothesized, and persists all progress in a structured case file that another engineer can pick up cold. ## Core Features & Use Cases - Evidence-graded forensics: Every claim is cited with path:line, log timestamps, or commit hashes, and hypotheses are never deleted—only marked Open, Confirmed, or Refuted. - Persistent case files: Investigations are written to a Markdown case file (from a customizable template) covering evidence inventory, timeline, hypotheses, source code trace, and a confidence-rated conclusion. - Dual-mode operation: Handles both symptom-driven defect chasing (tickets, logs, stack traces) and symptom-free exploration of unfamiliar code areas, with delegation to subagents for large file reads. - Use Case: A user reports a crash with a log file. The Skill anchors on a confirmed error string, maps the evidence perimeter, traces causality through the source, and delivers a root-cause diagnosis with a reproduction plan and next-step routing. ## Quick Start Ask the AI to investigate a bug by providing a ticket ID, log file path, or error message, for example: investigate why the battle recorder test fails using the attached stack trace.

Frequently Asked Questions about gds-investigate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I investigate a bug with a log file or stack trace?

Provide the log file path, ticket ID, or error message as input. The investigation anchors on one confirmed piece of evidence, maps all available evidence sources, traces causality backward from the symptom, and records everything in a structured case file.

What is evidence grading in a debugging workflow?

Evidence grading classifies every finding as Confirmed (directly observed with path:line or commit citation), Deduced (logically derived from confirmed evidence), or Hypothesized (plausible but unverified). This prevents theories from being treated as facts during root cause analysis.

Can I resume a previous investigation session?

Yes. Passing the path to an existing case file resumes that investigation, surfacing open hypotheses, backlog items, and missing evidence. New work is appended under a dated Follow-up block rather than overwriting prior findings.

Does the investigation skill also fix the bugs it finds?

No. The investigation stops at diagnosis with a confidence-rated conclusion and fix direction. For trivial fixes it suggests a one-line change, but implementation is routed to separate development workflows.

What happens when there is not enough evidence to investigate?

The case is marked evidence-light, and the backlog is populated with prioritized data-collection items stating exactly what evidence is needed. Missing evidence is documented as a finding itself, including how to obtain it.