— 05 / 第五章

沉淀 · 把一次性变成可复用.

你让 agent 跑通了一件麻烦事，下周还会再来一次。Warp Drive 是它的归宿：Workflows 存参数化的命令，Notebooks 存能跑的命令文档，Prompts 存给 agent 复用的自然语言任务，环境变量分环境注入 —— 个人攒成手册，团队共享成知识库，实时同步。这章讲什么值得存、什么存了反而是负担。You got the agent through a fiddly task; next week it comes back. Warp Drive is where it lands: Workflows store parameterized commands, Notebooks store runnable command docs, Prompts store natural-language tasks for the agent to reuse, environment variables inject per environment — a personal handbook, a shared team knowledge base, synced in real time. What is worth saving, and what becomes a burden once saved.

8 分钟 · 初稿 2026.06 · v3 2026.07.10

上一章你让 agent 跑通了一件麻烦事 —— 但下周它还会再来一次，你又得从头说一遍。Warp Drive 是这些跑通过程的归宿：把命令、文档、给 agent 的任务、环境变量存下来，个人攒成手册，团队共享成知识库，还能反过来喂给 agent。这章讲什么值得存、怎么存好、什么存了反而是负担。Last chapter you got the agent through a fiddly task — but next week it comes back, and you explain it from scratch again. Warp Drive is where those working runs land: save the commands, docs, agent tasks, and environment variables — a personal handbook, a shared team knowledge base, and context you can feed back to the agent. This chapter is what's worth saving, how to save it well, and what becomes a burden once saved.

— I

四种东西，一个归宿.

Warp Drive 存四样：参数化命令、能跑的文档、给 agent 的任务、分环境的变量 —— 而且它们能回头喂给 agent。 Workflows 是命名保存的参数化命令；Notebooks 是能直接跑里面命令的文档；Prompts 是存给 agent 复用的自然语言任务；环境变量分静态和动态，注进 workflow 让同一条命令在生产、预发多环境复用。1注 1Warp Docs · Warp Drive 概览 —— 截至 2026-07-10，Warp Drive 是终端里的内置工作区，用来保存和共享 Workflows、Notebooks、Prompts 与 Environment Variables；对象实时同步，可个人或团队使用。四样都实时同步，个人或团队共享。关键的一层在最后：存在 Drive 里的东西能当 agent 的上下文，agent 会自动取用你保存的 workflow、notebook 和规则，取用了还会在对话里标注出处 —— 所以你沉淀的不只是给自己看的手册，也是喂给发动机的燃料。4注 4Warp Docs · Agent Mode Context —— 截至 2026-07-10，agent 自动从 Warp Drive 取用 Workflows、Notebooks、环境变量、Rules 与 MCP Servers 作为上下文，被引用的对象在对话里以 citation 标注，让个人与团队知识直接喂给 agent（Prompts 则是存给 agent 复用的参数化任务，见 Prompts 页）。Workflows are named, parameterized commands; Notebooks are docs whose commands you can run in place; Prompts are natural-language tasks saved for the agent to reuse; environment variables come in static and dynamic forms, injected into workflows so one command reuses across production, staging, and more.1注 1Warp Docs · Warp Drive 概览 —— 截至 2026-07-10，Warp Drive 是终端里的内置工作区，用来保存和共享 Workflows、Notebooks、Prompts 与 Environment Variables；对象实时同步，可个人或团队使用。 All four sync in real time, personal or shared. The key layer is the last one: what's in Drive can serve as the agent's context — it automatically pulls in your saved workflows, notebooks, and rules, and cites what it used in the conversation — so what you distill isn't only a handbook for yourself, it's fuel for the engine.4注 4Warp Docs · Agent Mode Context —— 截至 2026-07-10，agent 自动从 Warp Drive 取用 Workflows、Notebooks、环境变量、Rules 与 MCP Servers 作为上下文，被引用的对象在对话里以 citation 标注，让个人与团队知识直接喂给 agent（Prompts 则是存给 agent 复用的参数化任务，见 Prompts 页）。

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

— II

存什么：把跑通的那一次留下.

信号很简单：同一件事你做了第二次，就该把它存成 Workflow。 Workflow 以 YAML 保存，带参数和默认值，下次从命令面板一调、填参数就跑。选中后 SHIFT-TAB 在参数间循环；起同名参数时 Warp 自动多光标同步它们，改一处全改。2注 2Warp Docs · Workflows —— 参数化命令，带名字、描述、参数默认值，从命令面板或 Warp Drive 执行；以 YAML 保存、可共享。选中后 SHIFT-TAB 在参数间循环；同名参数会被多光标同步。A Workflow is saved as YAML with arguments and defaults; next time you call it from the palette, fill the arguments, and run. Once selected, SHIFT-TAB cycles through the arguments; when you give two arguments the same name, Warp syncs them with multiple cursors so editing one edits all.2注 2Warp Docs · Workflows —— 参数化命令，带名字、描述、参数默认值，从命令面板或 Warp Drive 执行；以 YAML 保存、可共享。选中后 SHIFT-TAB 在参数间循环；同名参数会被多光标同步。

name: Count 5xx per hour
command: |
  grep -rEh ' 5[0-9]{2} ' {{log_dir}} \
    | awk '{print substr($4, 2, 14)}' \
    | sort | uniq -c
tags: [logs, ops]
description: Count 5xx responses per hour across log files
arguments:
  - name: log_dir
    description: Directory containing .log files
    default_value: ./logs

一个 Warp Workflow（~/.warp/workflows/ 下的 YAML）

把刚才跑通的命令沉淀成 Warp Workflow。
请给我：
1. workflow 名称；
2. 一句 description；
3. tags；
4. 哪些部分应该变成 {{argument}}；
5. 每个 argument 的默认值和说明；
6. 哪些命令仍然需要人工确认，不该直接放进 workflow。Distill the command that just worked into a Warp Workflow.
Give me:
1. workflow name;
2. one-line description;
3. tags;
4. which parts should become {{argument}};
5. default value and description for each argument;
6. which commands still need human approval and should not go directly into the workflow.

把刚才跑通的命令沉淀成 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。Distill the command that just worked into a Warp Workflow:
docker compose -f docker-compose.staging.yml logs --tail 200 api | grep -Ei "error|timeout"
Give me:
1. workflow name;
2. one-line description;
3. tags;
4. which parts should become arguments (I think the compose file, the service name, and the tail count);
5. default value and description for each argument;
6. which commands still need human approval and should not go directly into the workflow.

比一次性命令更长的流程，存成 Notebook：markdown 文字加可执行命令块，命令块同样用 {{param}} 取参，CMD-ENTER / CTRL-ENTER 把它插进终端，还能嵌入已有 Workflow（Embedded Workflow）免得复制。3注 3Warp Docs · Notebooks —— 把 markdown 文字和可执行 shell 命令块组合成可运行文档；命令块用 {{param}} 取参，CMD-ENTER / CTRL-ENTER 插入到终端，可嵌入已有 Workflow（Embedded Workflow）免重复；常用于上手手册与排障 runbook。上手手册、排障 runbook 就该是 Notebook —— 一份一周后还看得懂、还能直接跑的文档，而不是一段躺在群里的命令。For a flow longer than a one-off command, save a Notebook: markdown text plus executable command blocks, blocks taking parameters with {{param}}, CMD-ENTER / CTRL-ENTER to insert one into the terminal, and existing Workflows embeddable (Embedded Workflow) to avoid copies.3注 3Warp Docs · Notebooks —— 把 markdown 文字和可执行 shell 命令块组合成可运行文档；命令块用 {{param}} 取参，CMD-ENTER / CTRL-ENTER 插入到终端，可嵌入已有 Workflow（Embedded Workflow）免重复；常用于上手手册与排障 runbook。 Onboarding playbooks and debugging runbooks should be Notebooks — a doc that still makes sense and still runs a week later, not a command sitting in a chat thread.

# 服务健康检查 Runbook
 
## 适用范围
- 环境：{{env}}
- 服务：{{service}}
- 不做：重启生产服务、删除数据、修改权限
 
## 1. 只读确认
```shell
pwd
git status --short
```
 
## 2. 进程与端口
```shell
ps aux | grep {{service}} | grep -v grep
lsof -i :{{port}}
```
 
## 3. 最近错误
```shell
tail -n 200 {{log_file}} | grep -Ei "error|fail|timeout"
```
 
## 4. 人工判断
- 如果只读检查失败：记录输出，停止。
- 如果需要写入/重启：另开变更流程，不在本 Notebook 自动执行。

Runbook Notebook 模板（示意，可作为 Markdown 导入）

把这次 agent 任务整理成可复用 Prompt。
保留：
- 目标；
- 需要 @ 的上下文；
- 只读/可写边界；
- 禁止命令；
- 验收标准；
- 失败时要如何停下。
把会变化的路径、环境、服务名改成 {{argument}}。Turn this agent task into a reusable Prompt.
Keep:
- goal;
- context that should be @-attached;
- read/write boundary;
- forbidden commands;
- acceptance criteria;
- how to stop on failure.
Turn changing paths, environments, and service names into {{argument}}.

把这次 agent 任务整理成可复用 Prompt：「读 staging 的 api 日志，找出最近一次 5xx 飙升的原因并给出修法」。
保留：
- 目标；
- 需要 @ 的上下文（@docker-compose.staging.yml 和 api 服务日志）；
- 只读/可写边界（只读排查，不改文件、不重启服务）；
- 禁止命令（重启生产、改数据库、deploy）；
- 验收标准（给出原因 + 只读验证命令 + 待确认的修法）；
- 失败时要如何停下（拿不到日志就记录输出并停下，不要瞎猜）。
把会变化的环境名 staging、服务名 api 改成 {{argument}}。Turn this agent task into a reusable Prompt: "read the staging api logs, find the cause of the latest 5xx spike, and propose a fix."
Keep:
- goal;
- context that should be @-attached (@docker-compose.staging.yml and the api service logs);
- read/write boundary (read-only investigation, do not edit files or restart services);
- forbidden commands (restarting prod, DB writes, deploys);
- acceptance criteria (give the cause + read-only verification commands + a fix to confirm);
- how to stop on failure (if logs can't be reached, record the output and stop, don't guess).
Turn the changing environment name staging and service name api into {{argument}}.

— III

别把 Drive 变成第二个 README.

存太多和存太少一样糟 —— 一个没人维护的 Drive，就是另一份过期的 README。只存会复用的：一次性的探索别存，存了也是噪音。团队里更要克制 —— 一个跑得通、带描述和参数的 workflow，胜过一段口口相传的命令；但一堆没人用的 workflow 比没有还糟，因为它让人不信任整个 Drive，连同 agent 从里面取的上下文一起不信。4注 4Warp Docs · Agent Mode Context —— 截至 2026-07-10，agent 自动从 Warp Drive 取用 Workflows、Notebooks、环境变量、Rules 与 MCP Servers 作为上下文，被引用的对象在对话里以 citation 标注，让个人与团队知识直接喂给 agent（Prompts 则是存给 agent 复用的参数化任务，见 Prompts 页）。给 agent 的 Prompts 同理：把真正反复发生的多步任务存下来，不是把每句话都存。一条朴素的维护节奏：一个月没被人调用过的，要么删，要么补上描述让它能被别人（和 agent）用对。Save only what you'll reuse: don't save one-off exploration — saved, it's just noise. On a team, hold back even more — one working workflow with a description and arguments beats a command passed around by word of mouth; but a pile of unused workflows is worse than none, because it makes people distrust the whole Drive, and the context the agent pulls from it along with it.4注 4Warp Docs · Agent Mode Context —— 截至 2026-07-10，agent 自动从 Warp Drive 取用 Workflows、Notebooks、环境变量、Rules 与 MCP Servers 作为上下文，被引用的对象在对话里以 citation 标注，让个人与团队知识直接喂给 agent（Prompts 则是存给 agent 复用的参数化任务，见 Prompts 页）。 Prompts for the agent are the same: save the multi-step tasks that truly recur, not every sentence. A plain maintenance cadence: anything not called in a month gets deleted, or gets a description so someone else (and the agent) can use it right. 把上一章存的那个 workflow 再往前推一步：

把它参数化、加标签

把写死的路径、环境、名字抽成带默认值的 {{argument}}，加 tags，确认能从命令面板用关键词调出来。Pull the hard-coded paths, environments, and names into {{argument}} with defaults, add tags, and confirm you can summon it from the palette by keyword.

把一个长流程写成 Notebook runbook

挑一件你将来还要回看的多步流程（部署、排障、上手），写成 markdown + 命令块的 Notebook。

数一数 Drive 里有几个一个月没用过

一个月没碰过的，要么删，要么补上描述。让 agent 取到的上下文是干净的，它才靠谱。

Drive 体检：一个月没人用的对象，要么删，要么补 description。
检查重复：同一类命令保留一个参数化版本，不留三份相似命令。
检查危险命令：删除、deploy、生产写库不能无说明地存在 Workflow 里。
检查密钥：Environment Variables 里不要共享明文 secret；需要密钥时走安全存储或让每个人自行配置。
检查适用范围：个人对象别误搬进 Team Drive；搬进去就默认所有团队成员能看到和用。

— 引用与参考

参考.

01
Warp Docs · Warp Drive 概览 —— 截至 2026-07-10，Warp Drive 是终端里的内置工作区，用来保存和共享 Workflows、Notebooks、Prompts 与 Environment Variables；对象实时同步，可个人或团队使用。 Warp Docs · Warp Drive
↩
02
Warp Docs · Workflows —— 参数化命令，带名字、描述、参数默认值，从命令面板或 Warp Drive 执行；以 YAML 保存、可共享。选中后 SHIFT-TAB 在参数间循环；同名参数会被多光标同步。 Warp Docs · Workflows
↩
03
Warp Docs · Notebooks —— 把 markdown 文字和可执行 shell 命令块组合成可运行文档；命令块用 {{param}} 取参，CMD-ENTER / CTRL-ENTER 插入到终端，可嵌入已有 Workflow（Embedded Workflow）免重复；常用于上手手册与排障 runbook。 Warp Docs · Notebooks
↩
04
Warp Docs · Agent Mode Context —— 截至 2026-07-10，agent 自动从 Warp Drive 取用 Workflows、Notebooks、环境变量、Rules 与 MCP Servers 作为上下文，被引用的对象在对话里以 citation 标注，让个人与团队知识直接喂给 agent（Prompts 则是存给 agent 复用的参数化任务，见 Prompts 页）。 Warp Docs · Drive as agent context
↩

跑通是一次性的，存下来才是复利.

Getting it working is one-time, saving it is compounding.

Aklman Library

— 讨论

讨论.

评论区初始化中…

沉淀 · 把一次性变成可复用Distill · Turning One-Offs into Reuse.

四种东西，一个归宿Four Kinds of Things, One Home.

存什么：把跑通的那一次留下What to Save: Keep the Run That Worked.

别把 Drive 变成第二个 READMEDon't Turn Drive into a Second README.

讨论Discussion.

沉淀 · 把一次性变成可复用.

四种东西，一个归宿.

存什么：把跑通的那一次留下.

别把 Drive 变成第二个 README.

讨论.