> ## 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.

# ワークフロー

> Markdown ファイルとして定義された再利用可能なワークフローで、Cascade の反復的なタスクを自動化します。PR レビュー、デプロイ、テスト、コード整形のワークフローを作成できます。

ワークフローを利用すると、サービスのデプロイや PR コメントへの対応など、反復的なタスクを Cascade に実行させるための一連のステップを定義できます。

これらのワークフローは Markdown ファイルとして保存されるため、ユーザーやチームは主要なプロセスを簡単に繰り返し実行できます。

保存すると、ワークフローは `/[name-of-workflow]` 形式のスラッシュコマンドで Cascade から呼び出せます。

<Note>
  ワークフローは **手動のみ** です。Cascade がワークフローを自動的に呼び出すことはありません。Cascade が手順を自動的に参照できるようにしたい場合は、代わりに [Skill](/ja/desktop/cascade/skills) を利用してください。
</Note>

<div id="how-it-works">
  ## 仕組み
</div>

ルールは一般に、プロンプトレベルで永続的かつ再利用可能な前提情報を与えることで、大規模言語モデルに指針を提供します。

ワークフローはこの考え方をさらに発展させたもので、軌跡レベルで構造化された一連のステップやプロンプトを与え、相互に関連する複数のタスクやアクションを通じてモデルを導きます。

<Frame>
  <img style={{ maxHeight: "400px" }} src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/use-workflow-pr.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=92b4125d6d17f2a25ffea890592331fc" width="718" height="510" data-path="desktop/assets/windsurf/cascade/use-workflow-pr.png" />
</Frame>

ワークフローを実行するには、ユーザーは Cascade で ` /[workflow-name]` コマンドを呼び出すだけです。

<Tip>ワークフロー内から別のワークフローを呼び出すこともできます！ <br /><br />たとえば、/workflow-1 には「Call /workflow-2」や「Call /workflow-3」といった指示を含めることができます。</Tip>

呼び出されると、Cascade はワークフローで定義された各ステップを順番に処理し、指定に応じてアクションを実行したり、応答を生成したりします。

<div id="how-to-create-a-workflow">
  ## ワークフロー の作成方法
</div>

ワークフロー を使い始めるには、Cascade の右上にあるスライダーメニューで `Customizations` アイコンをクリックし、`ワークフロー` パネルに移動します。ここで `+ ワークフロー` ボタンをクリックすると、新しい ワークフロー を作成できます。

ワークフロー は `.windsurf/workflows/` ディレクトリ内に markdown ファイルとして保存され、タイトル、説明、そして Cascade が従うための具体的な指示を含む一連のステップで構成されます。

<div id="workflow-discovery">
  ## ワークフローの検出
</div>

Devin Desktop は、ワークフローを柔軟に整理できるよう、複数の場所から自動的に検出します。

* **現在のワークスペースとそのサブディレクトリ**: 現在のワークスペースおよびそのサブディレクトリ内にある、すべての `.windsurf/workflows/` ディレクトリ
* **Git リポジトリ構造**: Git リポジトリでは、Devin Desktop は親ディレクトリ内のワークフローを見つけるために、Git ルートディレクトリまでさかのぼって検索します
* **複数ワークスペースのサポート**: 同じワークスペースで複数のフォルダを開いている場合、ワークフローは重複を排除したうえで、最短の相対パスで表示されます

<div id="workflow-storage-locations">
  ### ワークフローの保存場所
</div>

| Scope                                                    | Location                                    | Notes                                                                   |
| -------------------------------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------- |
| ワークスペース                                                  | `.windsurf/workflows/*.md`                  | 現在のワークスペース内、任意のサブディレクトリ、または `git root` までの任意の親ディレクトリ。リポジトリとともにコミットされます。 |
| グローバル                                                    | `~/.codeium/windsurf/global_workflows/*.md` | お使いのマシン上のすべてのワークスペースで利用できます。コミットされません。                                  |
| 組み込み                                                     | Devin Desktop によって管理                        | Devin Desktop に付属するテンプレート (例: `/plan`) 。                                |
| [システム (Enterprise) ](#system-level-workflows-enterprise) | OS 固有 (例: `/etc/windsurf/workflows/`)       | IT によって展開され、エンドユーザーは読み取り専用です。                                           |

UI から新しいワークフローを作成すると、必ずしも `git root` ではなく、現在のワークスペースの `.windsurf/workflows/` ディレクトリに保存されます。グローバルワークフローを作成するには、Workflows パネルの `+ Global` ボタンを利用するか、`~/.codeium/windsurf/global_workflows/` に直接ファイルを作成してください。

各ワークフローファイルは 12000 文字までです。

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/create-workflow.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=b0f3d54a0d24966384a91042468f72bf" data-path="desktop/assets/windsurf/cascade/create-workflow.mp4" />

<div id="generate-a-workflow-with-cascade">
  ### Cascade を使ってワークフローを生成する
</div>

Cascade にワークフローを生成してもらうこともできます。特に、特定の CLI ツールで一連の手順を実行するワークフローで効果を発揮します。

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/create-workflow-with-cascade.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=f14c9012ab0e92d631b808072c439f60" data-path="desktop/assets/windsurf/cascade/create-workflow-with-cascade.mp4" />

<div id="example-workflows">
  ## ワークフローの例
</div>

ワークフロー には、次のようなさまざまなユースケースがあります。

<Card title="/address-pr-comments">
  これは、PR コメントに対応するために私たちのチームが社内で使用しているワークフローです:

  ```
  1. PR ブランチをチェックアウトする: `gh pr checkout [id]`

  2. PR のコメントを取得する

   bash
   gh api --paginate repos/[owner]/[repo]/pulls/[id]/comments | jq '.[] | {user: .user.login, body, path, line, original_line, created_at, in_reply_to_id, pull_request_review_id, commit_id}'

  3. 各コメントについて、次の操作を行います。一度に対応するコメントは 1 件だけにしてください。
   a. 次の形式で出力する: "(index). [user] から [file]:[lines] へのコメント — [body]"
   b. ファイルと該当する行範囲を分析する。
   c. コメントの意味がわからない場合は、変更を加えないでください。代わりに、私に確認を求めるか、私自身が対応できるよう依頼してください。
   d. 変更できると判断した場合は、次のコメントに進む前に変更を加えてください。

  4. すべてのコメントを処理したら、実施した内容と、ユーザーの対応が必要なコメントを要約してください。
  ```
</Card>

<Card title="/git-workflows">
  定義済みの形式でコミットし、適切な CLI コマンドを使用して、標準化されたタイトルと説明を持つプルリクエストを作成します。
</Card>

<Card title="/dependency-management">
  設定ファイル (例: requirements.txt、package.json) に基づいて、プロジェクトの依存関係のインストールまたは更新を自動化します。
</Card>

<Card title="/code-formatting">
  コードスタイルを維持し、エラーを早期に検出するために、ファイル保存時またはコミット前に、コードフォーマッター (Prettier、Black など) とリンター (ESLint、Flake8 など) を自動的に実行します。
</Card>

<Card title="/run-tests-and-fix">
  コミット、マージ、またはデプロイの前にコード品質を確保するため、ユニットテストまたはエンドツーエンドテストを実行または追加し、エラーに自動で対処します。
</Card>

<Card title="/deployment">
  必要なデプロイ前チェックやデプロイ後の検証も含めて、さまざまな環境 (開発、ステージング環境、本番) へのアプリケーションのデプロイ手順を自動化します。
</Card>

<Card title="/security-scan">
  CI/CD パイプラインの一部として、または必要に応じて、コードベースに対するセキュリティ脆弱性スキャンを組み込み、トリガーします。
</Card>

<div id="system-level-workflows-enterprise">
  ## システムレベルのワークフロー (Enterprise)
</div>

Enterprise 組織では、すべてのワークスペースで共通して利用でき、管理者権限がないエンドユーザーは変更できないシステムレベルのワークフローをデプロイできます。これは、組織全体の開発プロセス、デプロイ手順、コンプライアンス ワークフローを徹底するのに適しています。

システムレベルのワークフローは、OS ごとのディレクトリから読み込まれます：

**macOS:**

```
/Library/Application Support/Windsurf/workflows/*.md
```

**Linux/WSL：**

```
/etc/windsurf/workflows/*.md
```

**Windows:**

```
C:\ProgramData\Windsurf\workflows\*.md
```

お使いのオペレーティングシステムに応じた適切なディレクトリに、ワークフローファイル (`.md` ファイル) を配置してください。システムは、これらのディレクトリ内にあるすべての `.md` ファイルを自動的に読み込みます。

<div id="workflow-precedence">
  ### ワークフローの優先順位
</div>

同じ名前のワークフローが複数のレベルで存在する場合、システムレベルのワークフローが最も高い優先順位となります。

1. **System** (最優先) - IT によって組織全体に展開されるワークフロー
2. **Workspace** - `.windsurf/workflows/` 内のプロジェクト固有のワークフロー
3. **Global** - `~/.codeium/windsurf/global_workflows/` 内のユーザー定義ワークフロー
4. **Built-in** - Devin Desktop によって提供されるデフォルトのワークフロー

つまり、組織が特定の名前のシステムレベルのワークフローを展開すると、同じ名前の Workspace、Global、Built-in のワークフローよりもそのワークフローが優先されます。

Devin Desktop UI では、システムレベルのワークフローは "System" ラベル付きで表示され、エンドユーザーは削除できません。

<Note>
  **重要**: システムレベルのワークフローは、IT チームまたはセキュリティチームが管理する必要があります。展開、更新、コンプライアンス対応は、組織のポリシーに従って社内チームが行うようにしてください。そのために、Mobile Device Management (MDM) や Configuration Management などの標準的なツールやワークフローを利用できます。
</Note>