用 Claude Code + OpenSpec + 多角色 Agent 开发软件项目
解密 AI 时代的软件工程:本教程带你超越简单的‘提示词工程’,步入‘规约驱动的多 Agent 协作’新境界。通过完整的 doc2video 案例,你将亲手构建一套基于 Claude Code 与 OpenSpec 的自治化流水线,掌握多角色制衡、基于文件的状态机、以及自动化纠偏与升级机制。无论是构建中型工具还是生产级 SaaS,这套‘治理+规约+工具’的三层架构都将是你实现‘AI 协同率 > 90%’的杀手锏。
开始学习
课程目录
01
第 01 章 | 为什么需要"AI + 规约 + 多角色"
读完这一章,你能用三句话向同事讲清楚为什么不该让 Claude Code 一把梭写完整个项目。
02
第 02 章 | 案例项目 doc2video 全貌
理解整个教程要做的项目。这样后续每个抽象概念你都能对应到具体场景。
03
第 03 章 | 心智模型——三层架构
掌握"工具/知识/治理"三层模型,后面所有章节都对应到这张图上。
04
第 04 章 | 环境准备清单
确认你的机器装好了运行 doc2video 项目所需的所有先决条件。
05
第 05 章 | 安装 Claude Code
跑起 `claude` 命令,完成第一次对话。
06
第 06 章 | 安装 OpenSpec
让你的项目目录获得 OpenSpec 的规约能力。
07
第 07 章 | OpenSpec 的世界观
理解为什么 OpenSpec 不是"普通文档系统"——而是一套**规约的版本管理系统**。
08
第 08 章 | 用 `/opsx:explore` 探索想法
学会"先想清楚再动手"——用 explore 模式把模糊想法澄清成可执行决策。
09
第 09 章 | 决策即取舍
学会用"决策矩阵"思维,把"我想做 X" 变成"为了 X 我接受 Y 的代价"。
10
第 10 章 | 用 `/opsx:propose` 提出变更
跑一次 `/opsx:propose`,得到完整的 4 件套:proposal / design / specs / tasks。