# 沉淀 · 把重复三次的事存成一键 · Warp · 一台终端形状的元工具

**作者** Aklman · **章节** 06 / 12 · **首发** 2026.08 · **语言** 中文为主, 中英双语
**原文** https://library.aklman.com/books/warp/06-drive
**全书 markdown** https://library.aklman.com/books/warp/llms.md
**上一章** https://library.aklman.com/books/warp/05-beyond-code/llms.md
**下一章** https://library.aklman.com/books/warp/07-mcp/llms.md

> 本章来自 Aklman · Library, 完整免费阅读。允许 AI 摘读、引用、问答; 转载请保留作者署名与原文链接 (CC BY-NC-ND 4.0, https://library.aklman.com/license)。

---

> 跑通一次是运气,跑通三次就该沉淀。这章把一件本周重复了三次的操作从头固化:参数化成 Workflow、长流程写成 Notebook、给 agent 存一条 Prompt —— 再谈存了反而是负担的那类,以及 Drive 的月度体检。

跑通一次是运气,跑通三次是信号。这周你第三次敲同一条看日志的命令时,该意识到的不是「我记性真好」,是「这活该固化了」。Warp Drive 是跑通过程的归宿:命令存成 Workflow、长流程写成 Notebook、给 agent 的任务存成 Prompt、环境差异抽成变量。这章用一条主线走完整个固化动作,再谈什么存了反而是负担,以及 Drive 的月度体检。

### I · 主线:把第三次看日志固化成一键

场景:staging 的 api 服务这周第三次出问题,你第三次敲 `docker compose -f docker-compose.staging.yml logs --tail 200 api | grep -Ei "error|timeout"`。命令你快背下来了 —— 这正是最该沉淀的时刻:足够常用,值得存;还没熟到烦,存的动作成本最低。[^1]

- **认出信号:第三次,停手,别敲第四次**:
 一次是探索,两次是巧合,三次是模式。Explore 阶段的脏命令不值得存;但当一条命令第三次出现,它的形状已经稳定 —— 变的只有环境名、服务名、行数。变什么,待会儿就参数化什么。

- **块右键 Save as Workflow,参数化**:
 在刚跑通的那个 block 上右键,选 `Save as Workflow`(agent 跑出来的结果同样有这入口)。把 `staging` 改成 `{{env}}`、`api` 改成 `{{service}}`、`200` 改成 `{{lines}}`,各给默认值;名称和描述可以让 AI Autofill 起草(每次消耗 1 credit),自己再过一遍。存完它就在 Drive 里,实时同步。[^2]

- **验证:⌃⇧R 调出,SHIFT-TAB 填参**:
 按 `⌃⇧R` 搜 `logs`,回车,参数依次高亮 —— `SHIFT-TAB` 在参数间循环,同名参数改一处全改(多光标同步)。填 `production` / `web` / `500`,跑通 —— 同一个 workflow 跨环境复用,这才是参数化的意义。写死成一条具体命令,它只够你这台机器用一次。

- **配套:长流程写 Notebook,agent 任务存 Prompt**:
 一条命令存 Workflow;「看日志 → 查进程 → 看最近错误 → 人工判断」这种多步排障,写成 Notebook(markdown + 可执行命令块,还能嵌入刚存的 Workflow);「读 staging 日志找 5xx 原因」这种反复交给 agent 的活,存成带参数的 Prompt。三样各就各位,这套排障就再也不靠记忆了。

_配套的排障 Notebook(示意,markdown + 可执行命令块)_
```text

````md
# 服务健康检查 Runbook

## 适用范围
- 环境:{{env}}
- 服务:{{service}}
- 不做:重启生产服务、删除数据、修改权限

## 1. 只读确认
```shell
pwd
git status --short
```

## 2. 进程与端口
```shell
ps aux | grep {{service}} | grep -v grep
lsof -i :{{port}}
```

## 3. 最近错误(嵌入刚存的 Workflow,免复制)
```shell
docker compose -f docker-compose.{{env}}.yml logs --tail {{lines}} {{service}} | grep -Ei "error|timeout"
```

## 4. 人工判断
- 只读检查失败:记录输出,停止。
- 需要写入 / 重启:另开变更流程,不在本 Notebook 自动执行。
````

```

**提示词 · 让 agent 帮你做沉淀(它跑通的,它最会参数化)**

```text
把刚才跑通的命令沉淀成 Warp Workflow。
请给我:
1. workflow 名称;
2. 一句 description;
3. tags;
4. 哪些部分应该变成 {{argument}};
5. 每个 argument 的默认值和说明;
6. 哪些命令仍然需要人工确认,不该直接放进 workflow。
```

**示例**

```text
把刚才跑通的命令沉淀成 Warp Workflow:
docker compose -f docker-compose.staging.yml logs --tail 200 api | grep -Ei "error|timeout"
请给我:
1. workflow 名称;
2. 一句 description;
3. tags;
4. 哪些部分应该变成参数(我看是 compose 文件名、服务名、tail 行数);
5. 每个参数的默认值和说明;
6. 哪些命令仍然需要人工确认,不该直接放进 workflow。
```

> 一个存量知识要更新:以前教程教你手写 YAML 放在 `~/.warp/workflows/` 下 —— 那是 **legacy**。老文件还能从 Command Search / 命令面板调出来跑,但不再出现在 Drive 里,也不再是新 workflow 的保存方式。新沉淀一律走 Drive(Save as Workflow / 面板新建),团队共享和 agent 上下文都只对 Drive 里的对象生效。[^1]

---

### II · 什么值得存,什么存了是负担

Drive 存四样,关键的一层是它们能回头喂 agent:agent 默认自动取用你存的 workflow、notebook、规则作上下文,取用了会在对话里标 citation。你沉淀的不只是给自己看的手册,也是喂给发动机的燃料 —— 所以 Drive 的干不干净,直接影响 agent 靠不靠谱。[^4]

| 你手里是什么 | 沉淀成 | 不要沉淀成 |
| :-- | :-- | :-- |
| 一条会重复的命令,只有路径/环境会变 | **Workflow** | 长 Notebook 或新脚本 |
| 多步操作手册、部署、排障、上手流程 | **Notebook** | 散落在群聊里的命令串 |
| 反复交给 agent 的自然语言任务 | **Prompt** | 每次重新描述 |
| 环境名、项目路径、非敏感开关 | **Environment Variables** | 共享明文密钥 |
| 一次性探索、临时脏命令 | 什么都不存 | Drive 噪音 |

> 密钥不进 Drive。静态环境变量是明文存的,官方明说它不是密钥管理器;真要用密钥,用**动态**环境变量 —— 接 1Password / LastPass CLI 或自定义取回命令,Warp 只存那条取回命令,不存秘密本身。[^4]

> 可截图判断:**一次性命令只有复盘后才值得沉淀;未经复盘的 Drive 只是第二个过期 README。**

---

### III · Drive 月度体检

存太多和存太少一样糟。一堆没人用的 workflow 比没有还糟:它让人不信任整个 Drive,连同 agent 从里面取的上下文一起不信。一条朴素的节奏 —— 每月第一个周一,五分钟,按下面这张单过一遍:

- 一个月没人调用的对象:要么删,要么补上 description 让别人(和 agent)能用对。

- 重复检查:同一类命令只留一个参数化版本,不留三份近亲。

- 危险命令检查:删除、deploy、生产写库不能无说明地躺在 Workflow 里。

- 密钥检查:Environment Variables 里没有明文 secret;需要的都走动态变量。

- 范围检查:个人对象别误搬进 Team Drive —— 搬进去默认全团队可见可用。

- 调用验证:随机抽三个 workflow,从 ⌃⇧R 调出跑一遍,跑不通的当场修或删。

验收这一章 —— 主线那个「第三次」你自己也要抓到一次:

- 我认出了一条本周重复三次的命令,并用 Save as Workflow 存进了 Drive。

- 会变的部分都抽成了带默认值的参数,我能用 ⌃⇧R 调出、SHIFT-TAB 填参跑通。

- 一个多步流程写成了 Notebook,里面嵌了那个 Workflow。

- 一条反复交给 agent 的任务存成了 Prompt。

- 我知道 YAML 文件 workflows 是 legacy,新沉淀都走 Drive。

- 我给 Drive 体检定了一个月度提醒。

> 跑通是一次性的,
> 存下来才是复利

## 引用与参考

01 · Warp Docs · Warp Drive 概览 —— 截至 2026-08-06:Warp Drive 存 Workflows、Notebooks、Prompts、Environment Variables,实时同步,个人或团队共享;老的 YAML 文件 workflows 是 legacy —— 通过 Command Search / 命令面板无限期支持,但不再进 Drive。  (Warp Docs · Warp Drive)
02 · Warp Docs · Workflows —— 截至 2026-08-06:参数化命令,从命令面板、⌃⇧R 或 Drive 调用;入口包括 Block Actions 与 agent 结果里的 Save as Workflow;参数写作 {{arg}}(字母数字/-/_、不以数字开头),有 text 与 enum 两种类型;SHIFT-TAB 在参数间循环,同名参数多光标同步;AI Autofill 自动生成名称/描述/参数(每次消耗 1 credit);个人 alias 可配。  (Warp Docs · Workflows)
03 · Warp Docs · Notebooks —— markdown 文字加可执行命令块组成可运行文档;命令块用 {{param}} 取参,CMD-ENTER / CTRL-ENTER 插入终端;可嵌入已有 Workflow(Embedded Workflow)免重复;团队编辑是单编辑者制(其余人 Viewing)。  (Warp Docs · Notebooks)
04 · Warp Docs · Drive as Agent Mode Context + Environment Variables —— agent 自动从 Drive 取用 Workflows、Notebooks、环境变量、Rules 与 MCP Servers 作上下文并以 citation 标注(Settings > Agents > Knowledge,默认开);环境变量分静态(存 Drive,不是密钥管理器)与动态(1Password / LastPass CLI 或自定义命令,Warp 只存取回命令、不存秘密)。  (Warp Docs · Drive as agent context)

---

*沉淀 · 把重复三次的事存成一键 · Warp · 一台终端形状的元工具 · Aklman 著 · CC BY-NC-ND 4.0 · https://library.aklman.com/books/warp/06-drive*