用注释锁住接口约束,防止 agent 下次会话破坏代码
zeeg · x · 2026-10-14
David Cramer 详细阐述何时必须写注释:如果你有一个约束明确、精心设计的公共接口,必须把约束写进代码——注释、确定性规则都行——否则下次会话 agent 会随意越过它。这在软件可靠性上越来越重要。
他的朴素版本:
- 注释应在接口意图无法显然推断时声明意图
- 注释永远不该用来注释显而易见的东西
他还给出第二个用例:改代码库时,把错误模式标注出来,让 agent 遵循正确模式。他自述观点全靠经验,但认为「agent 是否真的会写代码」评测应该包含这一场景;他不追求节省 token 的小优化。
所属事件:开发者经验：用注释锁住接口约束防止 AI agent 破坏代码(2 条相关)→
「编程与Agent」频道最新
- 工程师新职责:理解系统级取舍,并常对 Claude 说「不」 — ronbodkin · 2026-10-14
- 代码审查变意图审查:Anthropic 团队不再逐行读代码 — ronbodkin · 2026-10-14
- Anthropic 单日合并代码变更达 3 万次,5 月以来增长 12 倍 — ronbodkin · 2026-10-14
- 复旦团队推出 MATE：首个移动 Agent 轨迹安全审计模型 — jiqizhixin · 2026-10-14
- 网友 vibe coding 复活未发售的 BattleBots PS2 游戏 — TAbrodi · 2026-10-14
- OpenAI mcp-extensions 破千星，v0.2 支持多轮表单与可编辑草稿 — gabrielchua · 2026-10-14