Menu
AGENTS.mdとSkillsを「AI Agent Knowledge Architecture Policy」に基づいて整理・再構成する
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
修正を複数ブランチに適用する際のブランチ戦略。featureブランチへの先行commitとcherry-pickによる短命branchへの適用手順。環境別branch（qa/staging/epsilon等）への修正適用時に参照する。
DeepWiki (Devin MCP) のドキュメント内容を対象リポジトリの Markdown ファイルとして転載する。セクション構成維持・番号付きファイル分割・GFM 準拠補正・日本語翻訳 (オプション) まで自動処理。
PRのレビューコメントを確認し、優先度に応じてコード修正を実行する。サブエージェント (general-purpose) 起動にも対応。--defer-nit / --severity-min で対応範囲を制御。
実装プランファイル作成・更新の手順。実装開始時およびPR作成時にissues/配下の実装プランの有無を確認し、なければ会話履歴・git log・git diffから生成する。複数ファイル変更・新規機能追加・DBマイグレーション伴う変更が対象。
調査レポート作成のルール。否定的結論のエビデンス要件、残課題の記載フォーマット、ハルシネーション防止のための裏取り原則を扱う。DB調査に限らずコードベース調査・仕様調査一般に適用。
ログを追加・修正する際のガイドライン。ログレベルの選択基準、ループ内ログの制御、エラー蓄積パターン、機密情報の扱いを扱う。言語/FW非依存の原則。
| 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指定時はレポートのみ出力し、ファイルを変更しない