AI 摘要：本文记录了作者在 AI 辅助开发中的经验演进，从早期的代码补全，到通过 OpenSpec 实现规范驱动的团队协作。OpenSpec 以“提案 + 规范”的模式，把每一次改动都变成可追溯的结构化流程，AI 不再仅是执行命令的工具，而能成为能理解上下文、可协作的开发伙伴。作者通过完整示例展示了 OpenSpec 的安装、初始化、提案、审阅与归档过程，强调“规范文件”才是项目的核心资产。

1. AI 工具有机演进
• 从“补全时代”进化到“智能时代”，AI 角色由被动助手变为主动协作者。
• “洪荒—集成—增强—智能”四个阶段反映了工具从 Copilot、Cursor 到具备 MCP（Model Context Protocol）能力的 AI Agent 的演变。

2. 团队协作的痛点与 OpenSpec 的出现
• 团队在长对话中易出现上下文串台与信息丢失问题。
• OpenSpec 通过结构化的 proposal.md 让每次变更有清晰的 Why / What / How / Impact 记录。
• 规范驱动的文档体系保证项目约定可持久化，AI Agent 与新成员都能即刻理解项目背景。

3. 开发者角色的转变
• 开发者不再在指令层面操作 AI，而转为扮演“产品经理”或“团队 Leader”。
• 人负责提需求与审核，AI 负责起草与执行，实现工作分层与效率最大化。

4. OpenSpec 实践全流程
• 安装与初始化：通过 npm 安装并生成 openspec 项目结构（含 project.md、AGENTS.md、specs/、changes/ 等）。
• 创建提案：AI 根据指令生成 proposal.md、tasks.md、spec.md，记录需求、任务与标准。
• 提案打磨：人机协作循环评审，持续优化内容与规范。
• 实施与归档：AI 自动执行 openspec apply / archive 命令，所有过程留痕，形成项目知识库。

5. 实践心得与优势
• 使用者只需掌握 OpenSpec 流程，具体命令和实现由 AI 代劳。
• 项目文档成为最核心资产，使团队协作与知识传递更高效、透明、可靠。
• OpenSpec 提供了开发团队与 AI 共建标准化流程的现实范例。

GitHub

GitHub - Fission-AI/OpenSpec: Spec-driven development for AI coding assistants.

Spec-driven development for AI coding assistants. Contribute to Fission-AI/OpenSpec development by creating an account on GitHub.