Guide

为什么你的AI智能体总是在构建错误的东西?

AI

AI Skills Team

6/14/2026 1 min

问题:你的AI智能体是个快速但错误的构建者

上个月,我在一个项目中工作,试图给一个网页应用添加一个简单的通知功能。我告诉我的AI编程智能体:“添加一个用于用户警报的通知系统。”智能体立即开始编写代码。几分钟内,它就搭建了一个复杂的、基于WebSocket的实时通知中心,包含完整的数据库架构、用户偏好设置和头部导航栏的铃铛图标。

问题是什么?我只是需要一个用于密码重置的简单邮件通知。

这是一个常见的痛点。AI智能体在生成代码方面非常强大,但它们通常缺乏在开始构建之前理解要构建什么的关键步骤。它们直接从一个模糊的想法跳到实现,导致:

  • 浪费时间和代币在最终被丢弃的代码上。
  • 功能错位,无法解决实际的用户问题。
  • 范围蔓延,简单的任务膨胀成复杂的系统。
  • 开发者和AI都感到沮丧,对话演变成一系列的纠正。

根本原因在于缺少设计阶段。人类在编码前会自然地思考需求、约束和权衡。而AI智能体默认优化的是速度和生成,而不是协作式的澄清。它们将每个请求都视为直接执行的指令,而不是对话的开始。

一个好的解决方案需要强制暂停。它应该创建一个结构化的对话,让智能体探索你的意图、提出澄清性问题、提议不同的方法,并在编写任何代码之前获得你对设计的明确批准。这能将智能体从一个快速、自主的编码者转变为一个协作的设计伙伴。

为AI智能体引入头脑风暴技能

这就是头脑风暴技能的用武之地。它不是一个代码生成器或UI组件库。它是一个流程技能——一组指令,告诉你的AI智能体在开始任何创造性或实现工作之前应该如何行动。

可以把它想象成智能体的强制性飞行前检查清单。激活后,智能体需要:

  1. 首先探索项目上下文(查看现有文件、文档和最近的提交)。
  2. 一次提出一个澄清性问题,以理解你的真实意图、约束和成功标准。
  3. 提出2-3种不同的方法,并附带清晰的权衡分析和推荐方案。
  4. 呈现一个结构化的设计供你批准,逐节进行。
  5. 只有在你批准后,才编写并提交正式的设计规格说明。

只有在整个过程完成后,智能体才会过渡到实现阶段,调用一个单独的“编写计划”技能。这在设计和执行之间创建了一个硬性关卡。

该技能的核心理念体现在其反模式警告中:“这太简单了,不需要设计。” 即使对于一个“简单”的待办事项列表或配置更改,这个过程也会迫使你审视假设。一个简单功能的设计可能只是几句话,但将其写下来并获得批准的行为,可以防止最常见的浪费工作类型:构建了错误的简单东西。

这个技能如何改变你的工作流程

没有这个技能时,典型的互动可能是这样的:

你: “添加一个深色模式切换。”
智能体: 立即开始修改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上的时间比和它一起编码的时间还多,那么这个技能值得你认真考虑。

你可以在头脑风暴技能页面上探索完整的详细信息和实现说明。

延伸阅读