仓库里放specs对agent未必有用
zeeg · x · 2026-07-14
作者分享了自己把 specs 长期放在仓库里做“同位维护”的实验结论：**没带来足够价值**。 主要问题是： - 维护成本很高，很多内容最终变成了文档而不是可执行约束 - 经常过时，反而让 agent 误判“真实来源” - 即使写的是 intent，模型也常忽略，最后还是在做更多复制粘贴 他准备改成更轻量的结构： - `policies/`：只放非常轻的规则，比如代码注释该出现在哪里 - `openspec/`：暂时保留，但不当作上下文文档 - `custom skills`：补第三方文档，比如 Vercel Sandbox、Slack API - `agents.md`：主要做资源地图 - 用内联代码注释表达 intent