> ## Documentation Index
> Fetch the complete documentation index at: https://cat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 工作流程

工作流程允许你定义一系列步骤来指导 Cline 完成重复性任务集，比如部署服务或提交 PR。

要调用工作流程，在聊天中输入 `/[workflow-name.md]`。

## 如何创建和使用工作流程

工作流程与 [Cline 规则](https://cat.mintlify.site/features/cline-rules.md)一起存在。创建工作流程很简单：

![Cline 中的工作流程选项卡](https://storage.googleapis.com/cline_public_images/docs/assets/workflows.png)

1. 创建一个 markdown 文件，包含 Cline 应该采取的步骤的清晰指令
2. 在工作流程目录中以 `.md` 扩展名保存
3. 要触发工作流程，只需输入 `/` 后跟工作流程文件名
4. 在提示时提供任何必需的参数

真正的力量来自你如何构建工作流程文件。你可以：

* 利用 Cline 的[内置工具](https://cat.mintlify.site/exploring-clines-tools/cline-tools-guide.md)，如 `ask_followup_question`、`read_file`、`search_files` 和 `new_task`
* 使用你已经安装的命令行工具，如 `gh` 或 `docker`
* 引用外部 [MCP 工具调用](https://cat.mintlify.site/mcp/mcp-overview.md)，如 Slack 或 Whatsapp
* 按特定顺序链接多个动作

## 真实世界示例

我创建了一个 PR 审查工作流程，已经为我节省了大量时间。

````markdown pr-review.md 示例
你可以访问 `gh` 终端命令。我已经为你认证了。请审查我要求你审查的 PR。你已经在 `cline` 仓库中。

# GitHub PR 审查过程 - 详细步骤序列

## 1. 收集 PR 信息

1. 获取 PR 标题、描述和评论：
    ```bash
    gh pr view <PR-number> --json title,body,comments
````

2. 获取 PR 的完整差异：
   ```bash
   gh pr diff <PR-number>
   ```

## 2. 理解上下文

1. 识别 PR 中修改了哪些文件：
   ```bash
   gh pr view <PR-number> --json files
   ```

2. 检查主分支中的原始文件以理解上下文：
   ```xml
   <read_file>
   <path>path/to/file</path>
   </read_file>
   ```

## 3. 分析更改

对于每个修改的文件，理解：

* 更改了什么
* 为什么更改（基于 PR 描述）
* 它如何影响代码库
* 潜在的副作用

寻找：

* 代码质量问题
* 潜在错误
* 性能影响
* 安全问题
* 测试覆盖率

## 4. 征求用户确认

在做决定之前，询问用户是否应该批准 PR，提供你的评估和理由：

```xml
<ask_followup_question>
<question>基于我对 PR #<PR-number> 的审查，我建议[批准/请求更改]。理由如下：

[关于 PR 质量、实现和任何关注点的详细理由]

你希望我继续这个建议吗？</question>
<options>["是，批准 PR", "是，请求更改", "不，我想进一步讨论"]</options>
</ask_followup_question>
```

## 5. 做出决定

如果符合质量标准则批准 PR：

```bash
gh pr review <PR-number> --approve --body "你的批准消息"
```

如果需要改进则请求更改：

```bash
gh pr review <PR-number> --request-changes --body "你的反馈消息"
```

```

当我收到新的 PR 审查时，我过去手动收集上下文：检查 PR 描述、检查差异、查看周围文件，最后形成意见。现在我只需：

1. 在聊天中输入 `/pr-review.md`
2. 粘贴 PR 编号
3. 让 Cline 处理其他一切

我的工作流程使用 `gh` 命令行工具和 Cline 的内置 `ask_followup_question` 来：

-   拉取 PR 描述和评论
-   检查差异
-   检查周围文件以获取上下文
-   分析潜在问题
-   如果一切看起来不错，询问我是否可以批准，并提供批准理由
-   如果我说"是"，Cline 使用 `gh` 命令自动批准 PR

这将我的 PR 审查过程从手动的多步操作转变为单个命令，为我提供做出明智决定所需的一切。

> 这只是工作流程文件的一个示例。你可以在我们的[提示仓库](https://github.com/cline/prompts)中找到更多灵感。

## 构建你自己的工作流程

工作流程的美妙之处在于它们完全可以根据你的需要自定义。你可以为各种重复性任务创建工作流程：

-   对于发布，你可以有一个工作流程来获取所有合并的 PR，构建变更日志，并处理版本升级。
-   设置新项目非常适合工作流程。只需运行一个命令来创建文件夹结构、安装依赖项和设置配置。
-   需要创建报告？创建一个工作流程，从不同来源获取统计数据，并按你喜欢的方式格式化。你甚至可以使用图表库可视化它们，然后使用 [slidev](https://sli.dev/) 等库制作演示文稿。
-   你甚至可以使用工作流程在提交 PR 后使用 Slack 或 Whatsapp 等 MCP 服务器向团队起草消息。

工作流程的真正潜力来自发现那些烦人的重复性任务。

如果你可以将某事描述为"首先我做 X，然后 Y，然后 Z" - 那就是完美的工作流程候选。

从一些困扰你的小事开始，将其变成工作流程，并不断完善。你会惊讶于有多少日常工作可以通过这种方式自动化。
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.