Claude CodeとCodex CLIのスキルを、プロジェクト固有の運用知識と複数プロジェクトで持ち運ぶ作業型に分けて考えます。
この記事の要点
- プロジェクトスキルは、そのリポジトリ固有の公開ルール、品質基準、禁止事項を置く場所になる。
- グローバルスキルは、複数プロジェクトで使うレビュー、調査、PR作成、引き継ぎの型を持ち運ぶ場所になる。
- 置き場所の判断は、プロンプト整理ではなく、責任範囲と再利用範囲の設計である。
スキルは、うまくいったプロンプトの保管庫ではない
AIエージェントのスキルを、過去にうまくいった指示文のストックだと思うと、置き場所の判断を見誤る。スキルが渡しているのは文章ではなく手順だ。どの作業のときに、どのファイルを先に開き、何をしてはいけなくて、どの確認をもって作業を終えるか。その段取りを丸ごとエージェントに持たせている。
同じ段取りでも、リポジトリの中に置くか、自分のホームディレクトリ側に置くかで性格が変わる。リポジトリ側に置けば、そのプロジェクトに関わる全員への約束になる。ホーム側に置けば、作業者ひとりが持ち歩く手癖になる。
この二つを混ぜると、エージェントは別のプロジェクトで覚えた癖を、いま開いているリポジトリへ持ち込む。記事の文体、公開前のチェック項目、デプロイの順番、避けたい言い回し。こうしたものほど、便利だからと全プロジェクト共通に引き上げた瞬間、現場ごとの違いを上書きしてしまう。
プロジェクト側に置くのは、その現場でだけ通じる約束
リポジトリ側のスキルに入れるべきなのは、そのプロジェクトでしか正しくない判断だ。記事のトーン、更新が必要なファイルの一覧、sitemapやllms.txtの直し方、E2Eの回し方、デザイントークンの扱い、公開前に毎回見る項目。どれもコードや公開物と同じ場所に置いたほうが、ずれにくい。
作業の正解がリポジトリごとに違うからだ。あるサイトではタイトルの末尾に句点を打たない。別のサイトでは画像の置き場所が違う。別のアプリでは、テストコマンドも、エージェントに許してよい操作の範囲も違う。
リポジトリ側のスキルは、その現場の地図をエージェントに手渡す役割を持つ。個人の好みより、チームで合意したルールが先に来る場所だと考えるとちょうどいい。
ホーム側に置くのは、どの現場でも繰り返す段取り
ホームディレクトリ側のグローバルスキルに向くのは、プロジェクトが変わっても形の変わらない作業だ。差分の読み方、PR本文の組み立て方、レビューで見る観点、調査メモの取り方、引き継ぎファイルの書き方。
これらは特定のサイトやアプリの事情ではなく、作業者自身の手の動かし方に近い。たとえばコードレビューのたびに「理由のないキャストで型をゆるめるな」「例外は外部との境界だけで受け止めろ」と毎回口頭で説明しているなら、それはグローバル側へ落とす候補になる。
注意したいのは、グローバルへ上げた段取りは、その瞬間からすべてのプロジェクトに同時に効きはじめることだ。ひとつの現場でちょうどよかった制約が、別の現場では足かせになることもある。
置き場所を取り違えると、判断がぶれはじめる
なんでもグローバルへ寄せると、プロジェクト固有の禁止事項が薄まり、現場の約束が守られなくなる。逆に、なんでもリポジトリへ押し込むと、個人が毎回こなす定型作業まで、プロジェクトごとに書き直す羽目になる。
名前の似たスキル、古いままの説明文、もう使われていないテンプレートがたまっていくと、エージェントはどの手順を読めばいいのか迷う。人間の目には小さな重複でも、エージェントにとっては「どちらの方針で動くか」という分岐になる。
スキルの名前、説明文、置き場所は、エージェントを動かすための操作パネルそのものだ。ここが曖昧なまま増えると、出力のぶれはプロンプトの書き方ではなく、手順の管理不足として表に出てくる。
Claude CodeとCodex CLIをまたぐと、差はさらに開く
Claude CodeとCodex CLIは、同じリポジトリを扱えても、設定ファイルの場所も、スキルの探し方も、許される権限も、ツールの返し方も同じではない。片方で問題なく読める手順が、もう片方でそのまま通るとは限らない。
だから、そのリポジトリでだけ正しい判断は、会話の履歴や個人のホームディレクトリではなく、リポジトリの中のファイルへ寄せておく。AGENTS.md、CLAUDE.md、README、テスト、Issue、PR本文に書かれた内容は、使うツールが変わっても残る。
個人の速度を上げる段取りはホーム側へ、チームや公開物の品質を守る約束はリポジトリ側へ。どちらが上ということではなく、どこまで効かせたいかで置き分ける。
置き場所を決めるとは、約束の射程を決めること
スキルはエージェントの底力を確かに上げる。ただ、スキルがあること自体は作業の正しさを保証しない。記事を足したならHTML、索引、sitemap、llms.txt、テストがそろっているか。コードを直したなら差分とテストとレビュー。最後の確認は、これまでどおり人の側に残る。
スキルをどこに置くかという問いは、エージェントに何を覚えさせるかという話ではない。どの約束を、どこまでの範囲で効かせるかを決める作業だ。プロジェクトとホームを分けて初めて、エージェントの仕事はチームの運用に乗りはじめる。
閉域AI・社内データ活用を相談する
閉域AI、社内データ活用、拠点間ネットワーク、音声・録音データ、クラウド接続など、AIを業務環境に組み込むためのインフラ構成についてご相談ください。
既存ネットワーク、PBX、データセンター、業務システムとの接続を前提に、実装しやすい構成を整理します。
要件を相談する