SpecFlow

通用规格治理工具。帮你把需求、设计、任务、变更、证据结构化管理，自动校验，自动生成派生产物。

安装

当前包处于 monorepo 内分发准备态，尚未正式发布到 npm registry。以下为未来正式发布后的安装方式：

npm install -g @etnly/specflow

快速开始

specflow init --dir ./my-project
specflow create constitution --title "My Constitution" --dir ./my-project
specflow create spec --title "My Spec" --constitution CONST-001 --dir ./my-project
specflow validate --dir ./my-project --report-dir reports/validation
specflow reconcile --dir ./my-project
specflow graph --dir ./my-project
specflow context --surface both --title "My Spec Task" --spec SPEC-001 --design DESIGN-001
specflow where

功能

• 初始化规格工作区
• 创建 6 类规格对象：constitution / spec / design / task / evidence / change
• 四层校验：格式 / 引用 / 不变量 / 治理链接
• 校验结果输出：text / json / json-out / md-out / report-dir
• 派生产物重建：MASTER_INDEX / STATUS / CHANGELOG
• 关系图输出：GRAPH.mmd
• CLI / IDE / Skill 三种接入方式
• 支持 specflow -validate / specflow -graph 这类单短横线命令形态
• 支持 specflow where 查看当前命中的 workspace / config / cwd

文档

安装包内 docs-public/ 目录包含完整文档：

• 安装指南
• 快速开始
• 使用手册
• 命令参考
• 完整能力手册
• 能力矩阵
• 兼容目标
• 示例
• 更新日志

兼容

• Claude Code / Codex CLI / OpenCode / Gemini CLI 等 CLI 工具
• Antigravity / Cursor / Codex surface 等 IDE
• GitHub / Jira / CI 等平台（通过可选 adapter）

系统要求

• Node.js 18+
• npm 9+