本文へ移動
cccskills
無料GitHub で公開

bugfix

Standardized bug fix workflow using TDD (Red-Green-Refactor). Use when fixing bugs, resolving issues, or when the user invokes /bugfix. Ensures root cause analysis, failing test first, then minimal fix.

日本語の概要は準備中です。原文の説明を表示しています。

berlysia/dotfiles
インストール方法を見る

含まれるファイル（1）

  • SKILL.md3.0 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Bug Fix Workflow

バグ修正の標準化されたワークフロー。TDD（Red-Green-Refactor）とroot cause analysisを組み合わせる。

ワークフロー

Phase 1: 理解

  1. バグの報告・症状を確認する

    • ユーザーからの報告、issueの内容、エラーメッセージを把握
    • 再現条件を明確にする

  2. 関連コードを読む

    • バグが発生している箇所のソースコードを読む
    • 呼び出し元・呼び出し先の依存関係を理解する
    • 既存テストを確認: 関連するテストファイルを読み、テストパターン（アサーション、データ構造、ヘルパー関数）を把握する

  3. 根本原因を特定する（5 Whys）

    • エラーメッセージの最初を確認する（最後ではない）
    • 症状ではなく根本原因を探る
    • 仮定に頼らず、コードを実際に読んで確認する
    • 確信が持てない場合は logic-validator で推論を検証する

Phase 2: Red（失敗するテストを書く）

  1. バグを再現する失敗テストを書く
    • 既存テストのパターンに合わせる: アサーションスタイル、データ構造、命名規則を既存テストから踏襲する
    • テストがバグの症状を正確に捉えていることを確認する
    • テストを実行し、確実に失敗することを確認する

Phase 3: Green（最小限の修正）

  1. テストが通る最小限のコード修正を行う
    • 根本原因に対する修正のみ行う
    • 周辺コードのリファクタリングは行わない
    • テストを実行し、新しいテストが通ることを確認する

Phase 4: Refactor（リグレッション確認）

  1. 全テストスイートを実行してリグレッションがないことを確認する

    • 新しいテストだけでなく、既存テスト全体を実行する
    • lint/type checkも実行する

  2. 必要に応じてコードを整理する

    • テストが全て通った状態でのみリファクタリングする
    • 修正に直接関係する箇所のみ

Phase 5: まとめ

  1. バグの原因と修正内容をサマリーする
    • 根本原因は何だったか
    • どのように修正したか
    • 影響範囲と確認した内容

注意事項

  • 症状的修正を避ける: 「とりあえず動く」修正ではなく根本原因に対処する
  • 既存パターンを尊重する: テスト構造、エラーハンドリング、コーディングスタイルをプロジェクトに合わせる
  • 最小限の変更: バグ修正に直接関係ない変更は別コミットにする
  • debugging.md を参照: 詳細なデバッグ手順は @~/.claude/rules/debugging.md に従う

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

adr-migrate

無料

Migrate existing ADRs to YAML frontmatter format. Scans docs/decisions/ for ADRs without frontmatter, infers status from body text, shows dry-run for approval. Trigger: /adr-migrate

日本語の概要は準備中です。原文の説明を表示しています。

berlysia/dotfiles92026年10月20日 更新

adr-session

無料

Start or resume an ADR session. Without number: show status overview and recommend next actionable ADR. With number: provide phase-specific guidance. Trigger: /adr-session, /adr-session NNN, /adr-session new

日本語の概要は準備中です。原文の説明を表示しています。

berlysia/dotfiles92026年10月20日 更新

apply-harness-practices

無料

Analyze a project's harness maturity and guide staged adoption of Harness Engineering best practices (quality loops, safety gates, linters, CLAUDE.md optimization).

日本語の概要は準備中です。原文の説明を表示しています。

berlysia/dotfiles92026年10月20日 更新

clarify

無料

Create detailed specifications by iteratively clarifying unclear points for Plan mode. Use when: After completing a plan when detailed requirements need clarification before implementation.

日本語の概要は準備中です。原文の説明を表示しています。

berlysia/dotfiles92026年10月20日 更新

claude-action-bootstrap

無料

Policy-enforcing installer that deploys hardened Claude Code Action workflows (`@claude` manual mention + dependency-bot auto-fix) into a personal GitHub repository the user administers. Use when asked to introduce Claude Code Action, apply `@claude` mention support, or set up automated CI auto-fix for dependency bot PRs, using the security-hardened templates shipped with this skill.

日本語の概要は準備中です。原文の説明を表示しています。

berlysia/dotfiles92026年10月20日 更新

cognitive-rhythm-writing

無料概要あり

説明的な文章に緩急を設計するための規範。緩急を装飾ではなく認知モードの切替（観察→逡巡→断定→再観察）と未回収の緊張の管理として扱い、文の拍、段落の密度波形、節の入り方、緩みと駄文の判別、執筆後の機械的な点検手順を定める。読み物として読ませたい章・記事・解説文を生成するとき、または「密度はあるが平坦でおもしろくない」文章を診断・修正するときに使用する。

berlysia/dotfiles92026年10月20日 更新

berlysia のスキルをすべて見る

このスキルの問題を報告する