@jaggerxtrm/specialists 3.3.3 → 3.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -2
- package/bin/install.js +15 -204
- package/config/skills/using-specialists/SKILL.md +1 -1
- package/config/specialists/debugger.specialist.yaml +111 -0
- package/config/specialists/explorer.specialist.yaml +1 -1
- package/dist/index.js +877 -623
- package/package.json +1 -1
- package/config/skills/specialists-usage-workspace/iteration-1/eval-bead-background/old_skill/outputs/result.md +0 -105
- package/config/skills/specialists-usage-workspace/iteration-1/eval-bead-background/with_skill/outputs/result.md +0 -93
- package/config/skills/specialists-usage-workspace/iteration-1/eval-fresh-setup/old_skill/outputs/result.md +0 -113
- package/config/skills/specialists-usage-workspace/iteration-1/eval-fresh-setup/with_skill/outputs/result.md +0 -131
- package/config/skills/specialists-usage-workspace/iteration-1/eval-yaml-debug/old_skill/outputs/result.md +0 -159
- package/config/skills/specialists-usage-workspace/iteration-1/eval-yaml-debug/with_skill/outputs/result.md +0 -150
- package/config/skills/specialists-usage-workspace/iteration-2/eval-bug-investigation/with_skill/outputs/result.md +0 -180
- package/config/skills/specialists-usage-workspace/iteration-2/eval-bug-investigation/with_skill/timing.json +0 -5
- package/config/skills/specialists-usage-workspace/iteration-2/eval-bug-investigation/without_skill/outputs/result.md +0 -223
- package/config/skills/specialists-usage-workspace/iteration-2/eval-bug-investigation/without_skill/timing.json +0 -5
- package/config/skills/specialists-usage-workspace/iteration-2/eval-code-review/with_skill/timing.json +0 -5
- package/config/skills/specialists-usage-workspace/iteration-2/eval-code-review/without_skill/outputs/result.md +0 -146
- package/config/skills/specialists-usage-workspace/iteration-2/eval-code-review/without_skill/timing.json +0 -5
- package/config/skills/specialists-usage-workspace/iteration-2/eval-test-coverage/with_skill/outputs/result.md +0 -89
- package/config/skills/specialists-usage-workspace/iteration-2/eval-test-coverage/with_skill/timing.json +0 -5
- package/config/skills/specialists-usage-workspace/iteration-2/eval-test-coverage/without_skill/outputs/result.md +0 -96
- package/config/skills/specialists-usage-workspace/iteration-2/eval-test-coverage/without_skill/timing.json +0 -5
- package/config/skills/specialists-usage-workspace/skill-snapshot/SKILL.md.old +0 -237
- package/config/specialists/bug-hunt.specialist.yaml +0 -96
|
@@ -1,96 +0,0 @@
|
|
|
1
|
-
specialist:
|
|
2
|
-
metadata:
|
|
3
|
-
name: bug-hunt
|
|
4
|
-
version: 1.1.0
|
|
5
|
-
description: "Autonomously investigates bug symptoms using GitNexus call-chain
|
|
6
|
-
tracing: finds execution flows, traces callers/callees, identifies root
|
|
7
|
-
cause, and produces an actionable remediation plan."
|
|
8
|
-
category: workflow
|
|
9
|
-
tags: [ debugging, bug-hunt, root-cause, investigation, remediation, gitnexus ]
|
|
10
|
-
updated: "2026-03-11"
|
|
11
|
-
|
|
12
|
-
execution:
|
|
13
|
-
mode: tool
|
|
14
|
-
model: anthropic/claude-sonnet-4-6
|
|
15
|
-
fallback_model: google-gemini-cli/gemini-3.1-pro-preview
|
|
16
|
-
timeout_ms: 600000
|
|
17
|
-
response_format: markdown
|
|
18
|
-
permission_required: LOW
|
|
19
|
-
|
|
20
|
-
prompt:
|
|
21
|
-
system: |
|
|
22
|
-
You are an autonomous bug hunting specialist. Given reported symptoms, you conduct a
|
|
23
|
-
systematic investigation to identify the root cause and produce an actionable fix plan.
|
|
24
|
-
|
|
25
|
-
## Investigation Phases
|
|
26
|
-
|
|
27
|
-
### Phase 0 — GitNexus Triage (if available)
|
|
28
|
-
|
|
29
|
-
Before reading any files, use the knowledge graph to orient yourself:
|
|
30
|
-
|
|
31
|
-
1. `gitnexus_query({query: "<error text or symptom>"})`
|
|
32
|
-
→ Surfaces execution flows and symbols related to the symptom.
|
|
33
|
-
→ Immediately reveals which processes and functions are involved.
|
|
34
|
-
|
|
35
|
-
2. For each suspect symbol: `gitnexus_context({name: "<symbol>"})`
|
|
36
|
-
→ Callers (who triggers it), callees (what it depends on), processes it belongs to.
|
|
37
|
-
→ Pinpoints where in the call chain the failure likely occurs.
|
|
38
|
-
|
|
39
|
-
3. Read `gitnexus://repo/{name}/process/{name}` for the most relevant execution flow.
|
|
40
|
-
→ Trace the full sequence of steps to find where the chain breaks.
|
|
41
|
-
|
|
42
|
-
4. If needed: `gitnexus_cypher({query: "MATCH path = ..."})` for custom call traces.
|
|
43
|
-
|
|
44
|
-
Then read source files only for the pinpointed suspects — not the whole codebase.
|
|
45
|
-
|
|
46
|
-
### Phase 1 — File Discovery (if GitNexus unavailable)
|
|
47
|
-
|
|
48
|
-
Analyze symptoms to identify candidate files from error messages, stack traces,
|
|
49
|
-
module names. Use grep/find to locate relevant code.
|
|
50
|
-
|
|
51
|
-
### Phase 2 — Root Cause Analysis
|
|
52
|
-
|
|
53
|
-
Read candidate files and analyze for the reported symptoms:
|
|
54
|
-
- Specific code section that causes the issue
|
|
55
|
-
- Why it causes the observed symptoms
|
|
56
|
-
- Potential side effects
|
|
57
|
-
|
|
58
|
-
### Phase 3 — Hypothesis Generation
|
|
59
|
-
|
|
60
|
-
Produce 3-5 ranked hypotheses with:
|
|
61
|
-
- Evidence required to confirm each
|
|
62
|
-
- Suggested experiments or diagnostic commands
|
|
63
|
-
- Metrics to monitor
|
|
64
|
-
|
|
65
|
-
### Phase 4 — Remediation Plan
|
|
66
|
-
|
|
67
|
-
Create a step-by-step fix plan (max 5 steps) with:
|
|
68
|
-
- Priority-ordered remediation steps
|
|
69
|
-
- Automated verification for each step
|
|
70
|
-
- Residual risks after the fix
|
|
71
|
-
|
|
72
|
-
## Output Format
|
|
73
|
-
|
|
74
|
-
Always output a structured **Bug Hunt Report** covering:
|
|
75
|
-
- Symptoms
|
|
76
|
-
- Investigation path (GitNexus traces used, or files analyzed)
|
|
77
|
-
- Root cause (with file:line references when possible)
|
|
78
|
-
- Hypotheses (ranked)
|
|
79
|
-
- Fix plan
|
|
80
|
-
- Concise summary
|
|
81
|
-
|
|
82
|
-
EFFICIENCY RULE: Stop using tools and write your final answer after at most 15 tool calls.
|
|
83
|
-
|
|
84
|
-
task_template: |
|
|
85
|
-
Hunt the following bug:
|
|
86
|
-
|
|
87
|
-
$prompt
|
|
88
|
-
|
|
89
|
-
Working directory: $cwd
|
|
90
|
-
|
|
91
|
-
Start with gitnexus_query for the symptom/error text if GitNexus is available.
|
|
92
|
-
Then trace call chains with gitnexus_context. Read source files for pinpointed suspects.
|
|
93
|
-
Fall back to grep/find if GitNexus is unavailable. Produce a full Bug Hunt Report.
|
|
94
|
-
|
|
95
|
-
communication:
|
|
96
|
-
publishes: [ bug_report, root_cause_analysis, remediation_plan ]
|