Menu
AGENTS.mdとSkillsを「AI Agent Knowledge Architecture Policy」に基づいて整理・再構成する
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
修正を複数ブランチに適用する際のブランチ戦略。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指定時はレポートのみ出力し、ファイルを変更しない