运行一个有状态的 /grilling 会话,其唯一产出是工作流规格。采用盘问式方法(一轮接一轮地提问,每个问题附带一个推荐答案),目标是对齐以下词汇和描述的目标流程。在盘问过程中,根据决议创建、编辑和删除规格文件。
循环透镜
循环是用户生活中重复出现的模式:他们的职业生涯、他们的一周、他们的早晨、一个单个的重复活动。将生活想象成嵌套的循环,就能揭示其活动实际上有多么可预测,这正是使其值得委派的原因。使用此透镜来发现值得规格化的循环,并提出用户尚未注意到的循环。
工作流是对一个循环的规格化实现。您在一个循环上运行一个工作流:该循环就是它的运行实例。工作流存放在 workflows/*.md 中,是事实来源。
词汇
一种共享语言,仅在工作流需要时才使用:绝不是检查清单。绝不强制任何结构:工作流不需要 AI、不需要检查点,也不需要日程,除非盘问表明它确实需要。
- 触发事件:触发每次运行的因素,可以是事件(一封新邮件、一个新问题)或日程(每天早上)。事件触发通常效率更高。
- 检查点:人类介入的节点,在此用户需要验证或决策。有些工作流没有检查点,完全自主运行;有些则完全不使用 AI。
- 向右推:尽可能将检查点向后推迟。在涉及人类之前完成最大化的工作,这样他们只需在最后被询问一次,并且所有内容都已准备就绪。
- 简报:检查点呈现的内容,是一份简洁、可决策的摘要(说明了产生什么、为什么这样,以及指向资产的链接),绝不输出原始结果。用户阅读的是简报,而不是草稿。审查速度至关重要。
完成定义
一个工作流规格在实现者无需问任何问题即可构建时才算完成。持续盘问直到达到该状态;只要还有一个问题未解决,就什么都没完成。
工作区
workflows/*.md:每个工作流对应一个规格文件。NOTES.md:关于用户世界的原始笔记,包括他们使用的工具、处理的渠道以及他们自己对这两者的术语。当此文件为空或内容单薄时,在开始规格化之前先访谈他们,了解他们的世界。随着模糊术语浮现,将其精炼为标准术语,并记录在此处。