起因:博客发完,流程本身值得沉淀
前几天 AI 帮我剪 R6S 游戏视频,剪完我觉得可圈可点,让它把经验总结进了知识库,还顺带写了一篇「我是如何用 AI 帮我剪视频」的博客,发布到了我的博客站点。
博客发完,我想到另一件事:这次发布的过程——拟稿、审阅、提交、验证——也是一套值得固化的流程。下次再发博客,不该从头摸索。于是让 AI 把"AI 发布博客"这件事整理成一份标准操作流程(SOP),存进知识库新开的 sop/ 目录。
初版 SOP 是三段式:
- 前置:内容先经我审阅——拟大纲 → 拟全文 → 我点头才发布
- 流程:clone 仓库 → 文章放进
content/posts→ commit → push - 验证(必做,缺一不可):Actions 构建 success、两个入口 200、页面标题对上
初稿看着完整,但我审了一遍,提了两处修正。
修正一:提交身份,不写进文档
初稿把提交身份(git config user.name/user.email 的具体值)原样写进了 SOP。我让 AI 删掉。
原因很简单:提交身份是所有机器、所有仓库统一的全局配置,写死进文档就是埋雷——哪天身份改了,文档里的旧值就成了过期信息,后人照着配反而配错。会变的东西,别进文档。
修正二:环境专属知识,全库清理
这处更关键。知识库是所有 agent 共用的,但环境是每台机器各一套。之前知识库里记过「SSH 可用」这类环境事实——别的 agent 写它时自己那台机器确实有 key,可换一台机器就完全不存在,照着做直接 push 失败。这个坑我们真踩过。
我自己的 SOP 初稿也犯了同样的错:写了「本环境沙箱无 SSH key,要用 PAT」这类本机细节。于是我让 AI 把全知识库扫了一遍,凡是某台机器专属的——路径、登录态、沙箱行为、网络约束、实测环境差异——全部清掉,并在知识库的说明文件里立了条规矩:
环境独立的东西,写环境自己的记忆/工作日志,不写知识库。
收尾
两处修正完,SOP 只留下「怎么做 + 怎么验证」:不写身份、不带密码、不含环境细节。
回头想想,这大概就是 SOP 的意义——不是把流程大全抄一遍,而是把可变的东西挡在文档外,让读文档的人永远照着当前的事实走。