Skip to content
[バグ対応] 1. トラブルシューティングログ生成コマンド (引数:問題内容やエラー分・解決したいこと) logo

[バグ対応] 1. トラブルシューティングログ生成コマンド (引数:問題内容やエラー分・解決したいこと)

[バグ対応] 1. トラブルシューティングログ生成

SKILL.md

Full skill instructions

[バグ対応] 1. トラブルシューティングログ生成コマンド (引数:問題内容やエラー分・解決したいこと)

入力

  • $ARGUMENTS : 問題概要・エラー文、または関連ファイル/ディレクトリのパス

🎯 目的

  • 問題解決型思考に基づき、現状把握を徹底する
  • AIがエラーや問題に直面した際、原因候補・調査方針・対処計画を修正前に整理する
  • GitHub Issue として記録し、後から実際の解決プロセスを追記・更新できるようにする
  • 問題を再現・調査・解決する履歴を Issueコメントで時系列に残し、再利用性を高める

GitHub連携の前提

必要な権限

以下の gh コマンドが実行可能であること:

  • gh issue create / gh issue view
  • gh issue edit / gh issue comment

手順(問題解決型思考に基づく流れ)

  1. 現状把握(As-Isの分析)

    • $ARGUMENTS の内容(問題概要・エラー文など)を精査する
    • 環境・再現条件・発生状況をできる限り詳細に書き出す
    • 「何が起きているか」を客観的に記録する(まだ原因や対処に飛ばない)
  2. 理想状態の確認(To-Beの明確化)

    • 本来期待される動作や、正常時の状態を定義する
  3. ギャップ特定(問題の定義)

    • 現状と理想の差分を明確化し、「何が問題なのか」を定義する
  4. 原因仮説の列挙

    • 考えられる原因を複数洗い出し、決め打ちを避ける
    • 技術的要因 / 環境要因 / 設定要因などに分けてもよい
  5. 調査・対処計画の立案

    • 仮説を検証するための調査手順を箇条書きで列挙
    • 恒久対応策・暫定対応策を分けて整理する
    • ⚠️ 修正作業はまだ実行せず、計画までをまとめる

出力手順

GitHub Issue作成

gh issue create \
  --title "🐛 {短いタイトル}" \
  --body "$(cat <<'EOF'
## 問題の概要(現状把握)
{簡潔に・事実ベースで記載}

## 再現手順
1. {環境・操作手順をステップ形式で}
2. ...

## 期待する動作(理想状態)
{本来の挙動}

## ギャップ(問題の定義)
{現状と理想の差}

## 考えられる原因(仮説)
- [ ] 仮説A: {原因候補1}
- [ ] 仮説B: {原因候補2}
- [ ] 仮説C: {原因候補3}

## 調査・対処計画
### 検証方針
- {仮説Aの検証方法}
- {仮説Bの検証方法}

### 暫定対応
- {あれば記載}

### 恒久対応
- {あれば記載}

## 関連ファイル
- `src/​...`
- `doc/​...`

## 解決状況
🔴 未対応
EOF
)" \
  --label "bug"

出力(GitHub)

  • Issue: ラベル bug で作成
  • Issue番号をメモし、後続の /​bug-investigate で使用

品質チェックリスト

  • 現状把握が 事実ベース で十分に書かれている
  • 理想状態(期待する動作)が明確化されている
  • 現状と理想の差分(ギャップ)が定義されている
  • 仮説が複数挙がっている(単一原因に決め打ちしない)
  • 調査・対処計画が明示されている(暫定/恒久を分ける)
  • 関連ファイルやコード断片が紐づいている
  • GitHub Issueが作成されている

自己評価

  • 成功自信度: (1-10)
  • 一言理由: {短く理由を記載}

More skills from majiayu000

xiaohongshu logo
majiayu000/claude-arsenal

xiaohongshu

xiaohongshu

286 148
View
agent-task-conductor logo
majiayu000/claude-skill-registry

agent-task-conductor

Conduct multi-agent task orchestration and workflow coordination.

663 1
View
conductor-setup logo
majiayu000/claude-skill-registry

conductor-setup

Initialize project with Conductor artifacts (product definition,

663 1
View
animation-designer logo
majiayu000/claude-skill-registry

animation-designer

Expert in web animations, transitions, and motion design using Framer Motion and CSS

663 1
View
diagramming logo
majiayu000/claude-skill-registry

diagramming

Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...

663 1
View
h3-pg logo
majiayu000/claude-skill-registry-data

h3-pg

PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.

23 1
View
conductor-development logo
majiayu000/claude-skill-registry

conductor-development

Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...

663 1
View
conductor-status logo
majiayu000/claude-skill-registry

conductor-status

Display project status, active tracks, and next actions

663 1
View
dockerization logo
majiayu000/claude-skill-registry

dockerization

Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.

663 1
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View