investigation-mode

Category: 数据与AI | Uploader: CatsMiaow | Downloads: 0 | Version: v1.0（Latest）

Use when there are 2+ consecutive failures, repeated errors, or when the same failure recurs after a new fix attempt - pauses implementation, switches to root-cause investigation, gathers evidence, and resumes only after a verified plan and options

Changelog: Source: GitHub https://github.com/CatsMiaow/github-copilot

Directory Structure

Current level: .github/skills/investigation-mode/

📄 SKILL.md 3.2 KB

SKILL.md

---
name: investigation-mode
description: Use when there are 2+ consecutive failures, repeated errors, or when the same failure recurs after a new fix attempt - pauses implementation, switches to root-cause investigation, gathers evidence, and resumes only after a verified plan and options
---

# Investigation Mode

## Overview

This skill provides a hard stop and a repeatable workflow when progress stalls or errors repeat. It prevents “random walk” fixes and forces evidence-first debugging.

## Use when...

- There are **2+ consecutive failures/errors** in the same feature or approach
- The same error comes back after “fixes”
- There is temptation to “just workaround” or change approach silently
- The problem statement is unclear and implementation would be guesswork

## Symptoms / keywords

- “stuck”, “still failing”, “same error”, “again”, “flaky”, “intermittent”, “can’t reproduce”, “works on my machine”
- “quick workaround”, “let’s just do it manually”, “skip validation”, “good enough”
- CI-only failures, nondeterministic tests, repeating build/compile/lint errors

## Rules (verbatim triggers)

### Failure response rules

- **2+ consecutive failures**: Switch to investigation mode
- **Ask before**: Using workarounds or alternatives
- **Explain**: Why original approach failed
- **Options**: Use `task-direction-approval` skill when changing direction.

**Core**: Respect user's original intent. When stuck, find proper solutions rather than taking shortcuts.

### After 2 consecutive errors in same feature

1. 🛑 **PAUSE** - Stop implementation immediately
2. 🔍 **INVESTIGATION MODE** - Switch focus to root cause analysis
3. 📖 **Deep Research** - Dispatch a research subagent to execute web fetch for official docs, RFCs, known issues and return a cited Context Package
4. 🧠 **Sequential-thinking** - Analyze fundamental misunderstanding
5. 🧪 **Test First** - Write comprehensive tests before continuing

**Declare mode switch:** "🔍 **INVESTIGATION MODE**: Pausing to research root cause"

## Workflow

1. **Freeze changes**: stop making further edits that are not evidence-driven.
2. **Capture evidence**: record the exact error text, stack traces, logs, and minimal repro steps.
3. **Constrain scope**: isolate the smallest failing unit (single test, single endpoint, single build step).
4. **Run root cause analysis**:
   - **Read `root-cause-tracing` skill** (use `read_file` on its path from the `<skills>` list) for systematic isolation techniques.
   - **Read `uncertainty-verification` skill** when the fix depends on exact tool/library behavior.
5. **Propose options**: Use `task-direction-approval` skill when considering an alternative approach.
6. **Resume** only after selecting a plan and (when applicable) verifying it with a small test.
7. **Escalate**: If root cause remains unclear after completing steps 1–5, share the captured evidence with the user and ask for guidance — do not resume implementation blindly.

## Common mistakes

- Continuing to code while the failure mode is not understood
- Changing direction silently instead of asking for approval
- “Fixing” by adding retries/timeouts without evidence

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

investigation-mode

Directory Structure

SKILL.md

Report

Notice