@sisu-ai/skill-debug 0.2.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/LICENSE +6 -0
- package/README.md +34 -0
- package/SKILL.md +24 -0
- package/package.json +30 -0
- package/resources/debug-playbook.md +19 -0
package/LICENSE
ADDED
package/README.md
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# @sisu-ai/skill-debug
|
|
2
|
+
|
|
3
|
+
Debugging skill with a systematic playbook.
|
|
4
|
+
|
|
5
|
+
Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
pnpm add @sisu-ai/skill-debug
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Usage
|
|
12
|
+
|
|
13
|
+
Point the skills middleware directly at the installed package:
|
|
14
|
+
|
|
15
|
+
```ts
|
|
16
|
+
skillsMiddleware({
|
|
17
|
+
directories: ["node_modules/@sisu-ai/skill-debug"],
|
|
18
|
+
});
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Or copy the skill into your project skills directory:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
mkdir -p .sisu/skills/debug
|
|
25
|
+
cp -R node_modules/@sisu-ai/skill-debug/* .sisu/skills/debug/
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Resources
|
|
29
|
+
|
|
30
|
+
- `resources/debug-playbook.md`
|
|
31
|
+
|
|
32
|
+
License
|
|
33
|
+
|
|
34
|
+
Apache-2.0
|
package/SKILL.md
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: debug
|
|
3
|
+
description: Systematic debugging workflow from reproduction to root cause
|
|
4
|
+
version: 0.1.0
|
|
5
|
+
author: sisu
|
|
6
|
+
tags: [debug, troubleshooting]
|
|
7
|
+
requires: [read_file, grep, bash]
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Debugging Workflow
|
|
11
|
+
|
|
12
|
+
Use this skill to debug issues systematically.
|
|
13
|
+
|
|
14
|
+
## Steps
|
|
15
|
+
|
|
16
|
+
1. **Reproduce** the issue with minimal steps
|
|
17
|
+
2. **Collect signals** (logs, traces, stack traces)
|
|
18
|
+
3. **Narrow scope** (binary search, isolating module)
|
|
19
|
+
4. **Hypothesize** and test fixes
|
|
20
|
+
5. **Verify** the fix with tests and regression checks
|
|
21
|
+
|
|
22
|
+
## Resources
|
|
23
|
+
|
|
24
|
+
See `resources/debug-playbook.md`.
|
package/package.json
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@sisu-ai/skill-debug",
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"license": "Apache-2.0",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"files": [
|
|
7
|
+
"SKILL.md",
|
|
8
|
+
"resources"
|
|
9
|
+
],
|
|
10
|
+
"publishConfig": {
|
|
11
|
+
"access": "public"
|
|
12
|
+
},
|
|
13
|
+
"repository": {
|
|
14
|
+
"type": "git",
|
|
15
|
+
"url": "https://github.com/finger-gun/sisu",
|
|
16
|
+
"directory": "packages/skills/skill-debug"
|
|
17
|
+
},
|
|
18
|
+
"homepage": "https://github.com/finger-gun/sisu#readme",
|
|
19
|
+
"bugs": {
|
|
20
|
+
"url": "https://github.com/finger-gun/sisu/issues"
|
|
21
|
+
},
|
|
22
|
+
"keywords": [
|
|
23
|
+
"sisu",
|
|
24
|
+
"ai",
|
|
25
|
+
"ai-agent",
|
|
26
|
+
"agentic",
|
|
27
|
+
"skill",
|
|
28
|
+
"debug"
|
|
29
|
+
]
|
|
30
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Debug Playbook
|
|
2
|
+
|
|
3
|
+
## Signals
|
|
4
|
+
|
|
5
|
+
- Logs (errors, warnings, timing)
|
|
6
|
+
- Stack traces
|
|
7
|
+
- Repro steps
|
|
8
|
+
|
|
9
|
+
## Narrowing Techniques
|
|
10
|
+
|
|
11
|
+
- Bisect by commit or feature flag
|
|
12
|
+
- Turn off components to isolate
|
|
13
|
+
- Add instrumentation at boundaries
|
|
14
|
+
|
|
15
|
+
## Fix Verification
|
|
16
|
+
|
|
17
|
+
- Add/extend tests
|
|
18
|
+
- Confirm no regressions
|
|
19
|
+
- Document cause and fix
|