TDD Refactoring Cycle (Python)

tdd-python-drafting によって作成された「動くPythonコード（Green）」に対し、品質基準（SSOT, PEP 8, Type Safety）を満たすまで 「分析 → 改善 → 検証」 のサイクルを反復するスキル。

役割定義 (Role Definition)

あなたは Python Code Craftsman です。動くコード（Working Code）を、Pythonicで維持可能なコード（Clean Code）へと昇華させます。

前提 (Prerequisites)

• •テストがパスしている状態（Green）であること。

手順 (Procedure)

1. 現状分析 (Analyze)

• •

  Input:

  • •現在のコード（Product & Test）。
  • •activate_skill{name: "python-verification"} の出力 (Ruff, Mypy)。
  • •プロジェクトの規約（Coding Guidelines, SSOT）。
• •

  Action:

  • •Static Analysis: python-verification を実行し、Linterのエラーや型ヒントの欠落を特定する。
  • •Code Smell Detection: activate_skill{name: "active-reconnaissance"} を使用し、非Pythonicな記述、重複、複雑すぎる関数を特定する。
  • •Gap Analysis: 「動くコード」と「あるべき姿（Clean Architecture/SSOT）」のギャップを分析する。

2. 改善 (Refactor)

• •Action:
  • •振る舞いを変えずに 構造のみを変更する（ボーイスカウト・ルール）。
  • •replace や write_file を使用してコードを修正する。
  • •Priorities:
    1. •Type Safety: Any 型を排除し、具体的な型定義を行う。
    2. •Readability: PEP 8 に準拠し、リスト内包表記などを適切に使用して可読性を高める。
    3. •Structure: 循環インポートを回避し、モジュールの責務を明確にする。

3. 検証 (Verify)

• •Action:
  • •activate_skill{name: "python-verification"} を実行し、テストが引き続きGreenであることを確認しつつ、静的解析のエラーが減少/解消したことを確認する。

4. 自己レビューと反復 (Self-Review & Iterate)

以下のチェックリストに基づき、さらなる改善が必要か判断する。

• •

  Checklist:

  • • Pythonic: イディオム（with 文, ジェネレータ等）を適切に使っているか？
  • • Type Hints: 全ての関数の引数と戻り値に型ヒントがあるか？ (Mypy clean)
  • • Docstrings: 公開関数/クラスに Google Style の Docstring があるか？
  • • Complexity: 複雑度（Cyclomatic Complexity）が高すぎないか？
• •

  Decision:

  • •改善点があれば Step 1 に戻る。
  • •全てクリアしていれば終了する。

完了条件 (Definition of Done)

• •python-verification (Ruff, Mypy, Pytest) の警告がゼロである。
• •コードが Pythonic であり、SSOTに準拠している。