🔄

ペルソナからスキル・エージェントへ：AIコーディング運用の標準化を決めた理由

に公開
AI
Cursor
Claude
mdc
Skills
tech

はじめに：独自ペルソナ運用の背景

2024年から約1年間、AIコーディングツール（Cursor等）を活用する際に「ペルソナ」という独自の運用体系を構築してきました。

ペルソナとは、AIに特定の役割を担わせるためのルールセットです。たとえば「Coder」ペルソナを呼び出せば実装に特化した振る舞いに、「Designer」ペルソナなら UI/UX 設計に特化した振る舞いになります。

これはこれでたのしかった。メンションして擬似的に反応してくれる感じとか。

構築したペルソナ一覧（18種類）

カテゴリ ペルソナ名 用途
コア Coder, Designer, Strategist, Architect, Analyst, QA 日常的な開発タスク
専門 Performance, Accessibility, Security, Legal, iOS, Backend, DevOps, Growth, Localization, Writer, PM 専門領域対応

呼び出し方

@coder.mdc → 実装・デバッグ・リファクタリング
@designer.mdc → UI/UX設計・HIG準拠
@strategist.mdc → PRD作成・KPI設計・MVP定義

各ペルソナは .mdc ファイル（エントリーポイント）と詳細な .md ファイル（本体）で構成され、依存関係・キーワード・適用範囲を明記してきました。

この仕組みにより、文脈に応じた高精度な回答を得られる一方で、メンテナンスコストが高いという課題もありました。

なぜ標準化を決めたのか？

トリガー1: Agent Skills の公式リリース

2025年に入り、主要なAI企業がスキルのフォーマットを標準化し始めました。

  • OpenAI Codex: Skillsリポジトリを公開。system/curated/experimental の3階層で整理
  • Anthropic Claude: 公式Skillsリポジトリを公開。awesome-claude-skillsでコミュニティ連携も整備

参考リンク:

トリガー2: エージェント時代の到来

Cursor、Windsurf、GitHub Copilotなど各社がエージェントモードを強化しています。

従来: 「ファイルを渡してタスクを依頼する」
現在: 「目標を渡してエージェントに任せる」

ツール間の相互運用性が重要になり、独自フォーマットでは連携が困難になってきました。

トリガー3: 独自運用のメンテナンスコスト

  • 新機能（MCP連携、Figma統合等）への追従が遅れる
  • 他者との共有・再利用が困難
  • ペルソナ間の重複や矛盾が発生しやすい

ペルソナとスキルの違い

観点 ペルソナ（独自） スキル（標準）
粒度 ロール単位（Designer, Coder...） タスク単位（implement-design, code-review...）
構成 .mdc + .md の2ファイル構成 単一ファイル or ディレクトリ
呼び出し @persona.mdc で明示的に切り替え コンテキストに応じて自動適用
依存管理 手動で依存関係を記述 メタデータで自動解決
共有性 リポジトリをフォークする必要 プラグイン的に追加可能
読み込み 常に全文読み込み 必要な部分だけ遅延読み込み

具体例で比較

ペルソナ方式（Before）
@coder.mdc を呼び出し
→ coder.mdc がエントリーポイント
→ personas/coder.md を読み込み（800行以上）
→ 関連ルールを手動参照

スキル方式（After）
実装タスクを依頼
→ skills-index.md からキーワードマッチ
→ 必要なスキルのみ遅延読み込み
→ 依存スキルは自動解決

移行計画

Phase 1: スキルインデックスの整備 ✅（完了）

base/skills-index.md を作成し、全スキルを以下の形式で索引化しました：

  • monorepo-architecture (base/40-monorepo-architecture.md)
    • 適用範囲: Swift/iOS, TypeScript/Web, Flutter
    • キーワード: monorepo, clean-architecture, package-structure
    • 依存: base/42-dependency-management.md, base/50-concurrency.md
    • 優先度: Highこれにより、AIエージェントは必要なスキルだけを効率的に読み込めるようになります。

Phase 2: ペルソナ → スキル変換（進行中）

変換前 変換後
@coder.mdc skills/implementation/, skills/refactoring/, skills/debugging/
@designer.mdc skills/ui-design/, skills/design-system/
@strategist.mdc skills/product-strategy/, skills/prd-creation/

1つの大きなペルソナを、タスク単位の小さなスキルに分解します。

Phase 3: エージェントルールの整備（予定）

  • AGENTS.md をリポジトリルートに配置（Codex標準）
  • Cursor Rulesとの互換性を維持
  • MCP統合対応

残すもの・変えるもの

残すもの ✅

  • ユビキタス言語辞書 - ドメイン知識の中核
  • デザインシステム - UI一貫性の担保
  • テンプレート群 - 成果物の品質標準
  • ワークフロー定義 - タスク駆動の原則

これらはペルソナに依存しない普遍的な資産なので、スキル移行後も継続して活用します。

変えるもの 🔄

Before After
ペルソナファイル（18個） スキルファイル群（タスク単位で分解）
.mdc ラッパー メタデータ付きスキル定義
暗黙の依存関係 明示的なスキル依存グラフ
手動の切り替え コンテキストベースの自動適用

期待する効果

指標 Before After（期待値）
ルール更新頻度 月1-2回 週1回以上
新ツール対応速度 1-2週間 即日〜3日
他者への共有容易性 フォーク必須 スキル単位でコピー可
コンテキスト効率 常に全文読み込み 必要部分のみ

特に他者への共有が容易になることが大きなメリットです。「このスキルだけ使いたい」というケースに対応できるようになります。

まとめ

独自の「ペルソナシステム」は、当時のAIツールの制約を解決するためのソリューションでした。

  • コンテキスト管理の難しさ → ペルソナごとに必要な情報を集約
  • ロール切り替えの手間 → @persona.mdc で一発切り替え

しかし2025年、Skills という標準フォーマットが整備され、各AIツールもエージェントモードを本格化させています。

この流れに乗ることで得られるメリット：

  1. 相互運用性: Cursor、Codex、Claude Desktop間でスキルを共有
  2. コミュニティの恩恵: awesome-claude-skillsなどのコミュニティ資産を活用
  3. メンテナンス負荷軽減: 標準フォーマットに準拠することで更新コスト削減

参考リンク

公式ドキュメント

リポジトリ

講演・記事

今後の予定

移行の進捗は随時アップデートしていく予定です。特に以下について別記事で深掘りする予定：

  • ペルソナからスキルへの具体的な変換手順
  • skills-index.md の設計思想
  • MCP連携の実装例
  • Figma → コード生成のワークフロー

興味があればフォローしていただけると嬉しいです 🙏

Discussion