返回资讯中心
外部精选
软件工程
#开发者实时流

开发者提出「意图规格」HTML页面,用于agentic开发流程

来源标题:An intention spec – workflow for the agentic dev cycle

一份公开提案提出用「意图规格」替代传统工单:以轻量HTML页面呈现图表、约束和用户旅程,人类与agent查看同一渲染结果,让代码成为意图的衍生物。开发者称完整规格太重、工单太薄,该中间层改变了沟通、实现、评审和故障诊断的流程,工具包已发布在GitHub。

Hacker News 最新djordjep2026/11/17 · 今天23 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

一份大家可以查看的共享提案:它改变了开发者沟通的方式,让代码变成意图的衍生物,并为评审和失败历史提供了坚实的依托。

开发周期正在改变。过去一张工单对应两周的工作,或一个 issue 对应一次修复,如今往往是一条 prompt 就导向一个解决方案。Agent 负责写出改动。对于这类工作,经典工单正在失去存在的理由。

开发者正在变成集架构师和产品角色于一身的人。他们仍然需要一种方式,在简单的工作流中沟通复杂的想法:一种团队可以查看、可以争论、可以交给 agent 的东西。完整的规格说明对大多数情况来说太重了。工单又太薄了。

这个中间层就是我所说的意图规格(intention spec)。它是一个小型 HTML 页面,或者几个页面,用来呈现提案。图表、约束、用户旅程。人和 agent 打开的是同一个渲染结果。它不是一个平台。它是仓库里一个轻量的产物——但它改变了整个周期:先沟通,再实现、评审,之后对照原本的意图进行诊断。工具包在 GitHub 上。

这些词常被当作同一份文档的不同长度来用。它们并不是。

规格说明是系统、或系统很大一部分的契约。它试图把所有情况都定死。它始终具有约束力。每次都先更新它,这就是经典的 spec-first 循环:大文档先动,然后工作跟进。当改动确实是对契约的改动时,这样做是对的。当改动只是众多提案中的一个、而完整文档并不是今天任何人需要打开的东西时,这样做代价太高。

意图是针对一次实质性变更的提案。它说明我们这一次打算构建或改变什么,配有足够清晰的图景,让人或 agent 能在代码存在之前就检验这个想法。它不是完整的产品契约。它也不是队列卡片。

工单是队列中的一个条目:标题、状态、负责人、验收条目。它跟踪的是已经足够清晰、可以直接执行的工作——一份支持报告、一个缺陷、一个小任务。它擅长处理队列。它不擅长展示一个新想法如何融入整体。

当改动既不实质也不复杂时,跳过意图页面。一个小修复不需要它。用户提交的支持工单仍然需要,但作为工单:有人报告了问题,团队需要一个地方来跟踪它。一份已经说明了原因和内容的错误日志产物,可以代替缺陷、无需单独的提案。Issue tracker 在这条路径上仍然有用。但对于一个过去会成为两周 epic 的新产品想法,它们是错误的默认形态。

我预计连「某个东西坏了」这条路径也会进一步收缩。Agent 可以监听错误日志,并在下一个发布周期里开出修复,无需人先开一张卡。对于用户报告的问题,工单不会消失。它消失的是作为每一次改动的默认形态。

Spec-first 说的是:更新规格说明,然后实现。这保持了单一文档的权威。它也迫使每一个有意义的改动都经过最重的产物,即使你需要的只是就某一个提案达成一致。

对于复杂工作,intention-first 说的是:写提案页面,做决定,实现。随着时间推移,维护这些页面的目录。当你需要契约视图时——为客户、为监管方、或为冷启动入职——可以从意图日志加上决策记录中派生出更完整的规格说明。你并不是被禁止拥有 spec。你只是不再假装 spec 是改动唯一可以开始的地方。

这就是实际的取舍。Spec-first 优化的是单一始终最新的契约。意图日志优化的是廉价、可评审的提案,并把完整 spec 当作一个视图,在它值得其成本时再重建。

一旦提案以 HTML 形式进入 git,代码就可以被视为该意图的衍生物。可以把同一个页面交给不同的模型,要求它们产出实现。你保留符合意图和测试的那一次运行。其余的丢掉。页面没有变;变的是尝试。

因为意图与代码在同一个仓库里,任何快照都同时包含两者。你可以回到某个 commit,重建当时意图的东西——或者针对那个冻结的页面重新生成一个候选实现。当「我们当时想做什么」的唯一记录是被原地改写的工单,或者是一条已经过期、无法追溯的 Slack 讨论串时,这就难多了。

这种配对在失败之后同样有帮助。这次更新的意图页面,加上属于这次更新的 bug 或错误日志,构成一对干净的训练与诊断样本:我们想做什么,以及相对于那个意图出了什么问题。一个工单标题加一段 stack trace 则更单薄。一段聊天记录加一段 stack trace 则更嘈杂。

这并不意味着生产代码的每一行都必须有一个页面。它意味着,当你确实需要一份提案时,你应该能够永远指向它,就在声称实现了它的代码旁边。

同一个页面可以在评审中回答两个问题:我们是否构建了我们想构建的东西,以及实际使用是否仍然与之相符?在「每层一个评审者」的框架里,那就是 Layer 0(意图)和 Layer 5(使用):改动是否解决了所陈述的问题,以及组装起来的系统是否仍然符合人们的使用方式。

当没有意图页面时,会有别的东西来代替:用户提交的工单,或者一份错误日志产物。这是对的。意图页面适用于改动是一个提案、而非一个明确缺陷的时候。

架构决策记录(ADR)记录一项技术选择及其原因。业务领域也需要同类的记录:我们为产品决定构建或改变什么,与代码如何组织无关。我把它叫做 BDR——业务决策记录。与 ADR 职责相同,领域不同。

transcript-decisions 是我用来做 BDR 的 skill。你把一次通话、一份聊天导出,或一份由负责人撰写的意图页面交给 agent。它会提出对 DECISIONS.md 的更新,并且只写入你批准的那些行。那些行就是当前生效的内容和仍然待定的内容。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →