メニュー
AGENTS.mdとSkillsを「AI Agent Knowledge Architecture Policy」に基づいて整理・再構成する
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/takemi-ohama/ai-plugins --skill knowledge-reorgコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SOC 職業分類に基づく
SKILL.md を表示中
| name | knowledge-reorg |
| description | AGENTS.mdとSkillsを「AI Agent Knowledge Architecture Policy」に基づいて整理・再構成する |
| argument-hint | [--target AGENTS.md|skills|docs|all] [--dry-run] [--migrate-memory] |
| disable-model-invocation | true |
| allowed-tools | ["Bash","Read","Write","Edit","Glob","Grep","AskUserQuestion","Task"] |
AGENTS.md・Skills・docsを「AI Agent Knowledge Architecture Policy」に基づいて分析・整理する。
$ARGUMENTS
知識を以下の3層に分離する。実際のパスはリポジトリやAIエージェントごとに異なる。
| 層 | 役割 |
|---|---|
| エントリポイント | ナビゲーション + ポリシー（軽量、300行以下推奨） |
| ドキュメント | リポジトリ知識（アーキテクチャ、モジュール説明、依存関係） |
| スキル | 実行可能なワークフロー（手順、コマンド、チェックリスト） |
推奨: AGENTS.mdを共通エントリポイントとし、各エージェント固有ファイルからインポートで参照する。
AGENTS.md ← 共通エントリポイント（本体）
.claude/CLAUDE.md ← @../AGENTS.md でインポート
.gemini/GEMINI.md ← @../AGENTS.md でインポート
（Codex CLI） ← AGENTS.md を直接読込（設定不要）
（Kiro CLI） ← AGENTS.md を直接読込（設定不要）
Claude Code (.claude/CLAUDE.md):
@../AGENTS.md
Gemini CLI (.gemini/GEMINI.md):
@../AGENTS.md
または.gemini/settings.jsonで:
{ "context": { "fileName": ["AGENTS.md", "GEMINI.md"] } }
Codex CLI / Kiro CLI: AGENTS.mdをネイティブに読込。追加設定不要。
| エージェント | 固有ファイル | グローバル | AGENTS.md |
|---|---|---|---|
| Claude Code | .claude/CLAUDE.md | ~/.claude/CLAUDE.md | @../AGENTS.mdでインポート |
| Kiro CLI | .kiro/steering/*.md | ~/.kiro/steering/*.md | 直接読込 |
| Codex CLI | なし（AGENTS.md標準） | ~/.codex/AGENTS.md | 直接読込 |
| Gemini CLI | .gemini/GEMINI.md | ~/.gemini/GEMINI.md | @../AGENTS.mdでインポート or settings.json |
補足:
product.md/tech.md/structure.md）で構造化指示を管理AGENTS.override.mdによる上書き機構あり@構文でネストインポート対応（循環検出あり、最大深度5）| エージェント | プロジェクト | ユーザー |
|---|---|---|
| Claude Code | .claude/skills/<name>/SKILL.md | ~/.claude/skills/<name>/SKILL.md |
| Kiro CLI | .kiro/skills/<name>/SKILL.md | なし（エージェント経由） |
| Codex CLI | .agents/skills/<name>/SKILL.md | ~/.agents/skills/<name>/SKILL.md |
| Gemini CLI | .agents/skills/<name>/SKILL.md or .gemini/skills/<name>/SKILL.md | ~/.agents/skills/<name>/SKILL.md or ~/.gemini/skills/<name>/SKILL.md |
共通: 全エージェントがSKILL.mdファイルを採用（Agent Skillsオープンスタンダードに収束傾向）。
ドキュメントディレクトリはエージェント標準では規定されていない。docs/が一般的な慣例。
整理を始める前に、対象リポジトリで以下を検出する:
docs/が存在するか、なければ作成先を提案検出結果をAskUserQuestionでユーザーに確認し、以降の作業で使用する。
まず「0) パス検出」でエントリポイント・ドキュメントディレクトリ・スキルディレクトリを特定した上で、以下を分析する:
エントリポイントの行数とトークン概算を計測
ドキュメントディレクトリの状態を確認
スキルディレクトリの状態を確認
Serena memoryの状態を確認（--migrate-memory指定時）
.serena/memories/の内容を一覧以下の形式でユーザーに報告する:
## 現状分析レポート
### エントリポイント（{検出したファイル名}）
- 行数: X行（目標: 300行以下）
- 状態: 適正 / 肥大化
- 含まれる情報の内訳:
- ナビゲーション: X行
- 知識（ドキュメント移動候補）: X行
- 手順（スキル移動候補）: X行
- ポリシー: X行
### ドキュメント（{検出したパス}）
- 状態: 未作成 / 不足 / 適正
- 不足している知識: [リスト]
### スキル（{検出したパス}）
- 状態: 適正 / 知識混入あり
- 問題のあるスキル: [リスト]
### Serena Memory（該当時）
- 移行対象: X件
- ドキュメント移動: X件
- スキル移動: X件
- 削除候補: X件
AskUserQuestionで以下を確認:
以下のルールで再配置:
| Memory種別 | 移行先 |
|---|---|
| リポジトリ構造 | ドキュメント |
| アーキテクチャ説明 | ドキュメント |
| モジュール説明 | ドキュメント |
| 依存関係 | ドキュメント |
| エージェント手順 | スキル |
| 一時的な調査結果 | 削除 |
| タスク履歴 | 削除 |
整理後に以下を検証:
## 整理完了レポート
### 変更サマリー
- エントリポイント: X行 → Y行（Z行削減）
- ドキュメント: X件のファイルを追加/更新
- スキル: X件のスキルを整理
- Serena memory: X件を移行、Y件を削除候補
### 作成/変更したファイル
- [ファイル一覧]
### 次のステップ
- [ ] 変更内容のレビュー
- [ ] 不要なSerena memoryの削除（手動確認推奨）
- [ ] コミット＆PR作成（`/ndf:pr`）
整理時は以下を遵守:
--dry-run指定時はレポートのみ出力し、ファイルを変更しない修正を複数ブランチに適用する際のブランチ戦略。featureブランチへの先行commitとcherry-pickによる短命branchへの適用手順。環境別branch（qa/staging/epsilon等）への修正適用時に参照する。
DeepWiki (Devin MCP) のドキュメント内容を対象リポジトリの Markdown ファイルとして転載する。セクション構成維持・番号付きファイル分割・GFM 準拠補正・日本語翻訳 (オプション) まで自動処理。
PRのレビューコメントを確認し、優先度に応じてコード修正を実行する。サブエージェント (general-purpose) 起動にも対応。--defer-nit / --severity-min で対応範囲を制御。