Documentation Index
Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
Use this file to discover all available pages before exploring further.
Memories は、会話間で前提情報を共有・保持するためのシステムです。
Devin Desktop には、これを実現する仕組みが 2 つあります。Cascade が自動生成する Memories と、ユーザーがグローバル、ワークスペース、またはシステム レベルで手動定義する ルール です。
Memories、ルール、ワークフロー、それともスキル?
| Feature | What it does | How it’s activated | When to use it |
|---|---|---|---|
| ルール | Cascade にどう振る舞うかを伝える (例: 「npm ではなく bun を使う」) | always_on、glob、model_decision、または manual (以下を参照) | コーディング規約、スタイルガイド、プロジェクト上の制約 |
| AGENTS.md | 設定不要で使える、場所ごとに適用されるルール | 自動 — ルート = 常時適用、サブディレクトリ = glob | frontmatter なしで、ディレクトリごとの規約を適用したい場合 |
| ワークフロー | 繰り返し利用する複数ステップのタスク向けプロンプトテンプレート | /[workflow-name] スラッシュコマンドによる手動のみ | デプロイ、PR レビュー、リリースチェックリスト |
| スキル | 補助ファイル (スクリプト、テンプレート) を含む複数ステップの手順 | モデルが動的に呼び出す、または @mention | Cascade が参照ファイルを必要とする複雑なタスク — 特におすすめ |
| Memories | 会話中に Cascade が自動生成する前提情報 | 関連する場合に自動で取得 | Cascade に単発の情報を覚えさせたい場合。長く使う知識には、ルールまたは AGENTS.md を優先してください |
Memories の管理方法
Customizations アイコンをクリックするか、右下の「Windsurf - 設定」から、いつでもアクセスして設定できます。既存の Memories を編集するには、その Memories をクリックしてから Edit ボタンをクリックするだけです。
Memories
"create a memory of ..." とプロンプトするだけです。
Cascade が自動生成した Memories は、作成されたワークスペースに関連付けられ、~/.codeium/windsurf/memories/ にローカルで保存されます。Cascade は、それらが関連していると判断したときに取得します。あるワークスペースで生成された Memories は別のワークスペースでは利用できず、リポジトリにコミットされることもありません。
自動生成された Memories は、ローカルのマシン上にのみ保存されます。Cascade に何かを継続的に記憶させてチームと共有したい場合は、代わりに
.windsurf/rules/ の ルール またはリポジトリの AGENTS.md に書き込むよう Cascade に依頼してください。ルール
| スコープ | 場所 | 注記 |
|---|---|---|
| グローバル | ~/.codeium/windsurf/memories/global_rules.md | 単一のファイルで、すべてのワークスペースに適用されます。常時適用。6,000 文字まで。 |
| ワークスペース | .windsurf/rules/*.md | ルールごとに 1 つのファイルがあり、それぞれに独自の有効化モードがあります。各ファイルは 12,000 文字まで。 |
| AGENTS.md | ワークスペース内の任意のディレクトリ | 同じルールエンジンで処理されます。ルートレベル = 常時適用、サブディレクトリ = そのディレクトリに対する auto-glob。 |
| システム (Enterprise) | OS 固有 (例: /etc/windsurf/rules/) | IT によって配備され、エンドユーザーは読み取り専用です。 |
ルールの検出
- 現在のワークスペースとそのサブディレクトリ: 現在のワークスペースとそのサブディレクトリ内にある、すべての
.windsurf/rulesディレクトリ - Git リポジトリ構造: Git リポジトリでは、Devin Desktop は親ディレクトリ内のルールを見つけるために、git root ディレクトリまでさかのぼって検索します
- 複数ワークスペースのサポート: 同じワークスペースで複数のフォルダが開かれている場合、ルールは重複を排除したうえで、最短の相対パスで表示されます
ルールの保存場所
- 現在のワークスペースディレクトリ内の
.windsurf/rules - ワークスペース内の任意のサブディレクトリ内の
.windsurf/rules - 親ディレクトリ内の
.windsurf/rules(git リポジトリの場合は git ルートまで)
.windsurf/rules ディレクトリになります。
ルールの利用を開始するには、まず Cascade の右上にあるスライダーメニューで Customizations アイコンをクリックし、Rules パネルに移動します。ここで、+ Global または + Workspace ボタンをクリックすると、それぞれグローバルレベルまたはワークスペースレベルの新しいルールを作成できます。
ワークスペースのルールファイルは、1 ファイルあたり 12,000 文字までです。グローバルルールファイルは 6,000 文字までです。
有効化モード
triggerフィールドで有効化モードを指定します。これにより、ルールの内容がいつCascadeに渡されるか、また前提情報ウィンドウをどれだけ消費するかが決まります。
| モード | trigger: の値 | Cascadeに反映される方法 | 前提情報コスト |
|---|---|---|---|
| 常時有効 | always_on | ルールの全文が、すべてのメッセージでシステムプロンプトに含まれます。 | すべてのメッセージ |
| モデル判断 | model_decision | システムプロンプトにはdescriptionのみが表示されます。Cascadeは、その説明に関連性があると判断した場合にのみ、ルールファイル全体を読みます。 | descriptionは常時、全文は必要時のみ |
| Glob | glob | Cascadeがglobsパターンにマッチするファイル (例: *.js、src/**/*.ts) を読んだり編集したりしたときに、ルールが適用されます。 | マッチしたファイルに触れたときのみ |
| 手動 | manual | ルールはシステムプロンプトに含まれません。Cascadeの入力欄で@rule-nameと入力して有効化します。 | @メンション時のみ |
グローバルルールファイル (
global_rules.md) とルートレベルのAGENTS.mdファイルではフロントマターを利用しません。これらは常に有効です。ベストプラクティス
- ルールはシンプルで簡潔、かつ具体的にしてください。長すぎたり曖昧だったりすると、Cascade が混乱する可能性があります。
- 一般的なルール (例:“良いコードを書く”) を追加する必要はありません。こうした内容は、すでに Cascade のトレーニングデータに組み込まれています。
- 箇条書き、番号付きリスト、Markdown を使ってルールを記述してください。長い段落で書くよりも、Cascade が従いやすくなります。例えば:
- XMLタグは、ルールを伝えたり、類似したルールをまとめたりするのに効果的です。たとえば:
システムレベルのルール (Enterprise)
.md ファイル) を配置してください。システムは、これらのディレクトリ内のすべての .md ファイルを自動的に読み込みます。
システムルールの仕組み
重要: システムレベルのルールは、IT チームまたはセキュリティチームが管理してください。デプロイ、更新、コンプライアンス対応は、組織のポリシーに従って社内チームが確実に行うようにしてください。その際は、Mobile Device Management (MDM) や Configuration Management などの標準的なツールやワークフローを利用できます。
