AI 时代人机协作工作流博客 V4 说明

先说结论

这个博客现在进入 V4：AI 时代人机协作工作流博客。

听上去有点大。核心很朴素：过去这里是赛博日记、技术学习笔记、灵感收纳盒；现在 AI 已经能帮我查资料、写代码、跑命令、改项目，旧式"把技术步骤写成长教程以备下次翻"的价值断崖式下降——我自己都不再回去翻那些教程，模型一句话就把活干了。

所以 V4 起，博客分两条线：

给人看的内容继续保留人的味道：随想、旅行、生活、阶段总结，该怎么写还怎么写。
给 AI 看的技术内容改造成工具：一种叫"卡片（card）“的小文件，每张装一段可复用的经验，让未来的 AI 在任何项目里都能直接拿来用。

不是把"小窝"装修成企业文档站。更像是在小窝里加了一个工具间，里面放着扳手、标签、清单和一点点家规——给我自己和与我合作的模型。

旧博客不动

旧博文全保留，不迁移、不重写、不批量整理 frontmatter。

旧文章里有前 AI 时代的学习痕迹，有当时看起来笨但很真实的记录。它们不是脏数据，不需要被 AI 打扫得光滑如新。

以后写生活、旅行、随想、计划，仍然是传统博客文章。AI 帮我润色、排版、检查链接 OK，但文章本身是给人读的。

5 天后：最初的设想砍了大半

说实话，V4 刚开局时我画的图比现在大得多。

我最初想了一堆东西：4 种资产格式（tip / playbook / skill / session），一套 GitHub dispatch 自动管道，几类 hook 在敏感时刻插手，甚至给本地 MCP server 留好了位置——准备把博客做成一个能查能写能复盘的"小型知识库平台”。

V4 上线 5 天，一边用一边改。这一周下来，最初设想里一大半工程没保留下来：

4 种资产格式 → 1 种：「卡片」。tip / playbook 都是它的 type 字段。
GitHub dispatch 自动管道 → 删了。所有发布走人工 PR。
hooks 干预 → 没建。守护进程会模糊"AI 做了什么"的边界，违反隐私默认。
本地 MCP server → 暂缓。curl + jq 还够用。

砍到最后，剩下一个 静态 JSON 索引（registry） + 一种 markdown 格式（card） + 一个跨工具的薄 skill。

这种"塌缩"不是失败。是发现 大多数工程感强的设计其实在替我加包袱，而真正起作用的是那条很短的链路：

1
AI 查 registry → 看摘要决定要不要打开 → 至多打开一张正文 → 干活

整套工程在原仓库里有一份对应的"宪法"和几条硬底线在背书——不允许 always-on infrastructure，不允许 agent sprawl（一项功能两套实现并存），不允许批量加载，等等。每次我想"再加一个守护进程"或"再加一种资产格式"，那几条底线把我拍回去。结果就是越用越简单。

一种格式：卡片

卡片现在就是一个 markdown 文件，写在 ai/cards/<id>.md，frontmatter + 紧凑正文。

frontmatter 里固定写：id、type、summary、status（valid/stale/retired）、context_cost、last_verified，最关键一项是 verify 块——三段：执行什么 / 期望看到什么 / 看不到怎么办。这一段直接决定一张卡的可复用性。

正文必填三段：

1
2
3
## Trigger        什么场景下加载这张
## Fix            具体怎么做
## Reuse Rule     加载条件 / 不加载条件

整张卡片故意写得"对人不友好"——bullet、表格、key-value，没有起承转合。它的读者是模型，不是访客。完整模板与契约见 /ai/ 页面。

一个公开 URL

模型查经验只有一个入口：

1
https://lihan3238.github.io/ai/registry.json

不需要 clone 仓库，不需要装 SDK，不需要登录。一个静态 JSON 暴露在公网上，谁来都能查。

URL 就是协议。如果某天有更好的模型，它能用；如果某天我换了主力工具，它也能用。这种"少依赖"是这个层目标活久一点的唯一办法。

趋势：这种层在变成标配

回过头看，V4 砍掉那些花活之后，剩下的东西不太像"我自创的工作流"——更像是 AI 工具圈这两年慢慢涌现的标配：

经验沉淀成 可查询的、机器可读的小文件，而不是长教程。
协议长在 公开静态资源 上，不长在某个特定工具/IDE/订阅里。
自动化只在 任务收尾的瞬间 由模型主动建议，所有写入需要人点头，不靠后台扫描。
工具适配层（skill / plugin / extension）只是一层薄壳，真东西在卡片里——这样跨工具的迁移成本接近零。

我把这些写下来不是因为它们是我发明的。是因为我经过砍掉自己一堆"工程感很强的设计"之后，终于看清这条主流路径的轮廓。接下来这一年大概会越来越像这样。

几条家规（这些是保留下来的）

旧文章只读。content/post/** 里的历史文章不要被批量迁移、重写、整理。只有当我明确点名某篇要改时，AI 才动。
默认脱敏公开。卡片只保存公开可读、已脱敏的内容；不写原始对话、不写密钥、不写私密路径。
AI 资产要短小。一个 tip 能解决，就不要写成长 playbook；一个 playbook 能表达，就不要升级成 skill。“少读” 比 “全面” 更重要。
更新完要说人话。每次功能 / 自动化 / 工作流更新完，AI 都要告诉我：这次改了什么、我怎么用、未来 AI 怎么调用、用哪个命令验证。

这几条会写进项目指令和质量门里，防止"改完功能丢一句’完成了’就跑路"。

这次改造的意义

我觉得这一版最大的变化，不是多了几个目录、多了几个自动化脚本。

真正的变化是：博客不再只是"我写给未来的我看"，而是变成"我和未来的 AI 一起工作的接口"。

过去把知识写下来是怕忘。现在把流程固化下来是为了让人和 AI 都能更稳一点地进化。

而且——这套接口已经把我自己以前画的复杂版砍掉了大半。如果半年后我回头再看，可能还会再砍一些。没关系，越简单越像主路。

当然，小窝还是小窝。技术层长出了一套机器骨架，门口仍然可以放歌、写随想、贴旅行照片、偶尔吐槽人生。这样就挺好。

更新（2026-06-12）：一个月后，重心从"卡片"移到了"运行时"

V4 上线一个月，又砍了一轮、也长了一轮。上面正文保持原样，这里记录变化。

当初说"真东西在卡片里"。用了一个月发现不完全对：真东西在工作流里，卡片只是它的公开切片。所以这次重构把日常运行时彻底搬回本地——

模式按仓库粘住。每个仓库是工程 / 科研 / 通用哪种模式，记在一个用户级 YAML 里（repo-modes.yaml），AI 不再每次会话重新猜。博客仓库永远是工程模式，研究仓库永远是科研模式，说一次就够。
科研工作流收编。原先为研究工作零散长出的五个 skill（环境变量、运行时、笔记维护、假设冲刺、论文写作）全部折叠进 lihan-cards 的 references，按任务只加载一片。“一个入口"的家规扛住了第一次真正的膨胀压力。
私有事实和工作流分了家。工作区路径、GPU 主机、下载策略这种"固定但会变"的东西进一个非密 profile 文件随仓库同步；密钥永远只在本地。工作流引用里只写字段名，不写值。
“至多打开一张正文"退役了。它被一套更细的 context budget 取代：原则精要常驻、环境检查可以打包加载、incident 调试仍然保持窄。一刀切的规则让位给按类别给预算。
卡片 PR 可以自动合并了。这是对"所有写入需要人点头"的一次有边界的放松：我在捕获时点一次头（go），之后 CI 全绿 + 改动严格限制在卡片 allowlist 内，PR 自动合并。点头从"每一步"变成"每一件事一次”，底线（非卡片变更必须人合）没动。

回头看正文里那句"如果半年后我回头再看，可能还会再砍一些”——只用了一个月。砍掉的是"每次都重新解释我是谁、在哪个仓库、干哪类活"的摩擦；留下来的还是那条短链路，只是链路的起点从公网 URL 挪到了本地 skill，公网那份变成了展示窗和异地备份。

越用越像一个运行时，越不像一个文档站。 大概这就是对的方向。