agent-md-refactor
肥大化した AGENTS.md や CLAUDE.md などのエージェント指示ファイルを、プログレッシブディスクロージャーの原則に従ってリファクタリングします。モノリシックなファイルを整理された相互リンク付きのドキュメント群に分割します。
description の原文を見る
Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
SKILL.md 本文
Agent MD Refactor
肥大化したエージェント命令ファイル（AGENTS.md、CLAUDE.md、COPILOT.md など）をリファクタリングして、段階的開示の原則に従うようにします。本質的な情報をルートに保持し、残りをリンクされた分類されたファイルに整理します。
トリガー
以下の場合にこのスキルを使用してください：
- 「AGENTS.md をリファクタリングしてほしい」/「CLAUDE.md をリファクタリングしてほしい」
- 「エージェント命令を分割してほしい」
- 「CLAUDE.md ファイルを整理してほしい」
- 「AGENTS.md が長すぎる」
- 「命令に段階的開示を適用してほしい」
- 「エージェント設定をクリーンアップしてほしい」
クイックリファレンス
| フェーズ | アクション | 出力 |
|---|---|---|
| 1. 分析 | 矛盾を検出 | 解決すべき競合のリスト |
| 2. 抽出 | 本質を識別 | ルートファイル用の核となる命令 |
| 3. 分類 | 残りの命令をグループ化 | 論理的なカテゴリ |
| 4. 構造化 | ファイル階層を作成 | ルート + リンクされたファイル |
| 5. 削減 | 削除対象をフラグ | 冗長/曖昧な命令 |
プロセス
フェーズ 1: 矛盾を検出
互いに矛盾する命令を特定します。
探すべき項目：
- 矛盾したスタイルガイドライン（例：「セミコロンを使用する」対「セミコロンは不可」）
- ワークフロー命令の競合
- 互換性のないツール設定
- 相互に排他的なパターン
各矛盾について：
## 矛盾が見つかった
**命令 A:** [引用]
**命令 B:** [引用]
**質問:** どちらを優先すべきか、それとも両方を条件付きにすべきか？
ユーザーに先に進む前に解決を求めます。
フェーズ 2: 本質を識別
ルートエージェント ファイルに属すべき内容のみを抽出します。ルートは最小限にし、すべてのタスクに適用される情報のみを含めます。
本質的な内容（ルートに保持）：
| カテゴリ | 例 |
|---|---|
| プロジェクト説明 | 1 文：「分析用 React ダッシュボード」 |
| パッケージマネージャー | npm 以外の場合のみ（例：「pnpm を使用」） |
| 非標準コマンド | カスタムビルド/テスト/型チェックコマンド |
| 重要なオーバーライド | デフォルトをオーバーライドする必要がある内容 |
| 普遍的なルール | 100% のタスクに適用される規則 |
本質的でない内容（リンクされたファイルに移動）：
- 言語固有の慣例
- テストガイドライン
- コードスタイルの詳細
- フレームワークパターン
- ドキュメント標準
- Git ワークフローの詳細
フェーズ 3: 残りをグループ化
残りの命令を論理的なカテゴリに整理します。
一般的なカテゴリ：
| カテゴリ | 内容 |
|---|---|
typescript.md | TS 慣例、型パターン、厳密モード規則 |
testing.md | テストフレームワーク、カバレッジ、モックパターン |
code-style.md | フォーマット、命名、コメント、構造 |
git-workflow.md | コミット、ブランチ、PR、レビュー |
architecture.md | パターン、フォルダ構造、依存関係 |
api-design.md | REST/GraphQL 慣例、エラーハンドリング |
security.md | 認証パターン、入力検証、シークレット |
performance.md | 最適化ルール、キャッシング、遅延ロード |
グループ化ルール：
- 各ファイルはそのトピックに対して自己完結していること
- 3～8 ファイルを目指す（細分化しすぎず、広すぎず）
- ファイル名を明確に：
{topic}.md - 実行可能な命令のみを含める
フェーズ 4: ファイル構造を作成
出力構造：
project-root/
├── CLAUDE.md (or AGENTS.md) # リンク付きの最小限のルート
└── .claude/ # または docs/agent-instructions/
├── typescript.md
├── testing.md
├── code-style.md
├── git-workflow.md
└── architecture.md
ルートファイルテンプレート：
# プロジェクト名
プロジェクトの 1 文での説明。
## クイックリファレンス
- **パッケージマネージャー:** pnpm
- **ビルド:** `pnpm build`
- **テスト:** `pnpm test`
- **型チェック:** `pnpm typecheck`
## 詳細な命令
特定のガイドラインについては、以下を参照してください：
- [TypeScript 慣例](.claude/typescript.md)
- [テストガイドライン](.claude/testing.md)
- [コードスタイル](.claude/code-style.md)
- [Git ワークフロー](.claude/git-workflow.md)
- [アーキテクチャパターン](.claude/architecture.md)
各リンクされたファイルテンプレート：
# {トピック} ガイドライン
## 概要
これらのガイドラインが適用される場合のコンテキスト。
## ルール
### ルールカテゴリ 1
- 具体的で実行可能な命令
- 別の具体的な命令
### ルールカテゴリ 2
- 具体的で実行可能な命令
## 例
### よい例
\`\`\`typescript
// 正しいパターンの例
\`\`\`
### 避けるべき例
\`\`\`typescript
// やってはいけないパターンの例
\`\`\`
フェーズ 5: 削除対象をフラグ
完全に削除すべき命令を特定します。
削除対象：
| 基準 | 例 | 削除理由 |
|---|---|---|
| 冗長 | 「TypeScript を使用する」（.ts プロジェクト内） | エージェントはすでに知っている |
| 曖昧すぎる | 「クリーンなコードを書く」 | 実行可能ではない |
| 過度に明白 | 「バグを導入しない」 | コンテキストを浪費 |
| デフォルト動作 | 「説明的な変数名を使用する」 | 標準的な実践 |
| 廃止予定 | 廃止されたAPI への参照 | もはや適用されない |
出力形式：
## 削除対象としてフラグ
| 命令 | 理由 |
|------|------|
| 「クリーンで保守性の高いコードを書く」 | 実行可能ではなく曖昧すぎる |
| 「TypeScript を使用する」 | 冗長 - プロジェクトはすでに TS |
| 「シークレットをコミットしない」 | エージェントはすでに知っている |
| 「ベストプラクティスに従う」 | 具体的な説明がないと無意味 |
実行チェックリスト
[ ] フェーズ 1: すべての矛盾が特定され解決されている
[ ] フェーズ 2: ルートファイルには本質的な内容のみが含まれている
[ ] フェーズ 3: すべての残りの命令が分類されている
[ ] フェーズ 4: 適切なリンク付きのファイル構造が作成されている
[ ] フェーズ 5: 冗長/曖昧な命令が削除されている
[ ] 確認: 各リンクされたファイルが自己完結している
[ ] 確認: ルートファイルが 50 行以下である
[ ] 確認: すべてのリンクが正常に機能している
アンチパターン
| 避けるべき | 理由 | 代わりに |
|---|---|---|
| すべてをルートに保持 | 肥大化し保守困難 | リンクされたファイルに分割 |
| カテゴリが多すぎる | 分断化 | 関連トピックを統合 |
| 曖昧な命令 | トークンを無駄にし、価値がない | 具体的にするか削除 |
| デフォルトの複製 | エージェントはすでに知っている | 必要な場合にのみオーバーライド |
| ネストが深い | ナビゲートが困難 | リンク付きのフラット構造 |
例
Before（肥大化したルート）
# CLAUDE.md
これは React プロジェクトです。
## コードスタイル
- 2 スペースを使用
- セミコロンを使用
- const を let より優先
- アロー関数を使用
... （さらに 200 行以上）
## テスト
- Jest を使用
- カバレッジ > 80%
... （さらに 100 行以上）
## TypeScript
- 厳密モードを有効化
... （さらに 150 行以上）
After（段階的開示）
# CLAUDE.md
リアルタイム分析可視化用の React ダッシュボード。
## コマンド
- `pnpm dev` - 開発サーバーを起動
- `pnpm test` - カバレッジ付きでテストを実行
- `pnpm build` - 本番ビルド
## ガイドライン
- [コードスタイル](.claude/code-style.md)
- [テスト](.claude/testing.md)
- [TypeScript](.claude/typescript.md)
検証
リファクタリング後、以下を確認してください：
- ルートファイルが最小限である - 50 行以下、普遍的な情報のみ
- リンクが機能している - 参照されるすべてのファイルが存在する
- 矛盾がない - 命令が一貫している
- 実行可能な内容である - すべての命令が具体的である
- 完全なカバレッジである - 命令が失われていない（削除対象としてフラグされたものを除く）
- ファイルが自己完結している - 各リンクされたファイルが単独で成立している
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- softaworks
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/softaworks/agent-toolkit / ライセンス: MIT
関連スキル
agent-browser
AI エージェント向けのブラウザ自動化 CLI です。ウェブサイトとの対話が必要な場合に使用します。ページ遷移、フォーム入力、ボタンクリック、スクリーンショット取得、データ抽出、ウェブアプリのテスト、ブラウザ操作の自動化など、あらゆるブラウザタスクに対応できます。「ウェブサイトを開く」「フォームに記入する」「ボタンをクリックする」「スクリーンショットを取得する」「ページからデータを抽出する」「このウェブアプリをテストする」「サイトにログインする」「ブラウザ操作を自動化する」といった要求や、プログラマティックなウェブ操作が必要なタスクで起動します。
anyskill
AnySkill — あなたのプライベート・スキルクラウド。GitHubを基盤としたリポジトリからエージェントスキルを管理、同期、動的にロードできます。自然言語でクラウドスキルを検索し、オンデマンドでプロンプトを自動ロード、カスタムスキルのアップロードと共有、スキルバンドルの一括インストールが可能です。OpenClaw、Antigravity、Claude Code、Cursorに対応しています。
engram
AIエージェント向けの永続的なメモリシステムです。バグ修正、意思決定、発見、設定変更の後はmem_saveを使用してください。ユーザーが「覚えている」「記憶している」と言及した場合、または以前のセッションと重複する作業を開始する際はmem_searchを使用します。セッション終了前にmem_session_summaryを使用して、コンテキストを保持してください。
skyvern
AI駆動のブラウザ自動化により、任意のウェブサイトを自動化できます。フォーム入力、データ抽出、ファイルダウンロード、ログイン、複数ステップのワークフロー実行など、ユーザーがウェブサイトと連携する必要があるときに使用します。Skyvernは、LLMとコンピュータビジョンを活用して、未知のサイトも自動操作可能です。Python SDK、TypeScript SDK、REST API、MCPサーバー、またはCLIを通じて統合できます。
pinchbench
PinchBenchベンチマークを実行して、OpenClawエージェントの実世界タスクにおけるパフォーマンスを評価できます。モデルの機能テスト、モデル間の比較、ベンチマーク結果のリーダーボード提出、またはOpenClawのセットアップがカレンダー、メール、リサーチ、コーディング、複数ステップのワークフローにどの程度対応しているかを確認する際に使用します。
openui
OpenUIとOpenUI Langを使用してジェネレーティブUIアプリを構築できます。これらはLLM生成インターフェースのためのトークン効率的なオープン標準です。OpenUI、@openuidev、ジェネレーティブUI、LLMからのストリーミングUI、AI向けコンポーネントライブラリ、またはjson-render/A2UIの置き換えについて述べる際に使用します。スキャフォルディング、defineComponent、システムプロンプト、Renderer、およびOpenUI Lang出力のデバッグに対応しています。