fstack-simplify

/fstack-simplify

不必要な複雑さを監査し、削除を提案します。削除のみ — 追加は決して行いません。プラン、diff、ファイル、コードベース全体など、あらゆるスコープで機能します。承認なしに何かが適用されることはありません。

使用する場面

• ユーザーがプラン、diff、ファイル、フォルダー、プロジェクト全体に対して /fstack-simplify を呼び出す。
• /fstack-check が複雑さを検出し、このスキルの実行を提案した。
• 何かが肥大化している、過剰に設計されている、または雑だと感じる — 1 つのファイルでも全体でも。

手順

1. 対象を読みます。コードベース全体の場合は、まず全体像を把握します — ファイルツリー、エントリポイント、依存関係、実際に使われているもの。
2. 次の臭いに目を光らせます:
   • デッドコード — 未使用のファイル、エクスポート、関数、インポート
   • 呼び出し元が 1 つだけの抽象化、またはデータをただ通過させるだけのレイヤー
   • 誰も求めていない設定オプション
   • 数行のコードを置き換えるだけの依存関係
   • 起こり得ない状況に対するエラー処理
   • コードをただ言い換えているだけのコメント、または「将来のために」書かれたが将来が決して必要としなかったコード
   • 共有されずに乖離してしまったコピー&ペーストのブロック
   • ドキュメントやコメント内の、初心者にはわからない言葉
3. 提案する削除と削減のリストを作成します。各項目は 1 行です: 何を削除するか、そして何を失うか（通常は: 何も失いません）。コードベース全体のパスの場合は、順位付けし、領域ごとにグループ化し、安全で価値の高い削減を先にします。
4. 停止して尋ねます — どれを適用するか。
5. 承認されたものを適用します。大規模なパスの場合は、一度に 1 バッチずつ適用し、バッチ間でテストまたはビルドを実行します。何かが壊れた場合は、続行する前に停止して報告します。

してはいけないこと

• 追加を提案する。このスキルは削除と削減のみを行います。
• 動作しているコードを別のスタイルに書き換える。よりシンプルに、別物ではなく。
• 見慣れないというだけの理由で何かを削除する。未使用かどうか確信が持てない場合は、そのままにして、そう伝える。
• 生成されたファイル、ベンダー提供のコード、ロックファイルに触れる。
• 承認なしに何かを適用する、または前のバッチが通ったことを確認する前にバッチ全体を適用する。

出力例

もっと少なくできます（順位付け）:

1. src/utils/legacy/ を削除 — 4 ファイル、インポートはゼロ。失うもの: 何もなし。
2. ThemeProvider 抽象化を削除 — 利用者は 1 つ、フックで事足ります。失うもの: 何もなし。
3. theme-config.json を削除 — 値は 2 つ、インライン化します。失うもの: 何もなし。
4. clsx 依存関係を削除 — 使用は 1 回、テンプレートリテラルで機能します。失うもの: 何もなし。

どれを適用しましょうか？大規模な一掃の場合は、一度に 1 バッチずつ進め、その間でテストを実行します。