agentleFS
mae616mae616/ai-template/.claude/skills/bug-investigate/SKILL.md

bug-investigate

Skill9 starsChanged 3 months agoMITView on GitHub

起票済みのバグIssueに対して原因調査を実行し、仮説を絞り込んでIssueコメントに追記する。バグの原因特定、ログ解析、再現確認で使う。

The file

Files
SKILL.md

[バグ対応] 2. トラブルシューティング調査実行と仮説の絞り込み (引数:Issue番号)

入力

  • $ARGUMENTS : 調査対象のバグIssue番号
    • 例: #123 または 123

🎯 目的

  • 既存のバグIssueを基に 調査だけを実施 する
  • 観測結果や調査ログを Issueコメント で追記する
  • 調査から導き出された新しい仮説を Issue本文の「考えられる原因」 に追記・更新する
  • 解決や修正はまだ行わず、あくまで 現状把握と原因候補の精度向上 に集中する

GitHub連携の前提

必要な権限

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

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

手順

1. Issue内容を取得

gh issue view {ISSUE_NUMBER} --json title,body,labels

2. 調査実施

  • 「調査・対処計画」を確認し、実施可能な調査を実行する
    • コード検索、ログ解析、設定ファイル確認、再現テストなど
    • 危険な操作(削除・本番DB変更・シークレット露出等)は禁止

3. 調査結果をコメント

gh issue comment {ISSUE_NUMBER} --body "🔍 調査報告

## 実施した調査
- {調査内容1}: {結果}
- {調査内容2}: {結果}

## 観測結果
\`\`\`
{ログ抜粋やエラーメッセージ}
\`\`\`

## 新たな知見
- {調査から得られた知見}

## 仮説の更新
- 仮説A: {検証結果 - 有力/棄却/継続調査}
- 仮説B: {検証結果}
- **新規仮説**: {調査から見えてきた新しい仮説}

## 次の調査候補
- {残課題1}
- {残課題2}
"

4. Issue本文を更新(仮説の更新)

# 現在の本文を取得して、仮説セクションを更新
gh issue edit {ISSUE_NUMBER} --body "{更新後の本文}"

5. 解決状況を更新

Issue本文の「解決状況」を 🟡 調査中 に更新する


出力(GitHub)

  • Issueコメント: 調査内容・観測結果・知見を追記
  • Issue本文: 仮説セクションを更新、解決状況を「🟡 調査中」に変更

品質チェックリスト

  • 調査内容が 事実ベース で記録されている
  • 調査から得られた観測結果が具体的に残っている
  • 新しい仮説が追加されている
  • 状態が「🟡 調査中」に更新されている
  • 調査過程がIssueコメントで記録されている
  • 関連ファイルやログ断片が適切に紐づいている

自己評価

  • 成功自信度: (1-10)
  • 一言理由: {短く理由を記載。例: 「再現確認はできたが根本原因は未確定」}

次に推奨

→ /bug-propose で修正策の列挙

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.