RSS EN
⌕
GENERAL // 专业

用 Claude Code + OpenSpec + 多角色 Agent 开发软件项目

一份从 0 到自治化开发流水线的深度实战教程。本教程通过 doc2video 案例项目，深入讲解如何利用 Claude Code 与 OpenSpec 规约体系，构建具备多角色协同能力的 AI 自动化开发流水线。

课时目录 // CURRICULUM

课程内容

01

第 01 章 | 为什么需要 AI + 规约 + 多角色

读完这一章，你能用三句话向同事讲清楚为什么不该让 Claude Code 一把梭写完整个项目。

[4 分钟阅读 // READ →]
02

第 02 章 | 案例项目 doc2video 全貌

理解整个教程要做的项目。这样后续每个抽象概念你都能对应到具体场景。

[4 分钟阅读 // READ →]
03

第 03 章 | 心智模型——三层架构

掌握'工具/知识/治理'三层模型，后面所有章节都对应到这张图上。

[5 分钟阅读 // READ →]
04

第 04 章 | 环境准备清单

确认你的机器装好了运行 doc2video 项目所需的所有先决条件。

[5 分钟阅读 // READ →]
05

第 05 章 | 安装 Claude Code

跑起 `claude` 命令，完成第一次对话。

[4 分钟阅读 // READ →]
06

第 06 章 | 安装 OpenSpec

让你的项目目录获得 OpenSpec 的规约能力。

[5 分钟阅读 // READ →]
07

第 07 章 | OpenSpec 的世界观

理解为什么 OpenSpec 不是'普通文档系统'——而是一套**规约的版本管理系统**。

[6 分钟阅读 // READ →]
08

第 08 章 | 用 `/opsx:explore` 探索想法

学会'先想清楚再动手'——用 explore 模式把模糊想法澄清成可执行决策。

[5 分钟阅读 // READ →]
09

第 09 章 | 决策即取舍

学会用'决策矩阵'思维，把'我想做 X' 变成'为了 X 我接受 Y 的代价'。

[5 分钟阅读 // READ →]
10

第 10 章 | 用 `/opsx:propose` 提出变更

跑一次 `/opsx:propose`，得到完整的 4 件套：proposal / design / specs / tasks。

[8 分钟阅读 // READ →]
11

第 11 章 | 编写 design.md

把 explore 时聊出的所有决策，落成一份能让 reviewer 三个月后仍能检查的文档。

[6 分钟阅读 // READ →]
12

第 12 章 | 编写 spec——Requirement 与 Scenario

写出可**测试**的契约。每个 Scenario 都该能成为一个 pytest 函数。

[9 分钟阅读 // READ →]
13

第 13 章 | 编写 tasks.md

把 spec 翻译成可执行的'组'——dispatch 的最小单位。

[6 分钟阅读 // READ →]
14

第 14 章 | subagent 是什么

理解 subagent 与 main Claude 的关系，知道 dispatch 的代价和价值。

[5 分钟阅读 // READ →]
15

第 15 章 | 角色分工——避免'全能 agent'陷阱

学会按职责拆 agent，让多个 agent 互相制衡而不是各自圈地。

[7 分钟阅读 // READ →]
16

第 16 章 | 编写 agent 文件

写出**真的能被 main Claude 找到并 dispatch** 的 agent 文件。

[7 分钟阅读 // READ →]
17

第 17 章 | 模型选择策略

按角色配模型，避免'全 opus 烧钱'或'全 sonnet 卡壳'。

[6 分钟阅读 // READ →]
18

第 18 章 | 进阶——escalation 与 architect

掌握'卡住自动升级'模式，让多 agent 系统在难题面前不断进化而不是死循环。

[9 分钟阅读 // READ →]
19

第 19 章 | CLAUDE.md——项目宪法

写一份让任何 main Claude 进入项目都能立刻按规则办事的 CLAUDE.md。

[9 分钟阅读 // READ →]
20

第 20 章 | 基于文件的状态机

理解为什么状态要存在文件里而不是 main Claude 的'记忆'里——这是系统从'玩具'变'生产级'的分水岭。

[10 分钟阅读 // READ →]
21

第 21 章 | 自定义 slash 命令 `/dev`

把'编排逻辑'封装成一个可由用户敲一次触发的命令。

[10 分钟阅读 // READ →]
22

第 22 章 | 触发模式——半手动 + 全自动

让 /dev 在'完全可控'和'完全放手'之间灵活切换。

[8 分钟阅读 // READ →]
23

第 23 章 | settings.json 全景

搞清楚 4 种 settings 文件的优先级和用途，能给团队 / 个人 / 实验各放对地方。

[7 分钟阅读 // READ →]
24

第 24 章 | permission 模式

让 Claude Code 不再每步问你，但能在危险动作上自动拦。

[7 分钟阅读 // READ →]
25

第 25 章 | PreToolUse hook——动态校验

写出能拦截'看似合法实则危险'的 bash 命令的脚本。

[9 分钟阅读 // READ →]
26

第 26 章 | Stop hook——通知集成

让 main Claude 完成一段输出后主动通知你（Telegram / Slack / Email）——你能离开电脑也不丢进度。

[11 分钟阅读 // READ →]
27

第 27 章 | 第一次跑 `/dev`

把前 26 章学的东西连起来，跑出第一行真实代码。

[6 分钟阅读 // READ →]
28

第 28 章 | 调试与故障排查

知道哪里看 + 怎么修，独立解决 90% 的常见问题。

[7 分钟阅读 // READ →]
29

第 29 章 | 沙盒选择

知道何时上 Docker、何时不上、能怎么妥协——基于你项目的实际约束。

[6 分钟阅读 // READ →]
30

第 30 章 | 进阶——团队、CI、扩展

把这套搬到其他场景：多人、CI、新角色。

[20 分钟阅读 // READ →]