Aklman · Library

06 / 第六章

沉淀 · 把重复三次的事存成一键.

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

MD海报

跑通一次是运气,跑通三次是信号。这周你第三次敲同一条看日志的命令时,该意识到的不是「我记性真好」,是「这活该固化了」。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注 1Warp Docs · Warp Drive 概览 —— 截至 2026-08-06:Warp Drive 存 Workflows、Notebooks、Prompts、Environment Variables,实时同步,个人或团队共享;老的 YAML 文件 workflows 是 legacy —— 通过 Command Search / 命令面板无限期支持,但不再进 Drive。
01

认出信号:第三次,停手,别敲第四次

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

块右键 Save as Workflow,参数化

在刚跑通的那个 block 上右键,选 Save as Workflow(agent 跑出来的结果同样有这入口)。把 staging 改成 {{env}}api 改成 {{service}}200 改成 {{lines}},各给默认值;名称和描述可以让 AI Autofill 起草(每次消耗 1 credit),自己再过一遍。存完它就在 Drive 里,实时同步。2注 2Warp Docs · Workflows —— 截至 2026-08-06:参数化命令,从命令面板、⌃⇧R 或 Drive 调用;入口包括 Block Actions 与 agent 结果里的 Save as Workflow;参数写作 {{arg}}(字母数字/-/_、不以数字开头),有 text 与 enum 两种类型;SHIFT-TAB 在参数间循环,同名参数多光标同步;AI Autofill 自动生成名称/描述/参数(每次消耗 1 credit);个人 alias 可配。
03

验证:⌃⇧R 调出,SHIFT-TAB 填参

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

配套:长流程写 Notebook,agent 任务存 Prompt

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

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

提示词让 agent 帮你做沉淀(它跑通的,它最会参数化)
把刚才跑通的命令沉淀成 Warp Workflow。
请给我:
1. workflow 名称;
2. 一句 description;
3. tags;
4. 哪些部分应该变成 {{argument}};
5. 每个 argument 的默认值和说明;
6. 哪些命令仍然需要人工确认,不该直接放进 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。

II

什么值得存,什么存了是负担.

Drive 存四样,关键的一层是它们能回头喂 agent:agent 默认自动取用你存的 workflow、notebook、规则作上下文,取用了会在对话里标 citation。你沉淀的不只是给自己看的手册,也是喂给发动机的燃料 —— 所以 Drive 的干不干净,直接影响 agent 靠不靠谱。4注 4Warp Docs · Drive as Agent Mode Context + Environment Variables —— agent 自动从 Drive 取用 Workflows、Notebooks、环境变量、Rules 与 MCP Servers 作上下文并以 citation 标注(Settings > Agents > Knowledge,默认开);环境变量分静态(存 Drive,不是密钥管理器)与动态(1Password / LastPass CLI 或自定义命令,Warp 只存取回命令、不存秘密)。
你手里是什么沉淀成不要沉淀成
一条会重复的命令,只有路径/环境会变Workflow长 Notebook 或新脚本
多步操作手册、部署、排障、上手流程Notebook散落在群聊里的命令串
反复交给 agent 的自然语言任务Prompt每次重新描述
环境名、项目路径、非敏感开关Environment Variables共享明文密钥
一次性探索、临时脏命令什么都不存Drive 噪音

III

Drive 月度体检.

存太多和存太少一样糟。一堆没人用的 workflow 比没有还糟:它让人不信任整个 Drive,连同 agent 从里面取的上下文一起不信。一条朴素的节奏 —— 每月第一个周一,五分钟,按下面这张单过一遍: 验收这一章 —— 主线那个「第三次」你自己也要抓到一次:

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

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

Aklman Library

讨论

讨论.

评论区初始化中…