如何撰写AI代理的高效Spec？

编写一份清晰、高效的spec对于AI代理理解和执行任务至关重要。本文将探讨如何撰写一份优秀的spec，以确保AI代理Neng够准确、高效地完成任务。

Spec阶段是整个流程的基础，你需要提供关于“要构建什么、为什么要构建”的high-level描述。AI代理将根据这些信息生成详细的spec。这不是讨论技术栈或应用设计，而是关注用户旅程、体验，以及“成功长什么样”。

关键要点： 提供清晰的目标陈述和核心需求，让AI代理从中生成geng详尽的spec。

为了避免上下文过载和“指令诅咒”，应将大任务拆解为小任务，并为每个任务提供相应的spec部分。这有助于AI代理保持专注，避免无关信息的干扰。

实践方法： 手动强制模块化，例如将spec写完后只给agent提供spec的数据库部分，加上spec中的任何全局约束。

一份优秀的spec应该包含以下核心领域：目标、功Neng、约束条件、技术栈、项目结构、边界条件等。将spec视为一份结构化文档，包含清晰的章节，而不是一堆松散的笔记。

示例：

# Project spec: My team's tasks app
## Objective
- Build a web app for small teams to manage tasks...
## Tech Stack
- React +, TypeScript, Vite, Tailwind CSS
- Node.js/Express backend, PostgreSQL, Prisma ORM
## Commands
- Build: `npm run build` 
- Test: `npm test` 
- Lint: `npm run lint --fix` 
## Project Structure
- `src/` – Application source code
- `tests/` – Unit and integration tests
- `docs/` – Documentation
## Boundaries
- ✅ Always: Run tests before commits, follow naming conventions
- ⚠️ Ask first: Database schema changes, adding dependencies
- 🚫 Never: Commit secrets, edit node_modules/, modify CI config

对于复杂的项目，Ke以使用多个专门的子agent，每个子agent负责特定的领域，并只拿到与该领域相关的那部分spec。这有助于提高准确性，并允许在相互独立的任务上并行工作。

Spec一旦通过应保存这份spec，并根据需要将相关部分提供给AI代理。这缓解了当对话历史过长或必须重启agent时可Neng发生的“健忘”问题。

明确定义AI代理不应接触的内容，如密钥、vendor目录、生产环境配置等。同时定义约束条件，如“永远不要提交密钥”。

撰写一份高效的spec需要关注目标、用户旅程、技术栈、项目结构等核心领域。通过模块化的方式设计spec和工作流，Ke以提高AI代理的准确性和效率。同时利用子agent或“技Neng”处理不同spec部分，Ke以进一步提高并行工作的Neng力。Zui终，将spec用作上下文，并明确边界条件和约束，Ke以确保AI代理在正确的轨道上运行。

保持目标导向： 关注是什么和为什么而不是细枝末节的怎么Zuo。

使用Plan Mode： 在Plan Mode下启动，让AI代理分析代码库并创建详细计划。

迭代聚焦： 将复杂需求拆成顺序执行的简单指令，让AI代理一次只专注于一个子问题。

使spec成为“活文档”： 及时geng新spec，以反映项目的Zui新状态。

太长不kan版： 目标是撰写一份清晰的spec，包含恰到好处的细节，既Neng引导AI，又不会因信息过载而导致模型迷失方向。将大任务拆解为小任务，而不是将所有内容dou塞进一个巨大的prompt中。先在只读模式下规划，再执行，并持续迭代。

希望这篇文章对您有帮助！