AI 协作

这里是“李寒的小窝”里给 AI 用的那一层。

整个站点只分两层：

下面只讲第二层。讲清两件事：怎么用 和 卡片长什么样。

唯一规范通道

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

任何项目里的 AI 都直接打这个 URL：

它是个静态文件，没有数据库、没有 API、没有鉴权——只是一个 JSON。这是有意的：URL 就是协议。

让 AI 在做任务前去看看有没有相关卡片。命中就用，没命中就照常。AI 不应该把整个卡库塞进上下文，也不应该在没命中时自己脑补——直接说"没有"，然后正常做。

做完一件事，觉得这个经验下次还能用，就让 AI 起草一张卡片。AI 不会自动 commit / push / PR——每一步状态变更前都要明确点头。最后由你手动合并 PR。

任务完成的瞬间，如果同时满足四件事——已验证完成、经验本身不平凡、可以推广、这个会话还没提示过——AI 就主动问一句"想沉淀成卡片吗？" 你答 y 就走第二种；答 n 就放下，整个会话里不再就同一条经验提示。

这三种模式都通过一个跨工具的小 skill 暴露给本机的 AI 工具（Claude Code、Codex 等）。具体安装在博客仓库的 scripts/install/ 下，对人不重要——skill 的全部职责就是把 AI 引到上面那个 URL。

一张卡片就是一个 markdown 文件，YAML frontmatter + 紧凑正文。

字段	说明
`id`	kebab-case，等于文件名
`type`	`incident` / `tip` / `playbook` / `pattern` / `reference`
`title`	人类可读的标题
`summary`	一句话，registry 直接复制，手写无 fallback
`tags`	kebab-case 列表
`created` / `last_verified`	`YYYY-MM-DD`
`status`	`valid` / `stale` / `retired`
`context_cost`	`low` / `medium` / `high`，告诉加载方代价
`produces`	短标识，例如 `diagnosis_and_fix`、`decision_rule`
`verify`	块，含 `command` / `expected` / `failure_next` 三段非空字符串

verify.command 可以是 shell 命令，也可以是"按这步骤目测一下"的描述句——两种都算，不强求自动可执行。

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

可选段（按需）：## Symptoms、## Diagnosis、## Pre-requisites、## Related 等等。

正文是写给机器看的：bullet、表格、key-value，不写多段人类散文。

valid → stale → retired。

不按时间表去扫——只在我真的发现某张卡片对不上现实时，编辑它的 status 并 bump last_verified。被 retired 的卡片仍然留在 registry，agent 读到 retired 就跳过；历史保留，不删除。

不做的	为什么
自动转录 / 对话日志 / 自动 ingest	隐私默认 = 脱敏。原始 transcript 不落地
多资产格式（tip / playbook / session 各一种文件）	之前试过，最后归并成"卡片"一种
MCP server	暂缓。`curl + jq` 还够用
向量检索 / 语义搜索	同上
自动 PR、自动合并	PR-only publication 是宪法硬底线
后台 watcher / 守护进程	没有 always-on infrastructure

这些不是"还没做"，是"故意没做"。如果未来真的需要其中一项，会先经过宪法（.specify/memory/constitution.md）的"1-day MVP"和"no-agent-sprawl"两道闸口。

想找经验：先 curl /ai/registry.json，按 entry 元数据筛，至多打开一张正文。想写经验：起草卡片，跑校验，等你明示同意，再 commit + PR。自觉想提示捕获：任务收尾时 AND-of-four 全过才说话，被拒了就闭嘴。

剩下的细节都在卡片里——尤其是 agent-card-protocol 这一张，它就是这条协议的源代码。