본문으로 건너뛰기
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 / 1,000자

이 양식은 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의 스킬 모두 보기

이 스킬의 문제 신고