# Debug Workflow

> バグ調査、エラー解析、パフォーマンス問題の調査時に使用。過去の類似問題の検索やデバッグセッションの記録にも活用する。

- **Type:** Skill
- **Install:** `agentstack add skill-shioki-cursor-knowledge-management-system-debug-workflow`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [shioki](https://agentstack.voostack.com/s/shioki)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [shioki](https://github.com/shioki)
- **Source:** https://github.com/shioki/Cursor-Knowledge-Management-System/tree/main/templates/.cursor/skills/debug-workflow

## Install

```sh
agentstack add skill-shioki-cursor-knowledge-management-system-debug-workflow
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# デバッグワークフロー

問題の特定から解決、記録までのデバッグプロセス全体を支援するスキルです。

## When to Use

- バグやエラーが発生したとき
- パフォーマンス問題を調査するとき
- 過去の類似問題を検索したいとき
- デバッグセッションを記録したいとき
- 緊急時の対応フローを確認したいとき

## Instructions

### 1. 過去事例の確認

まず `references/DEBUG_TEMPLATE.md` を読み込み、過去の問題解決記録を確認してください。

### 2. デバッグプロセス

#### Step 1: 問題の特定・記録

以下の情報を整理してください:

- **発生日時**
- **環境**（開発/ステージング/本番）
- **影響範囲**
- **緊急度**（高/中/低）
- **エラーメッセージ**
- **再現手順**
- **期待動作 vs 実際の動作**

#### Step 2: 調査・分析

- 過去の類似事例を `scripts/search-sessions.sh` で検索
- ログ・スタックトレースの分析
- 関連コンポーネントの影響調査

#### Step 3: 解決策の実装

- 原因の仮説を複数立てる
- 最小限の変更で検証する
- 影響範囲を考慮したテストを実施する

#### Step 4: 記録・共有

- デバッグセッションを記録
- 根本原因と解決策を文書化
- 再発防止策を検討

### 3. セッション管理

デバッグセッションの作成:

```bash
bash .cursor/skills/debug-workflow/scripts/create-session.sh "問題の概要"
```

過去セッションの検索:

```bash
bash .cursor/skills/debug-workflow/scripts/search-sessions.sh "キーワード"
```

### 4. 緊急時対応

- **1時間以内に解決できない**: チームに相談を推奨
- **システム全体に影響**: 即座にエスカレーション
- **データ損失の可能性**: 最優先で対応

### 5. コマンドとの連携

デバッグセッションの開始には `/start-debug` コマンドの利用を案内してください。
解決後の改善記録には `/log-improvement` コマンドを案内してください。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [shioki](https://github.com/shioki)
- **Source:** [shioki/Cursor-Knowledge-Management-System](https://github.com/shioki/Cursor-Knowledge-Management-System)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-shioki-cursor-knowledge-management-system-debug-workflow
- Seller: https://agentstack.voostack.com/s/shioki
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.