新闻

Vercel-update-docs:把”文档同步”从口头约定变成工程流程

1 分钟阅读
来源:aixq.cc
代码和文档不同步,大概是开源项目里最普遍的慢性病。API 改了签名,文档还停在三个月前;组件加了新 prop,示例代码还是旧的。小项目可以靠维护者记性好,但 Next.js 这种几千个文件的仓库,靠记性早就崩了。 Vercel 的做法是把这个流程塞进 Agent 里。next.js 仓库的 .agents/skills 目录下维护着一个官方 skill,叫 update-docs。维护者审查 PR 时,让 AI 顺着代码变更找出受影响的文档,逐个确认修改,甚至从零搭建新功能的文档骨架。 这个 skill 跟市面上大