agent-maplisted
Install: claude install-skill masa-san-jp/Agent-Aiko
# /agent-map
自分のエージェント関連ディレクトリ構造をスキャンし、生きた俯瞰ドキュメント(`MAP.md` などの単一ファイル)を再生成する参考パターン。
このマップは **1 つのリポジトリに閉じない** 場合がある(マシン上に複数のエージェント関連ディレクトリ・設定ストアが散らばることを想定)。ポイントは「散在する構造を 1 枚に集約し、更新日を刻んで運用する」こと。**このスキルは特定リポジトリの中身をハードコードしない** — 下記は雛形であり、スキャン対象は自分の環境に合わせて定義する。
## 引数
- ��数なし:既定の出力先 `<MAP_FILE>`(例: `{{ORG_REPO_PATH}}/MAP.md`)を再生成する
- `<MAP_FILE>`:出力先を明示指定する場合
## スキャン対象(例 — 自分の環境に置き換える)
以下は「どういう領域を拾うか」の型。実在するパスに読み替えて `ls`/`find` で構造を抽出する。存在しないパスは「存在せず」と明記する(隠さない)。
| 領域 | パス(例) | 抽出粒度 |
|---|---|---|
| 中心リポジトリ | `{{ORG_REPO_PATH}}/` | top-level + 主要サブディレクトリ + persona/role 定義の所在 |
| 公開/派生リポジトリ | `<other-repo>/` | top-level のみ |
| マシン全体の設定ストア | `~/.claude/` 等 | agents/ / skills/ / commands/ の件数(個別列挙はしない) |
| データ同期ディレクトリ | `<data-sync-dir>/` | 直下のディレクトリ名一覧 |
| その他エージェント系 | パターンにマッチするリポ | リポ名のみ |
## 出力フォーマット
`<MAP_FILE>` の構造(既存ファイルがあれば置換、なければ新規作成):
```markdown
# Agent Directory Map
> エージェント関連ディレクトリ構造の生きた文書。
> Last regenerated: <YYYY-MM-DD> by /agent-map skill
## TL;DR
(3 行以内で最重要事実:中心リポジトリ / 公開リポジトリ / 設定ストアの所在)
## ディレクトリツリー
(ツリー図、各ノードに 1 行コメント)
## 既知の不整合・課題
(重複ストア、設定ファイルのパス参照ずれ等。発見されたものをタスク ID と紐付けて列挙)
## ルール参照
- 公開境界・ルール目次・タスク管理などへのリンク(自分の運用に合わせて)
- 本マップの再生成:`{{ORG_REPO_PATH}}/Agent-team/reference/skills/agent-map/SKILL.md`(`/agent-map`)
```
## 実行手順
1. 上記スキャン対象をすべて `ls`/`find` で取得(並列実行可)
2. 既存 `<MAP_FILE>` を読み、不整合・課題セクションの記述(手動追記された注釈)は可能なら保全する
3. 新内容で `<MAP_FILE>` を書き直す(Write ツールで上書き)
4. ユーザーに 1〜3 行で報告(「regenerated. <主な変化>」)
## 不整合・課題の扱い
スキャン中に以下を検出したら「既知の不整合・課題」