我如何使用 Claude Code 构建文档驱动开发工作流

Source: Dev.to

GitHub:
Docs:

问题

在大多数团队中：

• PM 在某处（Notion、Jira、Google Docs）编写需求
• 开发者阅读后自行假设并实现功能
• QA 测试……到底依据什么？
• Bug 被提交，指责四起

文档与实际脱节，没人再知道哪份是正确的。

解决方案：文档即代码

如果规范文件 本身 就是唯一真相，AI 直接读取它会怎样？

PM/BA: /write-spec user-export     → creates docs/user-export/spec.md
Dev:   /develop-feature user-export → Claude reads spec, builds feature

就是这么简单。没有传话游戏。Claude 读取的就是 PM 编写的同一份规范。

工作原理

• PM 运行 /write-spec – Claude 提问并生成结构化规范。
• 开发者运行 /develop-feature – Claude 读取规范并在完整上下文中构建功能。
• GitHub Actions 通知 – 当规范变更时，团队保持同步。

没有来回沟通。没有 “你说的 X 是什么意思？” 的疑问。

30 秒快速上手

npx create-ai-team

此命令会生成：

• .claude/commands/ – 工作流命令目录
• docs/example-feature/spec.md – 可供参考的模板
• .github/workflows/ – 可选的自动化脚本

命令列表

为什么有效

• 单一真相来源 – 规范文件即权威。
• AI 直接读取上下文 – 不需要把需求复制粘贴进提示。
• 结构化格式 – 支持 Mermaid 图、错误码、测试用例等。
• 版本控制 – 规范存于 Git，变更可追溯。

开源

整个项目都是开源的：

• 仓库:
• 文档:
• NPM: npx create-ai-team

试一试

如果你已经厌倦了需求在翻译过程中丢失，不妨试试：

npx create-ai-team

然后运行 /write-spec my-feature，感受一下 AI 完全理解你的上下文的体验。

你目前是如何保持规范与代码同步的？欢迎分享你们团队的做法。