流程图中应该是中文，而不是你需要思考的英文函数。

核心观点

AI 时代，能把一件事用中文流程图、SOP 和边界说明讲给人或 Agent 听懂，才算真懂。

• 对着流程图能讲清楚：
  • 说明我自己已经想清楚。
• 真实的人能听懂：
  • 说明表达能离开我脑子。
• Agent 能听懂：
  • 说明这件事已经变成可执行上下文。
• 共识形成了：
  • 就可以放心交给 AI 执行。

费曼学习法在 AI 时代多了一层：不仅要讲给人听懂，也要讲给 Agent 听懂。

show me the flow

• 过去看代码：

  • show me the code

• 现在先看流程：

  • show me the flow

• 代码变便宜以后，更稀缺的是：

  • 问题定义。
  • 流程拆解。
  • 边界判断。
  • SOP。
  • 人和 Agent 的共同理解。

• 流程清楚：

  • AI 可以生成代码。

• 流程不清楚：

  • 代码越多越乱。

这次触发点

• 来源：
  • 改 技术：HarnessX 第 10 课。
• 一开始的问题：
  • 解释太多。
  • 设计决策展开太多。
  • 函数和代码细节太多。
  • 看起来完整，但不好讲给学员听。

你真的知道每一行代码细节又如何？代码实现再快，有 AI 快吗？

• 重心应该变成：
  • 先讲流程。
  • 再讲架构。
  • 再讲边界。
  • 最后才讲代码怎么落地。

人的工作

• 定义问题：

  • 到底要解决什么。
  • 问题发生在哪条链路上。
  • 哪些是核心，哪些只是实现细节。

• 画出流程：

  • 用户从哪里进入。
  • 数据怎么流动。
  • 状态在哪里变化。
  • 模型什么时候参与。
  • 工具什么时候执行。
  • 结果怎么回填。

• 划清边界：

  • 哪一层负责规则。
  • 哪一层负责执行。
  • 哪一层负责缓存。
  • 哪一层负责和模型通信。
  • 哪些变化影响全局，哪些只是局部变化。

• 写成 SOP：

  • 第一步做什么。
  • 第二步看什么。
  • 失败时检查哪里。
  • 产物怎么验收。
  • 稳定后怎么沉淀成 skill。

流程图就是一种编程，使用中文

• 流程图不是文章装饰。

• 流程图是把想法变成可执行上下文。

• “源码大流程图”的价值：

  • 不急着写函数名。
  • 先用中文动作描述代码在做什么。
  • 先讲主流程，再看局部实现。

• 中文动作更适合先建立理解：

  • 命令入口接收任务。
  • 进入代理循环。
  • 收集真实运行现场。
  • 整理成提示词材料清单。
  • 判断是否复用系统提示词。
  • 请求模型。
  • 执行工具。
  • 工具结果写回对话。

如果一套实现无法用中文流程讲清楚，我很可能还没有真正掌握它。

写技术文章的规则

• 先给核心思想。
• 再给架构图。
• 再用一条任务贯穿全文。
• 再解释最容易混淆的边界。
• 再给运行命令和验收点。
• 最后才进入源码。
• 源码部分：
  • 先画中文代码流程图。
  • 先让人看懂程序到底在做什么。
  • 再看入口和关键调用。
  • 最后才看局部实现。

最后：这篇文章的流程图

先别急着 show me the code，先 show me the flow。能把 flow 讲给人和 Agent 听懂，才算真懂。