跳到正文
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（原文）

安装前可以查看交给 AI 代理的指令内容。

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 的全部技能

报告此技能的问题