问题:你的AI智能体是个快速但错误的构建者
上个月,我在一个项目中工作,试图给一个网页应用添加一个简单的通知功能。我告诉我的AI编程智能体:“添加一个用于用户警报的通知系统。”智能体立即开始编写代码。几分钟内,它就搭建了一个复杂的、基于WebSocket的实时通知中心,包含完整的数据库架构、用户偏好设置和头部导航栏的铃铛图标。
问题是什么?我只是需要一个用于密码重置的简单邮件通知。
这是一个常见的痛点。AI智能体在生成代码方面非常强大,但它们通常缺乏在开始构建之前理解要构建什么的关键步骤。它们直接从一个模糊的想法跳到实现,导致:
- 浪费时间和代币在最终被丢弃的代码上。
- 功能错位,无法解决实际的用户问题。
- 范围蔓延,简单的任务膨胀成复杂的系统。
- 开发者和AI都感到沮丧,对话演变成一系列的纠正。
根本原因在于缺少设计阶段。人类在编码前会自然地思考需求、约束和权衡。而AI智能体默认优化的是速度和生成,而不是协作式的澄清。它们将每个请求都视为直接执行的指令,而不是对话的开始。
一个好的解决方案需要强制暂停。它应该创建一个结构化的对话,让智能体探索你的意图、提出澄清性问题、提议不同的方法,并在编写任何代码之前获得你对设计的明确批准。这能将智能体从一个快速、自主的编码者转变为一个协作的设计伙伴。
为AI智能体引入头脑风暴技能
这就是头脑风暴技能的用武之地。它不是一个代码生成器或UI组件库。它是一个流程技能——一组指令,告诉你的AI智能体在开始任何创造性或实现工作之前应该如何行动。
可以把它想象成智能体的强制性飞行前检查清单。激活后,智能体需要:
- 首先探索项目上下文(查看现有文件、文档和最近的提交)。
- 一次提出一个澄清性问题,以理解你的真实意图、约束和成功标准。
- 提出2-3种不同的方法,并附带清晰的权衡分析和推荐方案。
- 呈现一个结构化的设计供你批准,逐节进行。
- 只有在你批准后,才编写并提交正式的设计规格说明。
只有在整个过程完成后,智能体才会过渡到实现阶段,调用一个单独的“编写计划”技能。这在设计和执行之间创建了一个硬性关卡。
该技能的核心理念体现在其反模式警告中:“这太简单了,不需要设计。” 即使对于一个“简单”的待办事项列表或配置更改,这个过程也会迫使你审视假设。一个简单功能的设计可能只是几句话,但将其写下来并获得批准的行为,可以防止最常见的浪费工作类型:构建了错误的简单东西。
这个技能如何改变你的工作流程
没有这个技能时,典型的互动可能是这样的:
你: “添加一个深色模式切换。”
智能体: 立即开始修改CSS变量,添加切换组件,并设置本地存储持久化。
你: “等等,我现在只想要一个简单的CSS类切换。”
激活头脑风暴技能后,对话变成了协作式的:
你: “添加一个深色模式切换。”
智能体: “让我先检查一下当前的项目结构……我看到我们使用的是React和Tailwind CSS。在我设计之前,有几个问题:这个偏好设置需要跨会话持久化吗?最初是否应该跟随操作系统的系统级偏好?范围是什么——只是主应用外壳,还是包括所有第三方组件?”
你: “目前只做应用外壳,是的,需要持久化。”
智能体: “好的。我看到两种主要方法:1)使用Tailwind的dark:变体和一个简单的上下文提供者,或者 2)使用CSS自定义属性以获得更细粒度的控制。我推荐方案1,以实现更快的实现。这是设计:一个ThemeProvider上下文将管理状态,头部的一个Toggle组件将切换它,我们将使用localStorage进行持久化。这个部分看起来对吗?”
这种转变是深刻的。你从错误的纠正者变成了流程的指导者。智能体的智能被引导到理解和规划上,而不仅仅是生成。
何时使用此技能(以及何时不用)
在以下情况下使用此技能:
- 你正在开始任何新的功能、组件或重要的修改。
- 请求是模糊的,或者可以有多种解释。
- 你希望避免范围蔓延,并确保智能体完全构建你需要的东西。
- 你在团队中工作,需要记录设计理由。
- 任务涉及UI/UX、架构决策或行为变更。
在以下情况下此技能可能有些多余:
- 你正在执行一个纯粹机械的、定义明确的任务(例如,“到处重命名这个变量”、“运行测试套件”)。
- 你正在修复一个单一的、明显的错误,其解决方案清晰且唯一。
- 你处于快速原型设计阶段,探索速度比正确性更重要,并且你愿意频繁地丢弃代码。
该技能的仓库指出,它是为“创造性工作”设计的。如果任务没有创造性模糊性——没有“我们应该如何构建这个?”的问题——它可能不需要这个流程。
使用前需要检查什么
在将此技能集成到你的智能体工作流程之前,请考虑以下几点:
1. 流程开销
这个技能增加了步骤。对于一个微不足道的任务,它可能会感觉很慢。评估一下,通过避免返工节省的时间是否超过了在设计对话中花费的时间。对于大多数非平凡的功能,答案是肯定的。
2. 仓库信号
该技能来自obra/superpowers仓库,拥有相当多的星标(227k+),表明社区验证度很高。许可证是宽松的。但是,务必自己查看SKILL.md文件,以理解它强制执行的确切流程。该技能的着陆页提供了一个很好的概述。
3. 安全性与控制
该技能包含一个硬性关卡指令:智能体不得在设计获得批准之前调用任何实现技能。这是一个关键的安全特性,让你保持控制。它还包括一个“规格自审”步骤,智能体在你看到之前就会检查自己的设计文档是否存在占位符、矛盾和模糊之处。
4. 与你的工具集成
该技能假设在一个开发环境中,智能体可以读取文件(check files, docs, recent commits)并写入文档(save to docs/superpowers/specs/...)。请确保你的智能体设置支持这些操作。最后一步会调用一个“编写计划”技能,因此你需要该技能(或类似的技能)可用,以完成整个循环。
5. 适应性
该过程是一个框架,而不是一个僵化的脚本。智能体被指示“根据复杂性调整每个部分的篇幅”。一个关于按钮颜色更改的设计将是一个简短的对话;一个关于新认证系统的设计将是一个详细的文档。该技能会适应范围。
核心要点
强大的AI编程智能体最大的风险不是它们慢——而是它们在错误的方向上很快。头脑风暴技能充当了一个必要的断路器,插入了一个人在回路中的设计阶段,使智能体的输出与你的真实意图保持一致。
它将智能体从一个自主的编码者转变为一个协作伙伴。结果是更少的浪费精力、更好架构的解决方案,以及一个让你感觉掌控一切的开发流程。如果你曾经觉得花在纠正AI上的时间比和它一起编码的时间还多,那么这个技能值得你认真考虑。
你可以在头脑风暴技能页面上探索完整的详细信息和实现说明。