spec-engine v3.0#

项目规格自动生成与验证工具 — 从想法到任务清单的全流程自动化

功能一览#

命令说明generate输入项目描述 → 智能提取 → 生成完整 specvalidate验证 spec 完整性，100分制评分 + A/B/C/D 等级decompose从 spec 中提取功能 → 自动拆解子任务 + 工时 + 依赖 + 负责人analyze扫描目录，分析历史 spec 数据统计dashboard生成 Web 仪表盘，可视化所有 spec 状态compare对比两个 spec 版本的差异

快速开始#

generate — 智能生成 spec#

bash

python scripts/generate.py -i <项目描述文件> [-o spec.md] [--format brief|detailed]

自动识别技术栈、推断文件结构、估算时间、识别风险。

validate — 可配置验证#

bash

python scripts/validate.py <spec文件> [--rules rules.json] [--strict] [--json]

支持自定义规则、4维检查、100分评分制。

decompose — 任务拆解（v3.0 新增）#

bash

python scripts/decompose.py -i <spec文件> [-o tasks.md] [--format table|list] [--json]

从 spec 中提取功能需求，自动拆解为子任务清单，含工时估算、依赖关系、负责人建议、关键路径分析。

analyze — 历史分析#

bash

python scripts/analyze.py [--dir <目录>] [--output report.md] [--json]

dashboard — Web 仪表盘（v3.0 新增）#

bash

python scripts/dashboard.py [-d <目录>] [-o dashboard.html]

生成深色主题 HTML 仪表盘，展示所有 spec 的评分、技术栈分布、完整性状态。

compare — 版本对比#

bash

python scripts/compare.py <旧spec> <新spec> [--json]

文件结构#

text

spec-engine/
├── SKILL.md
├── scripts/
│   ├── generate.py      # 智能 spec 生成
│   ├── validate.py      # 可配置验证
│   ├── decompose.py     # 任务拆解（v3.0）
│   ├── analyze.py       # 历史分析
│   ├── dashboard.py     # Web 仪表盘（v3.0）
│   └── compare.py       # 版本对比
└── templates/
    ├── spec-template.md # spec 模板
    └── rules.json       # 验证规则配置

特点#

• 纯 Python 标准库，零外部依赖
• UTF-8 编码，跨平台兼容
• 完全向后兼容 v1/v2

适用场景#

• Agent 团队写项目 spec → generate
• 提交前检查 → validate
• spec 确认后拆任务 → decompose
• 团队复盘 → analyze + dashboard