Skip to content

OpenSpec 1.5.0 Practise

Latest

Choose a tag to compare

@grissomsh grissomsh released this 08 Jul 08:17

OpenSpec Practise v1.5.0

基于 OpenSpec v1.5.0 的规范驱动开发 (SDD) 完整实践更新。

AI 工具升级

  • 迁移至 Claude Code 原生支持(.qoder/.claude/
  • 新增 /opsx:explore(探索优先)、/opsx:sync(规范同步)命令
  • 所有技能文件通过 openspec init --tools claude 重新生成

规范架构

  • openspec/ 统一为项目根级工作目录
  • MVP 规范归档至 openspec/changes/archive/2025-01-27-v1-mvp/
  • config.yaml 新增 store/references 支持(v1.5.0 特性)

v1.5.0 实践:add-product-get-by-id

完整 SDD 工作流演示(Explore → Propose → Apply → Sync → Archive):

  • 两个实现中新增 GET /api/products/:id 端点
  • 新增 4 个测试用例(Node.js 2 个,Python 2 个)
  • 规范产物归档至 openspec/changes/archive/2026-07-08-add-product-get-by-id/

文档

  • Explore First、Fluid Workflow、Stores 三个 v1.5.0 新特性覆盖
  • 所有路径引用统一至 openspec/ 根目录
  • 中英文文档完全对齐
  • Qoder 支持在工具表中保留

示例

  • examples/ecommerce-mini/ — Node.js (零依赖)
  • examples/ecommerce-mini-python/ — Python (FastAPI + Pydantic)
  • openspec/specs/ — 7 个领域的主规范
  • openspec/changes/archive/ — v1-mvp + add-product-get-by-id 两个完整变更记录