写好一份 Spec 的实战手册
本文属于「AI 时代的编码新范式」系列,旨在解答在 AI Agent 开发中如何编写 Spec。文章首先厘清了 Spec 与 PRD、设计文档及用户故事的区别,指出 Spec 应定义软件行为而非描述需求。接着提出了 Spec 的五要素:目标、约束、边界、验收标准和技术上下文。最后倡导从三句话开始,将 Spec 视为随项目生长的活文档,以提高 Agent 开发的准确性和安全性。
本文属于「AI 时代的编码新范式」系列,旨在解答在 AI Agent 开发中如何编写 Spec。文章首先厘清了 Spec 与 PRD、设计文档及用户故事的区别,指出 Spec 应定义软件行为而非描述需求。接着提出了 Spec 的五要素:目标、约束、边界、验收标准和技术上下文。最后倡导从三句话开始,将 Spec 视为随项目生长的活文档,以提高 Agent 开发的准确性和安全性。
本文介绍了Lyft联合创始人Matt Van Horn在不读写代码的情况下,利用Claude Code和Codex构建开源项目并登顶GitHub Trending的九条规则。规则包括快速发布、编写计划、信任Agent、优化使用成本、提供CLI工具、让工具自记笔记等,展示了非程序员如何高效利用AI进行开发。
文章指出许多人学习 AI Agent 时陷入了“工具焦虑”,盲目追逐 LangChain、MCP 等框架,却忽视了 Agent 的本质是一套围绕目标运行的系统。作者强调,真正的难点在于系统设计——理解工具调用、记忆、反馈修正及工程化约束,而非仅仅跑通 Demo。文章推荐 GitHub 项目 agent_learning,主张从 LLM 基础、Prompt 等底层原理开始,逐步构建从基础到工程化的完整知识体系,最终实现 Agent 在真实环境中的稳定运行。
文章深入探讨了为何单一提示词不足以完成复杂的 AI 任务,并详细介绍了如何设计一个能够自主运行直到任务完成的“循环”。作者提出了构建循环的五个核心步骤:定义“完成”标准、构建上下文而非指令、让 Agent 行动并捕获结果、利用反馈闭合循环、以及设置停止条件。文章强调了从手动编写提示词转向构建自动化规则系统的重要性。
本文是一份面向开发者的 AI 产品构建实战指南。作者指出,仅将 AI 作为自动补全工具在复杂项目中会失效,真正的变革在于构建一套可复用的 'Harness' 系统。文章详细介绍了如何通过 .agent 目录结构(包含 AGENTS.md、SKILLS 等)将任务规格转化为可执行的软件,涵盖从规划、实现到验证的核心循环,并提供了适用于 SaaS、MCP 服务及 iOS 应用的通用工作流模板。
文章深入解读了 GitHub 上的热门开源库 agency-agents。它并非独立的 AI 应用或平台,而是一套“AI 专家角色模板库”(Prompt 模板)。其核心价值在于将 AI 的角色标准化,通过定义前端、后端、产品经理等不同“工牌”,解决通用 AI 角色不稳定的问题。该库支持 Claude Code、Cursor 等多种工具,将 AI 从“泛泛聊天”转变为“专业干活”,是理解 Agent 工作流设计的优秀案例。