Skip to content
cccskills
FreePublished on GitHub

debug-assist

This skill should be used when the user asks to "このエラーを直して", "help me debug this", "fix this stack trace", "なぜこのエラーが出るの", "CI が落ちた", or pastes an error message or stack trace and wants help diagnosing it. Classifies the error type, identifies related files, and proposes up to three root-cause hypotheses with concrete fix plans.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md3.3 KB
  • README.md1.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

エラーメッセージ・スタックトレースを受け取り、原因仮説と修正方針を提示するスキル。

Step 1: エラーの受け取り

$ARGUMENTS にエラーメッセージが含まれる場合はそれを使用する。 含まれない場合は「エラーメッセージまたはスタックトレースを貼り付けてください」とユーザーに促す。

Step 2: エラーの種別判定

エラーを以下のいずれかに分類する:

種別特徴
ランタイムエラー実行時例外、uncaught error、process exit
型エラーTypeScript の TS2xxx 系エラー
lint エラーESLint / oxlint のルール違反
テスト失敗assertion failed、expect / received の差異
環境エラーモジュール not found、接続失敗、権限エラー
ビルドエラーバンドラー・コンパイラのエラー

Step 3: 関連ファイルの特定

スタックトレースや import パスからファイルパスを抽出し、以下を実行する:

  1. 該当ファイルを Read で読み込み、エラー箇所の前後を把握する
  2. エラーに含まれるシンボル名を Grep で検索し、定義元・参照元を確認する
  3. 型エラーの場合は型定義ファイル(.d.ts / types/ 以下)も確認する

Step 4: 原因仮説の提示

原因の仮説を 3つ以内 に絞って提示する。各仮説には以下を含める:

### 仮説 1: <タイトル>
**確率**: 高 / 中 / 低
**根拠**: なぜそう考えるか
**確認コマンド**: 仮説を検証するコマンドまたは確認箇所
**修正方針**: 仮説が正しい場合の直し方

仮説が1つに絞り込めた場合は直接修正を提案してもよい。

Step 5: ユーザーの確認結果を受けて修正を支援

ユーザーが確認コマンドの結果を返した場合:

  • 仮説が確認できた → 修正を実施するか確認して実行
  • 仮説が外れた → 次の仮説を検討し、追加情報を Grep・Read で収集する

修正後は該当の検証コマンドを実行してエラーが解消されたことを確認する。

注意事項

  • 過剰修正しない: エラーに直接関係しない箇所には触れない
  • 環境エラーは実装で解決しない: 環境起因(パス設定・権限・OS依存)は修正方針を提示するにとどめ、ユーザーに対応を委ねる
  • 既存の失敗と区別する: 実装前から存在したエラーは「既存の問題」として分離して報告する

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

This skill should be used when the user asks to "プロジェクトを解析して", "コードベースを調べてドキュメント化して", "移行作業の準備をして", "新機能実装の前にプロジェクトを整理して", "analyze this codebase", "document the project structure", "既存プロジェクトのCLAUDE.mdを作って", or wants to prepare CLAUDE.md and architecture docs before a migration, feature development, or onboarding.

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

This skill should be used when the user asks to "ドキュメントを更新して", "sync the docs", "update CLAUDE.md after this change", "実装に合わせてドキュメントを直して", or notices that docs have drifted from the codebase. Diffs git history to identify what changed, proposes targeted updates to CLAUDE.md, docs/architecture.md, docs/requirements.md, and README.md, then applies only approved changes.

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

Explain selected code or a specified file/function in plain language, including what it does, why it exists, and potential pitfalls

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

This skill should be used when the user asks to "このファイルを変えたら何が壊れる?", "what depends on this function", "影響範囲を調べて", "show me what imports this module", or wants to understand the blast radius before modifying a shared utility, exported type, or public API. Traces import/require references up to two levels deep and lists affected test files.

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

This skill should be used when the user asks to "このIssueを実装して", "implement this issue", "fix this bug", "このタスクをやって", "Issue

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

This skill should be used when the user asks to "これらのIssueを全部実装して", "implement these issues autonomously", "Issue一覧を自動で片付けて", "これらのタスクを順番に実装してPRにして", or provides a list of GitHub Issue numbers/URLs for autonomous batch implementation. Fetches all specified Issues, resolves dependency order, then iterates through each — creating a worktree, implementing, and opening a PR — without user intervention.

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

See all skills by t6adev

Report a problem with this skill