WindsurfでAIスキルを活用する方法 — .windsurf/rules設定ガイド
2026年2月16日
WindsurfでAIスキルを活用する方法
Windsurf（旧Codeium）はAIファーストのコードエディタです。.windsurf/rules/ ディレクトリにルールファイルを配置することで、Cascade（AIエージェント）の動作をカスタマイズできます。
対応ファイル形式
| 項目 | 内容 |
|---|---|
| 推奨形式 | .windsurf/rules/*.md（Wave 8 / v1.8.2以降） |
| レガシー形式 | .windsurfrules（動作するが非推奨） |
| グローバル | ~/.codeium/windsurf/memories/global_rules.md |
| エンタープライズ | システムレベルルール（MDMデプロイ対応） |
| 文字数制限 | グローバル6,000文字 + ワークスペース合計12,000文字 |
| 対応状況 | ネイティブ対応（SKILL.md形式は非対応。内容をルールファイルにコピーして使用） |
注意: WindsurfはSKILL.mdファイルを直接読み込みません。AgentSkills.tokyoからダウンロードした内容を .windsurf/rules/ のMarkdownファイルとして保存してください。
ルールの適用モード
Windsurfには4つの適用モードがあります:
| モード | 説明 |
|---|---|
| Always On | 常にCascadeに適用 |
| Model Decision | AIが関連性を判断して自動適用 |
| Glob | ファイルパターンに一致する場合に適用 |
| Manual | @ルール名 で手動適用 |
設定方法
方法1: .windsurf/rules/ ディレクトリ（推奨）
bash
mkdir -p .windsurf/rules
# AgentSkills.tokyoからスキル内容をコピーして保存.windsurf/
rules/
nextjs-guide.md
typescript-rules.md
testing-patterns.md方法2: .windsurfrules ファイル（レガシー）
bash
curl -sL "https://agentskills.tokyo/api/skills/<slug>/download" > .windsurfrules方法3: グローバルルール
Settings > AI > Global Rules から設定、または直接編集:
~/.codeium/windsurf/memories/global_rules.mdおすすめスキル
- Next.js App Router開発ガイド — Webアプリ開発
- SwiftUI iOS アプリ開発 — iOSアプリ開発
- Vue.js 3 Composition API — Vue.js開発
関連記事
全ツールの比較は AIスキル対応ツール完全比較ガイド をご覧ください。