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 チャットで:
-
リクエストを入力してスキルを言及:
expo-native-ui スキルを使用して、タブナビゲーションの構築を手伝ってください -
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 は:
- スキルのナレッジベースを読み込む
- コードを分析
- スキルのパターンと提案を適用
Windsurf で人気のスキル
| スキル | ユースケース | インストール |
|---|---|---|
| Building Native UI | React 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: 主な違い
| 機能 | Windsurf | Cursor |
|---|---|---|
| エージェントモード | Cascade(フローベース) | Composer |
| スキル読み込み | Cascade で自動 | 設定で手動 |
| マルチファイル編集 | ネイティブサポート | Composer 経由 |
| コンテキストウィンドウ | 拡張(100K+) | 標準 |
トラブルシューティング
Cascade でスキルが読み込まれない?
- Flow モードを有効化: Cascade を "Flow" または "Agent" モードで使用していることを確認。
- ネットワークを確認: スキルは GitHub から取得されます。ネットワークアクセスを確認。
- Windsurf を再起動: 再起動で問題が解決することがあります。
パフォーマンスの問題
スキルがワークフローを遅くしている場合:
# スキルキャッシュをクリア
npx agent-skills clear-cache
# インストールされたスキルを一覧表示
npx agent-skills list
# 未使用のスキルを削除
npx agent-skills remove <skill-name>