SOP Coding：演示 - 生成 SOP - 遵循 SOP ，人只需要做一遍演示就够了

JUST DO ONCE

项目地址

官方网站/文档/教程

问题

在使用 AI 编程时, 为了让 AI 能够更加遵循我们的需求, 有包括但不限于以下的方案:

• Rules: cursor rules / windsurf rules / augment guidelines, 需要写详细的指令才能够达到好的效果
• memory: 无法版本管理, 而且可能得到不准确的答案
• context engine: 几乎是完全黑盒, 无法控制.
• ...

解决思路

如果我们认为详细的高质量的指令/提示词是必不可少的.

解决方案就是: 用最低的成本生成指令/提示词.

更直观的说: 对于一个项目而言, 有能力编写高质量的详细的提示词的是最熟悉这个项目的人. 为什么? 因为他知道如何正确的准确的修改代码, 他熟悉项目的结构和微小的细节.

那是不是可以这样理解: 详细的操作记录 + 生成文档的 Agent -> 高质量的提示词 ?

令人兴奋的答案是: 没错, 是的!

一个生成文档的 Agent 是不难的, 可以参考SPEC-mcp

但是程序员完成一个需求的详细操作记录, 可太麻烦了, 包括但不限于:

1. 代码编写: 修改/新增/删除单个文件内的代码.
2. 架构调整: 大量的文件的层级的修改
3. 命令执行: 各类和命令行的交互, git/npm/uv 以及 makefile ...
4. 其他交互: 网页上的调试, k8s 部署, 云服务商的服务的调整等等

我们可以发现: 大部分的工作, 是在 IDE 中完成的, 如果能够有一个插件捕获到这些操作呢?

recorder

OpenVSX 插件下载: 适用 cursor/windsurf/trae

VsCode 手动下载

Jetbrains 插件下载地址

这就是 recorder 的诞生的过程, 以及 这就是 recorder 的功能: 一个捕获程序员关键操作并且能够序列化成文件的插件.

使用起来几乎没有什么门槛, 左下角有一个录制按钮, 点击之后正常的工作, 然后点击结束, 项目目录下会有一个 operation.json.

然后拿着这个 operation.json 就可以生成 SOP 文档了.

效果可以参考: https://recorder.tokenroll.ai/zh-Hans/docs/example/go-zero-new-api

在线生成 SOP

如果您不想增加 mcp 的话, 可以在线试用 sop 生成的能力