bugfix-format
バグ修正ドキュメントのフォルダ構造と形式。/fixコマンドが参照する。
When & Why to Use This Skill
This Claude skill provides a standardized folder structure and markdown template for bug fix documentation. It streamlines the debugging process by ensuring that every fix is recorded with essential technical details—such as root cause analysis, change logs, and test results—making it an ideal tool for maintaining high-quality technical debt records and enabling AI agents to reference historical fixes via the /fix command.
Use Cases
- Standardizing bug resolution reports across development teams to ensure consistency and searchable documentation.
- Automating the generation of post-mortem documents for software defects to improve knowledge sharing and prevent regressions.
- Providing a structured context for AI-driven coding agents to log their work and verify fixes within a predefined project hierarchy.
| name | bugfix-format |
|---|---|
| description | バグ修正ドキュメントのフォルダ構造と形式。/fixコマンドが参照する。 |
バグ修正ドキュメント
保存場所
openspec/bugs/fixed/
ファイル名
YYYY-MM-DD-[バグ名].md（例: 2025-01-10-api-timeout.md）
テンプレート
# [バグ名]
作成日: YYYY-MM-DD
ブランチ: fix/[ブランチ名]
## バグの概要
[ユーザー入力内容]
## 類似例
- 既知/新規: [既知 or 新規]
- 参考: [ファイル名 or なし]
## 根本原因
[技術的な原因]
## 修正内容
[修正方法]
## 変更ファイル
- path/to/file
## テスト結果
[結果]