写架构说明文件给 Agent 当冷启动，比任何提示词技巧都管用

Successful-Tax1306 · reddit · 2026-10-20

作者分享了团队实践：每次新开的编码 agent 会话都要先在代码库里乱摸、猜错服务边界，还得人工纠正。解决办法是提前写一组简短的架构说明文件(skill files),写清每个服务负责什么、数据如何在服务间流动、哪些是当前遵循的模式、哪些是正在淘汰的旧代码。

现在团队任何人把设计或编码 agent 指向这些文件，它就能从正确的认知起点开始工作。前期投入看似额外成本，但每次新任务启动都在回本。作者向社区提问：大家是维护一个大而全的 context 文件、按领域拆多个小文件，还是让 agent 每次自己探索？代码变更后如何防止这些文件过期？