AI Agent Skills運用：プロバイダー非依存とメンテナンス設計

AI AgentのSkills運用では、Providerごとの仕様差分を前提としながらも、業務知識や手順を個別の環境に分散させないことが重要になります。Skills、Subagent、Core Ruleをそれぞれ異なる責務として整理し、編集すべき正本を明確にしたうえで、Provider固有の差分はadapterやsyncによって吸収します。これにより、生成物を直接編集することによるズレを防ぎ、更新・同期・検証の流れを安定させることができます。さらに、実務で発生した失敗や改善点をその場限りの注意で終わらせず、Skill本文やテンプレート、評価基準に反映していくことで、継続的なPDCAサイクルを回し、モデル性能の変化にも対応できる再現性の高い運用を目指します。

Transcript

1. AI Agent Skills運用︓ プロバイダー非依存とメンテナンス設計 2026年6月16日
2. 2 © 2026 Boost Consulting, Inc. アジェンダ 1 Skills運用で起きる問題 2 正本と同期メカニズム 3 3つのMaintenance 4 SkillsのPDCAサイクル 5 今後のSkills運用
3. 3 © 2026 Boost Consulting, Inc. 冒頭ディスカッション 発表に入る前に、参加者自身のSkills運用を共有する（グループでそれぞれ発表） A 現在どのようにSkillsを運用していますか ▪ 個人のローカル設定、チーム共有、Provider別管理など現状を共 有する ▪ うまく回っている点と、困っている点を分けて話す B 特に活用しているSkillsは何ですか ▪ 日報、議事録、リサーチ、レビュー、資料作成など具体例を出す
4. 4 © 2026 Boost Consulting, Inc. アジェンダ 1 Skills運用で起きる問題 2 正本と同期メカニズム 3 3つのMaintenance 4 SkillsのPDCAサイクル 5 今後のSkills運用
5. 5 5 © 2026 Boost Consulting, Inc. 現状課題 Skillsは全Providerで同じ形式を扱えるわけではない Provider Skillsの置き場所 周辺設定 運用上のズレ Codex .agents/skillsを正本として扱う運用 AGENTS.md、 config.toml、 hooks、agents TOMLやhook設定がSkills本文とは別に存在する Claude Code .claude/skills/<skill-name>/SKILL.md CLAUDE.md、 settings.json、 hooks、 subagents Project Skillの配置とsettingsの更新が必要になる Gemini CLI .gemini/skillsや.agents/skills GEMINI.md、 settings.json、 hooks、agents JSON設定とMarkdown系定義の整合が必要になる Cursor .cursor/skillsや.agents/skills Rules、Skills、 Subagents RulesとSkillsの役割分担を決める必要がある
6. 6 6 © 2026 Boost Consulting, Inc. 問題の本質 Provider差分そのものより、業務知識がProvider固有層に散ることがリスクになる
7. 7 7 © 2026 Boost Consulting, Inc. アジェンダ 1 Skills運用で起きる問題 2 正本と同期メカニズム 3 3つのMaintenance 4 SkillsのPDCAサイクル 5 今後のSkills運用
8. 8 © 2026 Boost Consulting, Inc. 同期メカニズム 編集対象は正本に寄せ、Provider差分はadapter / syncへ逃がす
9. 9 © 2026 Boost Consulting, Inc. 同期フロー CodexでSkillを変更しても、他Provider用のSkillsにも同期できる状態にする
10. 10 © 2026 Boost Consulting, Inc. Provider別差分 公式仕様と運用上の互換パスを分けて、どこが正本かを明確にする 観点 Claude Code Codex Gemini CLI Cursor Skills参照 .claude/ skills配下 を読む .agents/skillsを正本として扱う .gemini/skillsや互換パスを扱う .cursor/skills や .agents/skills を扱う 共通入口 CLAUDE. md AGENTS.md GEMINI.md Rules 設定形式 JSON TOML JSON JSON
11. 11 11 © 2026 Boost Consulting, Inc. アジェンダ 1 Skills運用で起きる問題 2 正本と同期メカニズム 3 3つのMaintenance 4 SkillsのPDCAサイクル 5 今後のSkills運用
12. 12 12 © 2026 Boost Consulting, Inc. メンテナンス設計 Skill,subagent,AGENTS.mdを同じ作業で編集しない
13. 13 13 © 2026 Boost Consulting, Inc. Skills Maintenance Skill作成だけではなく、統合・削除・trigger整理まで含めて管理する 作業 見るもの 編集場所 新規作成 名前、用途、対象外、出力契約、標準構成 SKILL.md 更新 本文、template、references、評価基準、scripts SKILL.md / assets / evolution / scripts 統合 似たSkillを1つに寄せられるか Skills全般 削除・凍結 使われていないSkillや古い手順が残っていないか Skills全般 検証 frontmatter、標準ディレクトリ、adapter drift validator / sync script
14. agent定義は役割・入力・出力・禁止事項を明確にしてProvider別形式へ同期する 01 編集対象 ▪ ai/agents/*.yamlを共通定義の正本 にする ▪ source_skillで、どのSkillに紐づく agentかを示す ▪ .claude / .codex / .geminiの生成 物は直接編集しない 02 変更ルール ▪ 役割、入力、出力、禁止事項、利用ツ ール範囲を更新する ▪ instructionsは実行責務と期待アウトプ ットに絞る ▪ Skill本文と重複する長い業務手順は持 たせない 03 検証 ▪ Provider別agent定義を生成し、構文 を確認する ▪ Skillとの対応関係とallowed toolsの 過不足を見る ▪ 生成物に直接編集禁止の注記が残って いるか確認する © 2026 Boost Consulting, Inc. 2 Subagent Maintenance
15. AGENTS.md / CLAUDE.mdには全Agentが常時読む共通ルールだけを置く 01 編集対象 ▪ AGENTS.mdを共通ルール正本として 扱う ▪ CLAUDE.md / GEMINI.md はシンボリック ▪ hooks、settings、adapterの扱いは 正本パスと合わせて管理する 02 変更ルール ▪ 置くのは正本パス、同期手順、禁止事 項、検証コマンドに絞る ▪ 詳細な業務手順、テンプレート、評価基 準はSkillへ逃がす ▪ subagentの役割や出力契約は ai/agents/*.yamlへ逃がす 03 検証 ▪ symlinkや入口ファイルの関係が壊れて いないか見る ▪ adapter同期後にProvider別設定へ 反映されるか確認する ▪ validate_ai_opsで全体の整合性を確 認する © 2026 Boost Consulting, Inc. 3 Core Rule Maintenance
16. 16 16 © 2026 Boost Consulting, Inc. アジェンダ 1 Skills運用で起きる問題 2 正本と同期メカニズム 3 3つのMaintenance 4 SkillsのPDCAサイクル 5 今後のSkills運用
17. 17 17 © 2026 Boost Consulting, Inc. PDCA 実務で出た失敗を会話内の注意で終わらせず、Skillへ反映
18. 18 © 2026 Boost Consulting, Inc. アジェンダ 1 Skills運用で起きる問題 2 正本と同期メカニズム 3 3つのMaintenance 4 SkillsのPDCAサイクル 5 今後のSkills運用
19. 19 © 2026 Boost Consulting, Inc. 今後のSkills運用 モデル性能が上がるほど、Skillに書くべき粒度も変わる
20. 20 20 © 2026 Boost Consulting, Inc. まとめ Skillsは一度作って終わる設定ではなく、実務で改善する運用を考えることが重要 （グループでそれぞれ発表） 01 まとめ ▪ Provider差分は消せないため、差分を正本に混ぜない ▪ 正本、adapter / sync、validatorで変更と検証の流れを分ける ▪ Skills、Subagent、Core Ruleメンテナンスskillsを用意し、全て同 じ形式で作成,修正できるようにする ▪ 上記を実施することで、統一したskills作成が実現でき、 PDCAサイクルを回しやすくなる。 02 最終ディスカッション ▪ 組織でSkillsを活用する上で、どのように管理,運用するのが望ましい か ▪ Githubで管理するなど ▪ 今後のモデル性能向上などを踏まえ、Skillsはどのような形であるべき か
21. Strictly confidential CONFIDENTIAL 本文書（添付資料を含む）は、ブーストコンサルティング株式会社が著作権その他の権利を有 する営業秘密（含サプライヤ等第三者が権利を有するもの）です。当社の許可なく複製し利 用すること、また漏洩することは「著作権法」「不正競争防止法」によって禁じられております。本 資料内の社名・製品名は各社の登録商標です。 また、本資料はブーストコンサルティング株式会社による口頭の説明を補助するために使用され るものであって、本件に関する検討内容や議論の過程を網羅的に掲載しているものではありませ ん。 21 © 2026 Boost Consulting, Inc.
22. Strictly confidential End of File