メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

Memories は、会話間で前提情報を共有・保持するためのシステムです。 Devin Desktop には、これを実現する仕組みが 2 つあります。Cascade が自動生成する Memories と、ユーザーがグローバル、ワークスペース、またはシステム レベルで手動定義する ルール です。

Memories、ルール、ワークフロー、それともスキル?

Devin Desktop では、Cascade をカスタマイズする方法がいくつかあります。自分に合ったものを、この表で選んでください。
FeatureWhat it doesHow it’s activatedWhen to use it
ルールCascade にどう振る舞うかを伝える (例: 「npm ではなく bun を使う」)always_onglobmodel_decision、または manual (以下を参照)コーディング規約、スタイルガイド、プロジェクト上の制約
AGENTS.md設定不要で使える、場所ごとに適用されるルール自動 — ルート = 常時適用、サブディレクトリ = globfrontmatter なしで、ディレクトリごとの規約を適用したい場合
ワークフロー繰り返し利用する複数ステップのタスク向けプロンプトテンプレート/[workflow-name] スラッシュコマンドによる手動のみデプロイ、PR レビュー、リリースチェックリスト
スキル補助ファイル (スクリプト、テンプレート) を含む複数ステップの手順モデルが動的に呼び出す、または @mentionCascade が参照ファイルを必要とする複雑なタスク — 特におすすめ
Memories会話中に Cascade が自動生成する前提情報関連する場合に自動で取得Cascade に単発の情報を覚えさせたい場合。長く使う知識には、ルールまたは AGENTS.md を優先してください
推奨: Cascade に確実に再利用してほしい知識は、自動生成された Memories に頼るのではなく、ルールとして記述するか、repo 内の AGENTS.md に追加してください。ルールはバージョン管理でき、チームで共有でき、いつ有効にするかを明示的に制御できます。

Memories の管理方法

Memories とルールは、Cascade の右上にあるスライダーメニューの Customizations アイコンをクリックするか、右下の「Windsurf - 設定」から、いつでもアクセスして設定できます。既存の Memories を編集するには、その Memories をクリックしてから Edit ボタンをクリックするだけです。

Memories

会話中、Cascade は、記憶しておくと役立つ前提情報に出会うと、自動的に Memories を生成して保存できます。 また、Cascade にいつでも Memories を作成するよう依頼できます。"create a memory of ..." とプロンプトするだけです。 Cascade が自動生成した Memories は、作成されたワークスペースに関連付けられ、~/.codeium/windsurf/memories/ にローカルで保存されます。Cascade は、それらが関連していると判断したときに取得します。あるワークスペースで生成された Memories は別のワークスペースでは利用できず、リポジトリにコミットされることもありません。
自動生成された Memories の作成と利用でクレジットが消費されることはありません。
自動生成された Memories は、ローカルのマシン上にのみ保存されます。Cascade に何かを継続的に記憶させてチームと共有したい場合は、代わりに .devin/rules/ (またはレガシーな .windsurf/rules/) の ルール またはリポジトリの AGENTS.md に書き込むよう Cascade に依頼してください。

ルール

ユーザーは、Cascade が従う独自のルールを明示的に定義できます。 ルールはグローバル、ワークスペース、またはシステムレベルで定義でき、AGENTS.md ファイルから検出されることもあります。
スコープ場所注記
グローバル~/.codeium/windsurf/memories/global_rules.md単一のファイルで、すべてのワークスペースに適用されます。常時適用。6,000 文字まで。
ワークスペース.devin/rules/*.md (推奨) または .windsurf/rules/*.md (フォールバック)ルールごとに 1 つのファイルがあり、それぞれに独自の有効化モードがあります。各ファイルは 12,000 文字まで。ワークスペースルートにあるレガシーな単一ファイル .windsurfrules も引き続き読み込まれます。
AGENTS.mdワークスペース内の任意のディレクトリ同じルールエンジンで処理されます。ルートレベル = 常時適用、サブディレクトリ = そのディレクトリに対する auto-glob。
System (Enterprise) OS 固有 (例: /etc/devin/rules/、レガシーな /etc/windsurf/rules/)IT によって配備され、エンドユーザーは読み取り専用です。

ルールの検出

Devin Desktop は、柔軟に管理できるよう、複数の場所からルールを自動的に検出します。.devin/ ディレクトリが推奨される場所であり優先され、.windsurf/ は後方互換性のためのフォールバックとして維持されています:
  • 現在のワークスペースとそのサブディレクトリ: 現在のワークスペースとそのサブディレクトリ内にある、すべての .devin/rules (およびレガシーな .windsurf/rules) ディレクトリ
  • Git リポジトリ構造: Git リポジトリでは、Devin Desktop は親ディレクトリ内のルールを見つけるために、git root ディレクトリまでさかのぼって検索します
  • 複数ワークスペースのサポート: 同じワークスペースで複数のフォルダが開かれている場合、ルールは重複を排除したうえで、最短の相対パスで表示されます

ルールの保存場所

ルールは、以下のいずれかの場所に保存できます (.devin/ が推奨され、.windsurf/ より優先されます) 。
  • 現在のワークスペースディレクトリ内の .devin/rules または .windsurf/rules
  • ワークスペース内の任意のサブディレクトリ内の .devin/rules または .windsurf/rules
  • 親ディレクトリ内の .devin/rules または .windsurf/rules (git リポジトリの場合は git ルートまで)
新しいルールを作成すると、保存先は必ずしも git ルートではなく、現在のワークスペースの .devin/rules ディレクトリになります。 ルールの利用を開始するには、まず Cascade の右上にあるスライダーメニューで Customizations アイコンをクリックし、Rules パネルに移動します。ここで、+ Global または + Workspace ボタンをクリックすると、それぞれグローバルレベルまたはワークスペースレベルの新しいルールを作成できます。
使い始める際の参考として、Devin Desktop チームが厳選したルールテンプレートの例を https://windsurf.com/editor/directory で確認できます。
ワークスペースのルールファイルは、1 ファイルあたり 12,000 文字までです。グローバルルールファイルは 6,000 文字までです。

有効化モード

各ワークスペース ルールは、フロントマター内のtriggerフィールドで有効化モードを指定します。これにより、ルールの内容がいつCascadeに渡されるか、また前提情報ウィンドウをどれだけ消費するかが決まります。
モードtrigger: の値Cascadeに反映される方法前提情報コスト
常時有効always_onルールの全文が、すべてのメッセージでシステムプロンプトに含まれます。すべてのメッセージ
モデル判断model_decisionシステムプロンプトにはdescriptionのみが表示されます。Cascadeは、その説明に関連性があると判断した場合にのみ、ルールファイル全体を読みます。descriptionは常時、全文は必要時のみ
GlobglobCascadeがglobsパターンにマッチするファイル (例: *.jssrc/**/*.ts) を読んだり編集したりしたときに、ルールが適用されます。マッチしたファイルに触れたときのみ
手動manualルールはシステムプロンプトに含まれません。Cascadeの入力欄で@rule-nameと入力して有効化します。@メンション時のみ
グローバルルールファイル (global_rules.md) とルートレベルのAGENTS.mdファイルではフロントマターを利用しません。これらは常に有効です。
フロントマター付きのワークスペース ルールの例:
---
trigger: glob
globs: **/*.test.ts
---

All test files must use `describe`/`it` blocks and mock external API calls.

ベストプラクティス

Cascade がルールに効果的に従えるようにするために、次のベストプラクティスに従ってください。
  • ルールはシンプルで簡潔、かつ具体的にしてください。長すぎたり曖昧だったりすると、Cascade が混乱する可能性があります。
  • 一般的なルール (例:“良いコードを書く”) を追加する必要はありません。こうした内容は、すでに Cascade のトレーニングデータに組み込まれています。
  • 箇条書き、番号付きリスト、Markdown を使ってルールを記述してください。長い段落で書くよりも、Cascade が従いやすくなります。例えば:
# Coding Guidelines 
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
  • XMLタグは、ルールを伝えたり、類似したルールをまとめたりするのに効果的です。たとえば:
<coding_guidelines>
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
</coding_guidelines>

システムレベルのルール (Enterprise)

Enterprise組織では、すべてのワークスペースに全体的に適用され、管理者権限を持たないエンドユーザーは変更できないシステムレベルのルールを導入できます。これは、組織全体のコーディング標準、セキュリティポリシー、コンプライアンス要件を徹底するのに最適です。 システムレベルのルールは、OSごとのディレクトリから読み込まれます。Devin ディレクトリが優先されて優先順位も高く、レガシーの Windsurf ディレクトリはフォールバックとして維持されます: macOS:
/Library/Application Support/Devin/rules/*.md
/Library/Application Support/Windsurf/rules/*.md   # レガシーフォールバック
Linux/WSL:
/etc/devin/rules/*.md
/etc/windsurf/rules/*.md   # レガシーフォールバック
Windows:
C:\ProgramData\Devin\rules\*.md
C:\ProgramData\Windsurf\rules\*.md   # レガシーフォールバック
お使いのオペレーティングシステムに対応する適切なディレクトリに、ルールファイル (.md ファイル) を配置してください。システムは、これらのディレクトリ内のすべての .md ファイルを自動的に読み込みます。

システムルールの仕組み

システムレベルのルールは、ユーザー定義のルールを上書きすることなく、Cascade に追加の前提情報を提供するため、ワークスペースルールおよびグローバルルールと統合されます。これにより、組織は標準的な基準を定めながら、チームごとにプロジェクト固有のカスタマイズを追加できます。 Devin Desktop UI では、システムレベルのルールは “System” ラベル付きで表示され、エンドユーザーが削除することはできません。
重要: システムレベルのルールは、IT チームまたはセキュリティチームが管理してください。デプロイ、更新、コンプライアンス対応は、組織のポリシーに従って社内チームが確実に行うようにしてください。その際は、Mobile Device Management (MDM) や Configuration Management などの標準的なツールやワークフローを利用できます。