Claude Workflow: 规格文档驱动的系统设计

Claude workflow 规格文档负责“发散和沉淀思路”;

OpenSpec 负责“收敛和定义事实”。

Claude workflow 规格文档不是要删,而是要降级为:

历史 PRD、设计参考、需求素材、方案草稿。

OpenSpec 必须升级为:

当前行为事实源、变更管理入口、验收标准来源、长期演进基线。

核心原则:

不要让 Claude workflow 规格文档直接指挥现在的代码。

所有准备落地的内容,都必须先转换成 OpenSpec change。

所有已经完成并验证的行为,都必须归档进 OpenSpec specs。

权威层级:

  1. OpenSpec specs

当前系统行为事实源。

  1. OpenSpec changes

正在发生或准备发生的变更事实源。

  1. docs

面向人使用、部署、运维、排障的说明。

  1. Claude workflow 规格文档

历史参考、需求素材、设计来源,不代表当前实现状态。

核心流程:

Claude workflow 规格文档先发散:

生成 PRD、需求、设计、任务、风险、验收想法。

OpenSpec 再收敛:

把准备落地的内容变成 proposal、tasks、design、delta specs。

代码再实现:

只实现 OpenSpec 中声明的变更。

测试和 docs 再验收:

确认行为、文档、用户路径一致。

完成后归档:

把 OpenSpec change 合并回 OpenSpec specs,成为新的当前事实。

旧 Claude workflow 规格文档处理规则:

已实现且仍正确:

迁入 OpenSpec specs。

准备实施:

转换成 OpenSpec changes。

有价值但暂缓:

保留为 reference。

已废弃:

标注废弃原因。

与当前实现冲突:

以 OpenSpec 和真实行为为准。

最终判断:

Claude workflow 规格文档适合“想清楚”;

OpenSpec 适合“管住变化并长期不跑偏”。

一句话总结:

Claude workflow 规格文档是素材层,OpenSpec 是事实层。

先用 Claude workflow 规格文档展开思路,再用 OpenSpec 定义权威,最后让代码、测试和 docs 共同兑现规格。

#OpenSpec#Claude#规格文档#需求管理#开发流程#AI工作流#工程化

关联工程母题系统与实测说明:

本篇「Claude Workflow: 规格文档驱动的系统设计」由 整理收录于 qilaidav 工程知识库,围绕 智慧投放系统与高转化归因 的生产环境架构设计、链路排障与确定性验证展开沉淀。完整系统模块、部署边界与技术规格请查阅方案主页:→ 查看 智慧投放系统与高转化归因 详情(架构诊断与定制交流:Telegram @BD8888 · hello@qilaidav.com · GitHub @qilaidev)。

免责声明与评测方法:本文所涉开源工具、模型基准与工程配置均基于实测环境与公开技术资料整理,仅供系统架构研发参考,不构成任何商业背书或投资建议。

— qilai · 摘自 Telegram 频道 @AIKB8