スキルセット

モバイルプロジェクトでは、smartlime と Expo の知識を、規約ファイルとスキルセットという形であらかじめプロジェクトに組み込み、エージェントに参照させます。

smartlime は iAP と連携するための SDK で、正しく使うには iAP の認証や API に関する固有の知識が必要です。また、Expo は SDK のバージョンごとに API が変わるため、エージェントが記憶している書き方が古くなっていることがあります。スキルセットは、エージェントがプロジェクトの SDK に合った正しい作法で実装できるようにするためのものです。

スキルセットの構成

選択したエージェントに応じて、次のファイルが配備されます。

ファイル／ディレクトリ	Claude Code	Codex	内容
`AGENTS.md`	○	○	規約ファイル。プロジェクトの概要、スキルの使い分け、共通のルール
`CLAUDE.md`	○		`AGENTS.md` を読み込む指定
`.claude/skills/`	○		smartlime のスキルセット
`.claude/settings.json`	○		Expo 公式の Claude Code プラグインを有効にする設定
`.agents/skills/`		○	smartlime のスキルセットと、Expo 公式 skills（導入を選んだ場合）
`.codex/config.toml`		○	Expo MCP サーバの設定

規約ファイル（AGENTS.md）

AGENTS.md には、エージェントが常に守るべき事項がまとめられています。主な内容は次のとおりです。

プロジェクトの概要：Expo SDK と連携先の iAP のバージョン、smartlime の各パッケージの役割、iAP 側の前提
スキルの使い分け：作業の種類ごとに使う smartlime のスキル。Expo そのものの作業には Expo 公式のスキルを使うこと
共通のルール：iAP の API は useIMFetch で呼び出すこと、OAuth の接続情報をソースコードに直接書かないこと、作業の最後にテストを実行すること
Expo の基本：Expo の API を記憶で書かずに、使っている SDK のバージョンのドキュメントで確認すること、パッケージの追加には npx expo install を使うこと、作業の完了前に lint と型チェックを実行すること、画面遷移には Expo Router を使うこと

「Expo の基本」の節は、create-expo が提供する AGENTS.md を日本語に翻訳したものです。

smartlime のスキルセット

smartlime のスキルセットには、smartlime 固有の機能の使い方と実装の手順がまとめられています。エージェントは依頼の内容に応じて、対応するスキルを参照します。

スキル	用途	起動キーワード例
`smartlime-setup`	smartlime の導入と iAP への接続設定。パッケージの追加、URL scheme とリダイレクト URI、接続情報の扱い、`Smartlime` の配置、iAP 側の OAuth クライアントの登録内容	smartlime を導入して、iAP と接続する設定
`smartlime-auth`	ログイン画面、ログアウト、ログイン状態による画面の切り替え、ログインユーザの情報	ログイン画面を作って、ログアウトを付けて
`smartlime-api`	iAP の REST API（IM-Workflow の REST API など）の呼び出しとエラーの扱い	IM-Workflow の案件一覧を取得して
`smartlime-webview`	iAP の画面をアプリ内に表示する	ワークフローの申請画面をアプリで開いて
`smartlime-search`	ユーザ・組織・役職・パブリックグループ・ロールの検索と選択	担当者を検索して選べるようにして
`smartlime-calendar`	iAP のカレンダー（稼働日・休日）の表示と日付の選択	申請基準日をカレンダーから選べるようにして
`smartlime-assistant`	IM-Copilot のアシスタントとのチャット	IM-Copilot のアシスタントと会話する画面を作って
`smartlime-testing`	smartlime を使うコードのテスト（Jest）	作成した画面のテストを書いて

Expo 公式のスキル

画面遷移や UI、ネイティブ機能、SDK のアップグレード、ビルドと配布といった Expo そのものの作業には、Expo が公開しているスキルを使います。

Claude Code：Expo 公式の Claude Code プラグインに含まれるスキルを使います。プラグインは .claude/settings.json の設定で有効になります。
Codex：プロジェクトの作成時に導入を選んだ場合、Expo 公式 skills が .agents/skills/ に導入されます。後から導入する場合や更新する場合は、Accel CLI が表示するコマンドや npx skills update を使います。

Expo MCP サーバについて

Expo のアカウントでサインインすると、Expo が提供する MCP サーバ（https://mcp.expo.dev/mcp）をエージェントから使えます。サインインは、Claude Code では /mcp、Codex では codex mcp login expo で行います。