SkillとAgentを一元管理する / Centrally manage Skills and Agents

## 発表

https://mild-web-sap.connpass.com/event/400434/

## リポジトリ

https://github.com/tooppoo/enozunu

Transcript

1. Skill/Agentを一元管理する 2026-08-22 ゆるWeb勉強会@札幌 #31 #ゆるWeb札幌 @Philomagi 1 / 19
2. 発表者 @Philomagi WEB系プログラマ 自称フロントエンド寄り 最近は Rust とか Go とか 2 / 19
3. skill と agent AI エージェントに作法を仕込むためのファイル群 プロジェクト直下の .claude/ などに置くと、エージェントが読んでくれる skill：手順書。「レビューはこう進める」を Markdown で書いておく agent：役割を絞った下請け。専用の指示と道具を渡して呼び出す 3 / 19
4. Skill/Agent導入で嬉しいこと 修正 → subagent にレビューさせる → 再修正、のループを skill 化 git-kura を使わせる skill で、並行作業の衝突をマージ前に検出 AIにレビューさせる時、特定観点からのレビューを指示できる 4 / 19
5. Skill/Agent再利用の問題 便利で汎用的なものほど、他のプロジェクトでも欲しくなる i.e. レビューループ、衝突の検出はプロジェクト非依存 プロジェクト固有ではないSkill/Agentsが溜まっていく プロジェクト固有ではないSkill/Agentをどうやって共有するか 5 / 19
6. STEP 1 コピー&ペースト 6 / 19
7. コピー&ペーストの問題点 や .codex/skills を、そのまま別のリポジトリへコピーする 一番簡単な方法だが、リポジトリが増えるたびにコピーが増える 片方の skill を改善しても、もう片方は古いまま .claude/skills/ 「同じ名前の skill が、リポジトリごとに違う挙動をする」がありうる どれが原本なのか分からなくなる 7 / 19
8. STEP 2 ユーザーディレクトリ 8 / 19
9. ユーザーディレクトリにskill/agentを配置 など、ユーザーディレクトリ以下に配置する 大抵のAIエージェントは、ユーザーディレクトリ以下のskill/agent定義も参照してく れる これで解決するケースも多そうではあるが、問題もある ~/.claude/skills/ 各プロジェクトがどのskill/agentを前提にしているか、わからなくなる devcontainer等、隔離技術との相性が微妙（後述） 9 / 19
10. AI エージェントと devcontainer devcontainerを用意し、devcontainer内部でAIエージェントを実行 作業をコンテナに閉じ込め、壊れても rebuild すれば元に戻るようにしている たまに見かける「AIエージェントがプロジェクト外の重要なファイルを壊してしまった」など 予期せぬ事故が起きうる前提で、取り返しがつく状態を先に作っておきたい 10 / 19
11. devcontainerとユーザーディレクトリの壁 コンテナの中から、ホストのユーザーディレクトリは見えない マウントすれば見えるが…… 隔離の境界が薄くなる プロジェクト外のディレクトリ構成に依存 11 / 19
12. 境界の内と外 devcontainer AI エージェント → 見えない ホスト ~/.claude/skills 隔離のための境界が、そのまま共有の障害になる 12 / 19
13. skill/agent共有のために欲しかったもの 定義の原本は、一箇所だけ 各プロジェクトには、どれを使うかの宣言だけを置く 原本更新の反映は、コマンド一発で済む skill/agentの実体は、いつでも再取得・再配置できる（rebuildできる） 13 / 19
14. enozunu 宣言された取得元を、各エージェントのネイティブなパスへ展開する CLI 名前は「役小角：という修験者から。鬼を使役したとされる逸話。 今のところ、Claude と Codex に対応している 14 / 19
15. enozunu.kdl enozunu config-version=1 { provider { skills { skill "subagent-review-loop" { git { url "https://github.com/tooppoo/catalog-agent-tools" branch "main" path "common/skills/subagent-review-loop" } } } } consumer { claude { use-skills "subagent-review-loop" } } } 15 / 19
16. enozunu summon で、宣言的に定義された取得元を解決して展開する 解決したコミットは enozunu.lock.json に記録され、別のマシンでも同じものが展 開される enozunu summon 更新の反映はコピー作業からコマンド一回へ プロジェクトの前提となるskill/agentは宣言的に定義される 16 / 19
17. 変わったこと .claude や .codex を丸ごと .gitignore に入れるようになった 展開されたファイルは生成物なので、リポジトリに置く理由がない 消しても summon で戻る skill と agent の定義は、専用のリポジトリで一元管理するようになった 各プロジェクトが原本を指すので、同期の仕組みはそもそも要らなくなった 宣言定義だけをコピーして再利用している 17 / 19
18. これから 宣言定義のコピーは、まだ手作業のまま残っている リモート URL に置いた宣言を、ベースとして継承できるようにしたい tsconfig.json の extends のイメージ ベースを一箇所直せば、 summon 再実行で反映される 18 / 19
19. まとめ 共通の作法をコピペで配ると、原本が分からなくなる ユーザーディレクトリでの共有も問題が残る プロジェクトの前提となるskill/agentがわからなくなる devcontainer などの隔離と両立しない 宣言だけを共有し、実体は生成物として捨てられるようにした https://github.com/tooppoo/enozunu 19 / 19