Claude Workflow: 规格文档驱动的系统设计
Claude workflow 规格文档负责“发散和沉淀思路”;
OpenSpec 负责“收敛和定义事实”。
Claude workflow 规格文档不是要删,而是要降级为:
历史 PRD、设计参考、需求素材、方案草稿。
OpenSpec 必须升级为:
当前行为事实源、变更管理入口、验收标准来源、长期演进基线。
核心原则:
不要让 Claude workflow 规格文档直接指挥现在的代码。
所有准备落地的内容,都必须先转换成 OpenSpec change。
所有已经完成并验证的行为,都必须归档进 OpenSpec specs。
权威层级:
- OpenSpec specs
当前系统行为事实源。
- OpenSpec changes
正在发生或准备发生的变更事实源。
- docs
面向人使用、部署、运维、排障的说明。
- 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 共同兑现规格。
关联工程母题系统与实测说明:
本篇「Claude Workflow: 规格文档驱动的系统设计」由 qilai 整理收录于 qilaidav 工程知识库,围绕 智慧投放系统与高转化归因 的生产环境架构设计、链路排障与确定性验证展开沉淀。完整系统模块、部署边界与技术规格请查阅方案主页:→ 查看 智慧投放系统与高转化归因 详情(架构诊断与定制交流:Telegram @BD8888 · hello@qilaidav.com · GitHub @qilaidev)。
免责声明与评测方法:本文所涉开源工具、模型基准与工程配置均基于实测环境与公开技术资料整理,仅供系统架构研发参考,不构成任何商业背书或投资建议。
— qilai · 摘自 Telegram 频道 @AIKB8