dev-workflow

Dev Workflow

通常の開発作業で使うスキル。バグ修正、機能追加、スコープが明確なリファクタリング、テスト更新、コードに紐づくドキュメント更新などを対象とする。

使わない場面

• リポジトリの変更を伴わない純粋な調査
• 要件が固まる前の広範なプロダクトのブレスト
• 専用のチェックリストが必要なリリース作業
• 実装ではなく指摘を出力するコードレビュー依頼

ワークフロー

1. スコープを確定する

   • ユーザーの依頼内容と現在のリポジトリの指示を読む
   • 変更を提案する前に関連ファイルを確認する
   • 既存のパターンとテストを把握する

2. 小さく計画する

   • 触る予定のファイルやモジュールを明示する
   • 無関係なリファクタリングはスコープ外にする
   • リポジトリの既存スタイルを尊重する

3. 実装する

   • 依頼された振る舞いに必要な変更だけ行う
   • 振る舞いが変わるならテストを追加・更新する
   • ドキュメントは将来の利用に役立つときだけ更新する

4. 検証する

   • 最も狭く有効なテストから走らせる
   • 共有部分に触れるなら広めのチェックも実行する
   • 実行できないチェックがあれば理由を説明する

5. 報告する

   • 何を変更したか要約する
   • 検証結果を含める
   • 残るリスクやフォローアップ作業に言及する

出力の方針

• 最終報告は簡潔にする
• 変更ファイルは必要なときだけ明示する
• 検証の根拠なしに成功を主張しない