SOP Coding：演示 - 生成 SOP - 遵循 SOP ，人只需要做一遍演示就够了
JUST DO ONCE
问题
在使用 AI 编程时, 为了让 AI 能够更加遵循我们的需求, 有包括但不限于以下的方案:
- Rules: cursor rules / windsurf rules / augment guidelines, 需要写详细的指令才能够达到好的效果
- memory: 无法版本管理, 而且可能得到不准确的答案
- context engine: 几乎是完全黑盒, 无法控制.
- ...
解决思路
如果我们认为详细的高质量的指令/提示词是必不可少的.
解决方案就是: 用最低的成本生成指令/提示词.
更直观的说: 对于一个项目而言, 有能力编写高质量的详细的提示词的是最熟悉这个项目的人. 为什么? 因为他知道如何正确的准确的修改代码, 他熟悉项目的结构和微小的细节.
那是不是可以这样理解: 详细的操作记录 + 生成文档的 Agent -> 高质量的提示词 ?
令人兴奋的答案是: 没错, 是的!
一个生成文档的 Agent 是不难的, 可以参考SPEC-mcp
但是程序员完成一个需求的详细操作记录, 可太麻烦了, 包括但不限于:
- 代码编写: 修改/新增/删除单个文件内的代码.
- 架构调整: 大量的文件的层级的修改
- 命令执行: 各类和命令行的交互, git/npm/uv 以及 makefile ...
- 其他交互: 网页上的调试, k8s 部署, 云服务商的服务的调整等等
我们可以发现: 大部分的工作, 是在 IDE 中完成的, 如果能够有一个插件捕获到这些操作呢?
recorder
这就是 recorder 的诞生的过程, 以及 这就是 recorder 的功能: 一个捕获程序员关键操作并且能够序列化成文件的插件.
使用起来几乎没有什么门槛, 左下角有一个录制按钮, 点击之后正常的工作, 然后点击结束, 项目目录下会有一个 operation.json.
然后拿着这个 operation.json 就可以生成 SOP 文档了.
效果可以参考: https://recorder.tokenroll.ai/zh-Hans/docs/example/go-zero-new-api
在线生成 SOP
如果您不想增加 mcp 的话, 可以在线试用 sop 生成的能力
 |
1
Unboundwill 30 天前  1
没想到录制插件的实现可以这么简单，做得真好，已 star ！👍
|
 |
2
kongkongye 30 天前
之前有过类似的 idea ，你这个问题是没人会重度使用这个功能，如果一天有 3 小时都在干这种重复的活，那做这么一个流程，将 3 小时的活压缩为 10 分钟，是很有用的。但我每天干的活都很杂，这种活可能好几天才会碰到一次，每次都带点变数，所以就不会去用这么个东西。
|
|
3
kongkongye 30 天前
@kongkongye 比如最近我研究，ai 时代，是不能帮办公人员节省大量重复的活。最后发现很难，现在每个岗位做的活都很杂了，每种活都是已经提效过的。
比如一个人有 30 种流程的活，每天可能平均会干其中 10 种流程的活，那你针对其中一种流程进行优化提效，别人从每天花费 30 分钟变成花费 5 分钟，节省那么一点时间，都懒得去学习使用这个工具。 但如果有人真的干重复的活，比如每天花 8 小时帮客户将上百个单子手动输入系统，那做个提效工具，将 8 小时压缩到 30 分钟，用户肯定就愿意用了。 |
 |
4
pDJJq OP @Unboundwill 感谢支持
|
|
5
pDJJq OP @kongkongye #2
非常有价值的问题. 我觉得在任何 AI Coding 都会遇到类似的问题: 也就是积累的文档, 必须主动的去用. recorder 的流程中其实会有一个步骤: 将生成的 sop 文档, 存入 .spec 文件夹下, 做版本管理. 所以完全可以在 cursor rules 中添加 要求在修改代码前查看.spec 的文件, 让 AI 更加主动的去使用文档. 人类要做的事情是: 持续的记录, 不断你的积攒文档. 或者说: "让 AI 为你工作"这件事情, 就应该是渐进式的. |
Select Language