Windsurf 統合ガイド

Windsurf AI で Agent Skills を使用するためのステップバイステップガイド。

Windsurf AI 統合

Codeium の Windsurf は、Agent Skills 標準をサポートする強力な AI ネイティブ IDE です。このガイドでは、Windsurf でスキルを設定して使用する方法を説明します。

要件

  • Windsurf IDE がインストールされていること
  • Node.js 18+ と npm/pnpm

インストール方法

方法 1: CLI インストール

グローバル CLI を使用してスキルをインストール:

npx agent-skills install expo/skills/building-native-ui

スキルは Windsurf ワークスペースで自動的に利用可能になります。

方法 2: Cascade(エージェントモード)

Windsurf の Cascade 機能は、スキルマニフェストを直接使用できます。Cascade チャットで:

  1. リクエストを入力してスキルを言及:

    expo-native-ui スキルを使用して、タブナビゲーションの構築を手伝ってください
  2. Cascade が自動的にスキルコンテキストを取得して適用します。

方法 3: プロジェクトレベルの設定

プロジェクトの .windsurf/skills.json にスキルを追加:

{
  "skills": [
    "vercel-labs/agent-skills/vercel-react-best-practices",
    "expo/skills/building-native-ui"
  ]
}

Windsurf はプロジェクトを開くとこれらのスキルを読み込みます。

Cascade でスキルを使用

Windsurf の Cascade(AI エージェント)モードは複雑なタスクに最適です:

@cascade react-best-practices スキルを使用して、コンポーネントを Vercel 規約に従ってリファクタリング

Cascade は:

  1. スキルのナレッジベースを読み込む
  2. コードを分析
  3. スキルのパターンと提案を適用

Windsurf で人気のスキル

スキルユースケースインストール
Building Native UIReact Native / Expo 開発expo/skills/building-native-ui
Expo Deploymentアプリストアデプロイメントexpo/skills/expo-deployment
Monorepo Best Practices大規模コードベース管理jaredpalmer/skills/monorepo-best-practices
Better Auth認証実装better-auth/skills/better-auth-best-practices

Windsurf vs Cursor: 主な違い

機能WindsurfCursor
エージェントモードCascade(フローベース)Composer
スキル読み込みCascade で自動設定で手動
マルチファイル編集ネイティブサポートComposer 経由
コンテキストウィンドウ拡張(100K+)標準

トラブルシューティング

Cascade でスキルが読み込まれない?

  1. Flow モードを有効化: Cascade を "Flow" または "Agent" モードで使用していることを確認。
  2. ネットワークを確認: スキルは GitHub から取得されます。ネットワークアクセスを確認。
  3. Windsurf を再起動: 再起動で問題が解決することがあります。

パフォーマンスの問題

スキルがワークフローを遅くしている場合:

# スキルキャッシュをクリア
npx agent-skills clear-cache

# インストールされたスキルを一覧表示
npx agent-skills list

# 未使用のスキルを削除
npx agent-skills remove <skill-name>

次のステップ