workflow-bug-fix について
workflow-bug-fix は、根本原因の分析からデプロイ後の検証までを扱う、開発チーム向けの体系的なバグ修正プロセスです。最小範囲の修正、コードレビュー、回帰テスト、セキュリティ確認、文書更新、デプロイ監視を含みます。
主な機能
- 01問題の再現と根本原因の分析
- 02最小範囲で互換性のある修正
- 03正確性、副作用、境界条件のレビュー
- 04回帰テストと境界値テストの追加
- 05セキュリティ確認とデプロイ後の監視
活用シーン
- 01ログやエラー追跡から根本原因を特定
- 02バグ修正に回帰テストを追加
- 03修正による新たなセキュリティ問題を確認
- 04重大なバグのホットフィックスと監視を計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ nickcrew/ claude-cortex --skill workflow-bug-fixインストール後、Claude Code で/workflow-bug-fixを入力して読み込まれたか確認します。
詳細
バグ修正ワークフロー
バグを適切に修正するための体系的なプロセスです。
フェーズ 1:根本原因の分析
エージェント: root-cause-analyst
手法:
- エラートレースの分析
- ログの調査
- 状態の確認
- バグを安定して再現する
成果物: 根本原因、影響を受けるコンポーネント、影響評価
フェーズ 2:修正の実装
制約:
- 対象範囲を最小限にする(バグの修正のみ)
- 後方互換性を保つ
- 十分にテストする
フェーズ 3:コードレビュー
エージェント: code-reviewer
重点項目:
- 修正の正確性
- 副作用
- エッジケース
フェーズ 4:回帰テスト
エージェント: test-automator
テストを作成します:
- 回帰テスト(このバグの再発を防止)
- エッジケースのテスト
- 影響を受ける場合は統合テスト
フェーズ 5:セキュリティチェック
エージェント: security-auditor
必須: 修正によって脆弱性が生じないことを確認します
フェーズ 6:検証
エージェント: quality-engineer
チェックリスト:
- 元の問題が解決している
- 新たな問題が発生していない
- すべてのテストに合格している
フェーズ 7:ドキュメント作成
エージェント: technical-writer
- 変更履歴への記載
- インシデントレポート(重大なバグの場合)
- 再発防止ガイド(原因と回避方法)
フェーズ 8:デプロイ
エージェント: deployment-engineer
戦略:重大な場合はホットフィックス、それ以外は通常リリース
24 時間、以下を監視します:
- エラー率
- パフォーマンス指標
- ユーザーからの報告
成功基準
- バグが修正されたことを確認済み
- 回帰テストを追加済み
- 副作用がない
- ドキュメントを更新済み
アンチパターン
- ❌ 根本原因ではなく症状を修正する
- ❌ バグ修正に大規模な変更を混在させる
- ❌ 回帰テストを省略する
- ❌ 原因を記録しない
コメント
Markdown 対応