Skills DirectoryGitHub から厳選したオープンソースの Skills
日本語

improve-codebase-architecturecommit 7739eaeSKILL.md · アーキテクチャ改善

コードベース設計改善

浅いモジュールを深くするリファクタリング候補を探し、HTML レポートで可視化して、選んだ候補を問答で詰めます。

npx skills add mattpocock/skills --skill improve-codebase-architecture
権限
  • read-repo
  • write-files
  • shell
  • network
対応ツール
Claude Code, Codex, Copilot, Gemini CLI
GitHub
308.7k
提供元
コミュニティ · Matt Pocock
状態
スキャン済み
ライセンス
MIT
カテゴリ
アーキテクチャ改善
リポジトリ
github.com/mattpocock/skills/skills/engineering/improve-codebase-architecture

基本ルール

スキャンの前に範囲を決め、最近よく変更されている箇所を優先します。

実行フェーズ

  1. フェーズ 01範囲を決める

    ユーザーの指定があればそれに従い、なければ git log でホットスポットを探します。GLOSSARY.md と関連 ADR を先に読みます。

  2. フェーズ 02摩擦を探す

    サブエージェントでコードを巡回し、浅いモジュールや局所性の欠如、シームからの漏れを探して削除テストで確かめます。

  3. フェーズ 03HTML レポート作成

    OS の一時ディレクトリに自己完結型 HTML を書き出し、各候補に前後の図と推奨度を付け、最優先の候補を示します。

  4. フェーズ 04候補を詰める

    選ばれた候補について制約や依存、深化後の形を問答で詰め、GLOSSARY.md を更新し、必要なら ADR の記録を提案します。

権限の説明（SKILL.md より）

機能必要か説明
ファイル書き込み一部で必要一時ディレクトリの HTML レポートと、GLOSSARY.md・docs/adr/ の ADR のみを書き込みます。コード自体は変更しません。
コマンド実行一部で必要コミット履歴を見る git log と、レポートを開く open・xdg-open・start を実行します。
外部通信不要スキル自体は通信しません。生成したレポートはブラウザで開くと CDN から Tailwind と Mermaid を読み込みます。

SKILL.md のフロントマター（YAML）

SKILL.md のフロントマター（YAML）commit 7739eae
---
name: improve-codebase-architecture
description: Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
disable-model-invocation: true
---

関連スキル

ルールスキャンですべてのリスクを検出できるわけではありません。インストール前にこのスキルの SKILL.md を読み、権限を確認してください。
Markdown 版 GitHub