Debug workflow

Skill shioki/Cursor-Knowledge-Management-System/templates/.agents/skills/debug-workflow

Cursor / Claude Code / Codex 向けの知識管理テンプレート。Agent Skills 7 種とカスタムコマンド 7 種。v5.0.0 で .agents/skills 正規化、Cursor Plugin・gh skill・Microsoft APM・AGENTS.md に対応。

Install

npx -y skills add shioki/Cursor-Knowledge-Management-System --skill debug-workflow

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.6 KB, as published. Nobody here has run it

デバッグワークフロー

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

When to Use

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

Instructions

1. 過去事例の確認

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

2. デバッグプロセス

Step 1: 問題の特定・記録

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

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

Step 2: 調査・分析

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

Step 3: 解決策の実装

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

Step 4: 記録・共有

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

3. セッション管理

デバッグセッションの作成（保存先: .agents/debug-sessions/ / .claude/debug-sessions/ / .cursor/debug-sessions/ のいずれか検出されたもの）:

bash .agents/skills/debug-workflow/scripts/create-session.sh "問題の概要"
# （.claude/skills / .cursor/skills も検出対象）

過去セッションの検索:

bash .agents/skills/debug-workflow/scripts/search-sessions.sh "キーワード"
# （.claude/skills / .cursor/skills も検出対象）

4. 緊急時対応

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

5. コマンドとの連携

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