AIHero

    交接

    Spec

    一种描述跨多个会话工作的交接产物,说明要构建什么,而不是每个会话具体如何完成自己的部分;它由多个任务单组成。

    Matt Pocock
    Matt Pocock

    规格说明是一种交接产物,用于描述一项跨多个会话的工作:说明要构建什么,而不是每次会话具体怎样完成自己的部分。它会随着工作推进持续变化,并由多个任务组成。

    规格说明之所以存在,是因为会话可以随时丢弃,大型工作却不能。凡是需要超过一个上下文窗口才能完成的任务,都需要在上下文之外拥有一个长期载体——位于智能体环境中,能够在清空后继续存在;它可以是仓库中的文件、GitHub issue,或智能体能够访问的任务跟踪器。规格说明就是这个载体:其中记录目标、约束、截至当前作出的决策,以及任务列表和各自状态。任何全新会话都能读取它,立即了解工作进展,而无需继承上一会话累积的噪声。

    规格说明有一些常见形式,大多沿用团队原有的记录方式。产品需求文档(PRD)更偏向用户视角的“做什么”和“为什么”——功能、行为和验收标准;设计文档或 RFC 更偏技术——选定的方案、被否决的备选方案以及其中权衡。规模较小时,一份带任务检查清单的普通 plan.md,也能为跨会话功能完成同样工作。形式不如角色重要:对智能体而言,它们都是同一类东西——一份持久的意图声明,每次会话开始时都会读取。

    用法:

    “这些工作都应该放在一次会话里完成吗?”

    “不,把它写成规格说明——拆成多个任务,每个任务在自己的会话中执行。如果试图在单一上下文里完成全部工作,还没做到一半就会进入迟钝区。”

    不只想学术语?

    加入 AI Hero,获取实用技能、AI 工程思考,以及帮助你始终走在前沿的资源。

    没有垃圾邮件,随时可以退订。

    分享