Specdrive

Spec-Driven Development Suite，支持 SDD（语义/规范驱动开发）+ Harness Engineering + Vibe Coding 的协同开发模式，专为 Qoder 生态设计。

核心功能

• 项目初始化 (specdrive init): 自动探测技术栈，生成 AI 开发规则文件、编码规范、项目配置
• 需求文档解析 (specdrive parse-doc): 解析 Word 需求文档，生成结构化 Markdown 和 00-需求分析.md
• 一致性校验 (specdrive validate): 验证文档-代码一致性，Git 规范检查
• 双向同步 (specdrive sync): 文档与代码的双向同步追踪
• AI Skill 管理 (specdrive skill): 管理和预览 AI 命令（/ra、/ta、/tdo 等）
• 项目状态 (specdrive status): 查看项目 AI 协作状态和需求进度

安装

npm install -g @codingdev/specdrive

快速开始

1. 初始化项目

cd your-project
specdrive init

按照向导完成：

• 项目信息确认
• 技术栈自动探测（支持 React/Vue/Angular、Spring/NestJS/Express、Go、Python 等）
• 规则文件生成（AGENTS.md、project-context.md、coding-style.md）
• Git hooks 安装（可选）

2. 解析需求文档

specdrive parse-doc requirements.docx --output ./specs

自动生成：

• specs/YYYY/MM/MMDD-需求名/docs/原始需求.md
• specs/YYYY/MM/MMDD-需求名/00-需求分析.md

3. 在 AI 对话中使用命令

初始化完成后，在 AI 助手（如 Lingma）对话中使用：

/ra   需求分析
/rb   子需求拆分
/ta   技术方案
/tb   分批计划
/tdo  技术实现
/test 测试验证
/cr   代码审查
/rc   需求变更
/rd   需求完结
/sa   系统分析
/fa   全量审核
/ask  项目问答
/wr   沟通记录

4. 运行校验

specdrive validate

5. 查看状态

specdrive status

项目结构

安装后会在项目中生成以下结构：

your-project/
├── .qoder/                          # Qoder 核心配置
│   ├── rules/                       # AI 规则（共享只读）
│   │   ├── AGENTS.md                # AI 入口规则、安全红线、命令索引
│   │   ├── project-context.md       # 项目上下文、技术栈约束
│   │   └── coding-style.md          # 编码风格规范
│   ├── skills/                      # Skill 定义（执行层）
│   │   ├── srf-ra/SKILL.md
│   │   ├── srf-ta/SKILL.md
│   │   ├── srf-tdo/SKILL.md
│   │   └── ...
│   └── config.yaml                  # 套件运行时配置
│
├── specs/                           # 需求规格池（共享只读）
│   ├── backlog/                     # 待办需求（未排期）
│   │   └── 需求短名/
│   │       ├── docs/                # 原始需求文档
│   │       ├── 00-需求分析.md
│   │       └── ...
│   ├── 2026/                        # 已排期需求（按年/月组织）
│   │   └── 09/
│   │       ├── 0901-需求名/         # 格式: MMDD-需求短名
│   │       │   ├── docs/            # 原始需求 + 附件
│   │       │   ├── 00-需求分析.md
│   │       │   ├── 01-技术设计.md
│   │       │   ├── 02-变更清单.md
│   │       │   ├── 03-任务计划.md
│   │       │   ├── 04-tasks/        # 任务拆解产物
│   │       │   │   └── Task-01-后端-接口开发.md
│   │       │   └── 05-完结清单.md
│   │       └── 0905-另一个需求/
│   └── archive/                     # 已完结需求归档
│
├── workspaces/                      # 个人工作空间（隔离区）
│   ├── 前端-张三/
│   │   ├── current/                 # 当前迭代工作文件
│   │   ├── drafts/                  # 草稿和实验
│   │   └── history/                 # AI 会话历史
│   ├── 后端-李四/
│   └── 后端-王五/
│
└── docs/                            # 项目文档（非 AI 专属）
    ├── api/                         # API 文档
    ├── deployment/                  # 部署文档
    └── ...

命令参考

| 命令 | 说明 | |------|------| | specdrive init | 初始化项目 AI 规范体系 | | specdrive validate | 验证文档-代码一致性 | | specdrive sync | 手动触发双向同步 | | specdrive parse-doc <file> | 解析 Word 需求文档 | | specdrive skill <command> | 查看 Skill 使用指南 | | specdrive status | 查看项目 AI 协作状态 |

技术栈支持

前端框架

• React / Next.js
• Vue / Nuxt
• Angular
• Svelte

后端框架

• Java: Spring Boot / Spring MVC
• Node.js: NestJS / Express / Fastify / Koa
• Go: Gin / Echo / Chi
• Python: Django / Flask / FastAPI
• Rust: Actix-web / Rocket / Axum

数据库

• MySQL / PostgreSQL / SQLite
• MongoDB
• Redis
• Elasticsearch

ORM

• Prisma / Sequelize / TypeORM / Mongoose
• MyBatis / Hibernate / Spring Data JPA

配置

项目级配置位于 .qoder/config.yaml：

project:
  name: your-project
  version: 1.0.0
  techLead: developer-name

techStack:
  frontend:
    framework: React
    language: TypeScript
  backend:
    language: Java
    framework: Spring Boot
  database:
    type: MySQL
    orm: MyBatis

rules:
  autoLoad:
    - .qoder/rules/AGENTS.md
    - .qoder/rules/project-context.md
    - .qoder/rules/coding-style.md
  checkInterval: 1h

harness:
  enableGitHooks: true
  consistencyCheck: true
  requiredCommitPattern: 'REQ-\d{8}-\d+'

collaboration:
  sharedDirs: ['specs/', 'docs/']
  personalDir: 'workspaces/'
  requireBranchPrefix: 'feature/'

开发

# 克隆仓库
git clone <repo-url>
cd specdrive

# 安装依赖
npm install

# 运行测试
npm test

# 代码检查
npm run lint

许可证

MIT