zero-tech-debt について
zero-tech-debtは、変更を目指す最終形に沿ってコードを整えるコーディングスキルです。未使用の互換処理を削除し、共通ルールを集約して、新しいフローを検証する指針を示します。
主な機能
- 01目指す最終形の明確化
- 02互換処理を残す前に呼び出し元を確認
- 03プロダクトの画面構成に沿ったコード整理
- 04共通ルールの集約
- 05動作と削除した前提の検証
活用シーン
- 01変更を意図した設計へリファクタリング
- 02未使用のモードやフォールバックの削除
- 03重複する権限やルート規則の統合
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ jnsahaj/ skills --skill zero-tech-debtインストール後、Claude Code で/zero-tech-debtを入力して読み込まれたか確認します。
詳細
技術的負債ゼロ
現在のパッチに至った過去の経緯ではなく、目指す最終状態を起点に変更を作り直します。
手順
-
目指す最終状態を1~2文で述べます。
-
互換性を維持する前に、実際の呼び出し元を探します。 モード、プロパティ、ラッパー、ルートエイリアス、フォールバックに現在の呼び出し元がない場合は、削除します。
-
最終的なプロダクトの形に合わせて再構成します。 モードフラグより、明確な単一のコンポーネントまたはフローを優先します。状態、レイアウト、コントロール、ドメインコマンドなど、明確な境界を作れる場合にのみ分割します。
-
共通ルールを一か所にまとめます。 機能フラグ、権限、ルートの制御、URL の状態、コマンドの命名をページ間で重複させたり、ビューコンポーネント内に隠したりしないでください。
-
目指すフローを検証します。 新しい動作と、ナビゲーション、権限、永続化された状態に影響する削除対象の前提をテストします。
ルール
- 古い形からの差分を最小にするのではなく、あるべきコードを目指します。
- 不要な互換性維持の経路は、改善するのではなく削除します。
- 1つの機能のために汎用フレームワークを作らないでください。
- 最終形に一貫性を持たせるために必要な範囲に、リファクタリングを限定します。
- 実装の経緯より、プロダクトとしての意図を表す名前を優先します。
コメント
Markdown 対応