Specsmaxxing 爆火：YAML 写需求成为 AI 编程新范式
Acai.sh 发布开源工具包，作者提出「Specsmaxxing」理念——用 YAML 写功能规格说明书，让 AI Agent 告别「精神分裂」，保持跨会话的一致性。文章登上 Hacker News 首页首位。
2026年5月3日 · 阅读约 4 分钟
核心结论
2026 年 5 月 3 日，开发者 Brendan 在 Hacker News 发表题为「Specsmaxxing」的爆款文章，提出用 YAML 格式的功能规范文件（feature.yaml） 作为 AI Agent 编程的「持久化记忆」，解决 AI 代码生成中常见的「AI 精神分裂」问题。其开源的 acai.sh 工具包登上 HN 首页首位，获 85+ 点赞和 65+ 激烈讨论。
关键要点
- 事件时间：2026-05-03，文章登上 Hacker News 首页 #1
- 核心概念：Specsmaxxing = Spec（规范）+ Maxxing（极致化），指用 YAML 写验收标准
- 影响对象：使用 AI Agent（Claude Code、OpenAI Codex、Cursor 等）的开发者团队
- 开源工具：acai.sh — 基于 YAML 的规范驱动开发工具包（Elixir + TypeScript）
背景：AI 生成代码的「精神分裂」问题
任何使用 AI Agent 编写过代码的人，都经历过这个场景：你让 Claude 或 GPT 生成一个功能，来回几次迭代后功能完美跑通。然后你关闭会话、第二天重新打开，AI 不仅忘了昨天的需求、连架构决策也丢得一干二净。
这种被作者称为 "AI 精神病"（AI Psychosis） 的现象，根源不在于模型变笨了，而在于规范（Spec）没有持久化。开发者的需求原本存在脑子里，但 AI 没有长期记忆。
"上下文窗口就是天花板。当你填满上下文、或者 kill 掉会话，最重要的细节就被压扁了。" — Brendan
作者认为，既然代码本身已经无法完全承载设计意图（AI 生成的代码缺少"作者记忆"），那就必须把规范写在一个 AI 和人都能读取的地方——YAML 文件。
关键影响
| 维度 | 变化 | 对我们意味着什么 | 建议行动 |
|---|---|---|---|
| 开发流程 | 从「聊天式编程」转向「规范驱动开发」 | AI Agent 工作流需要引入结构化需求文件 | 在项目中引入 feature.yaml |
| 团队协作 | 规范对人和 AI 透明 | 新成员/AI 都能快速理解功能边界 | 将规范纳入 CI 流程 |
| 工具链 | 需要 spec→code 映射工具 | acai.sh 这类工具成为新基建 | 尝试 acai.sh CLI |
| 上下文管理 | AI 不再「失忆」 | 跨会话一致性大幅提升 | 用 YAML 替代 markdown 清单 |
Acai.sh 是怎么工作的
Acai.sh 是 Brendan 为其同名公司开发的开源规范驱动开发工具包，包含四个步骤：
- Specify（规范）：在项目中创建
.feature.yaml文件，用声明式格式描述功能需求 - Ship（交付）：AI Agent 根据 YAML 规范生成代码，确保每次交付覆盖所有验收标准
- Review（审查）：AI 生成的代码自动对照 YAML 规范做回归验证
- Iterate（迭代）：更新 YAML 文件后重新生成，不再依靠「幻觉式记忆」
适配建议
对于正在使用 Claude Code、OpenAI Codex、Cursor、OpenClaw 等 AI Agent 工具的开发者，可以立即尝试以下实践：
- 在项目中创建
features/目录，用 YAML 文件替代口述需求 - 每个 feature.yaml 包含：功能名称、验收标准列表、边界条件
- 将 YAML 文件作为 AI Agent 的 system prompt 上下文输入
- 每次迭代后更新 YAML 文件，而非只在聊天窗口里追加
快速入门（示例）
# feature/user-authentication.yaml
name: User Authentication
acceptance_criteria:
- Users can sign up with email and password
- Password must be at least 8 characters
- Email verification is sent within 30 seconds
- Rate limit: max 5 attempts per minute社区反响
HN 评论区对该理念普遍持正面态度。有开发者指出AI 生成代码缺乏机构记忆（Institutional Memory），"代码是 AI 写的，但没人能解释为什么要这么做"。Specsmaxxing 正是对这个问题的最直接回应——用规范弥补记忆缺口。
也有开发者分享了更务实的替代方案：在 Git commit message 中绑定 JIRA ticket ID，通过 ticket 追溯原始需求。但这恰恰证明，规范必须持久化这个方向是行业共识。
延伸阅读
工具词条
正文中出现以下词条，平台侧会自动匹配已有工具库：Claude Code、OpenAI、Claude、ChatGPT、Cursor、OpenClaw、GitHub
内链引导
- 想系统学习用 AI Agent 开发？看：AI Agent 工具实操教程：从安装到自动化工作流
- 有人用 AI Agent 方法论 48 小时做出月入 $9,000 的 SaaS：真实案例：Claude Code 48 小时创业