开发工作流 OpenSpec 二开 Bundle

在 OpenSpec 原生机制上二次开发的可分发工作流包，包含两个自定义 schema：

| Schema | 用途 | Artifact 链 | |---|---|---| | team-project | 项目启动：需求澄清 → 技术文档 → 开发路线图 → 主 specs 联动 | requirements → tech-stack → roadmap → specs | | team-workflow | 功能开发：提案 → 行为规格 → 技术方案 → 任务 | proposal → specs → design → tasks |

项目级三阶段与功能级流程通过主 specs 联动：项目级 change 归档后，需求/技术栈/路线图以 delta specs 写入 openspec/specs/project/，功能级提案（team-workflow）创建时自动研究现有 specs，天然读到项目级约束。

目录结构

skill开发工作流/
├── openspec/schemas/
│   ├── team-workflow/             # 功能级 schema（fork spec-driven + 团队约定）
│   │   ├── schema.yaml
│   │   └── templates/             # proposal / spec / design / tasks
│   └── team-project/              # 项目启动 schema
│       ├── schema.yaml
│       └── templates/             # requirements / tech-stack / roadmap / spec
├── config/
│   ├── openspec-config.yaml       # 项目 config 模板（schema: team-workflow）
│   └── dev-standards-wrapper.md   # 开发规范快速索引包装（脚本合并下载内容）
├── scripts/
│   ├── init-project.ps1           # 一键初始化新项目
│   └── install-global.ps1         # 机器级安装两个 schema
└── _backup/                       # 旧工作流 skill、旧方案备份

项目级三阶段保留了原来的沟通与决策机制

原来的三个 skill（需求澄清 / 初始化 / 路线图）的对话心法已完整嵌入 team-project 的 artifact instructions，由 openspec instructions 注入：

| 阶段 | 保留的沟通/决策机制 | |---|---| | requirements（项目需求澄清） | 苏格拉底式五维提问（WHY/WHO/WHAT/HOW/范围）、示例驱动（每问必带选项）、拒绝模糊、每次 1-2 个问题、双重确认（"是否还有其他想要补充、修改的内容？"） | | tech-stack（技术文档） | 3-5 轮对话确认四个决策项：技术栈（已有代码先推断→展示确认 / 新项目给推荐+理由）、核心规则 8-12 条给默认值用户微调、工作流确认、开发规范 URL；生成前展示确认 | | roadmap（路线图） | 先依赖分析（基础/核心/辅助）→ 里程碑划分有依据 → 每个模块配通俗解释 → 进度扫描 [x] → 展示确认后再保存；MVP 必须含核心闭环 |

一键部署

方式一：npm 全局安装（推荐）

# 发布到 npm 后：
npm install -g openspec-workflow
# 未发布时，可直接从 GitHub 装：
npm install -g github:<你的用户名>/<仓库名>

安装后有两个命令：

• team-workflow install-global — 机器级安装 schema 到 %LOCALAPPDATA%\openspec\schemas\（本机所有项目可用，一次性）
• team-workflow init <项目路径> — 一键初始化新项目

team-workflow install-global
team-workflow init "D:\你的新项目"

init 自动完成：openspec init（Codex/Claude/Trae 三套入口）→ 复制两个 schema 到项目 → 写 config（功能级默认 team-workflow）→ 下载开发规范 → 创建 project-bootstrap change（team-project schema） → schema 自检。

旧版 PowerShell 脚本（scripts/init-project.ps1 / install-global.ps1）已被 npm CLI 取代，归档在 _backup/，不再维护。

3. 项目启动（一次）

# Codex（Claude: /opsx:propose · Trae: /opsx-propose）
$openspec-propose project-bootstrap

agent 按依赖顺序生成三份项目级文档（每份都走对话+确认），再生成 specs/project/ 的 delta specs：

requirements.md → tech-stack.md → roadmap.md → specs/project/*.md

确认无误后归档：

$openspec-archive-change project-bootstrap

归档后 specs/project/ 进入主 specs，功能级流程自动联动。

4. 功能开发（每个功能循环）

$openspec-propose "功能描述"          # proposal → specs → design → tasks
$openspec-apply-change                # 实现（写码前自动查开发规范快速索引）
$openspec-archive-change              # delta 合并进主 specs，更新路线图勾选

分发

本仓库即 bundle 源码：

1. 推送到 GitHub 后，团队成员 npm install -g github:<你的用户名>/<仓库名>（或发布到 npm registry 后 npm install -g openspec-workflow）
2. 然后 team-workflow install-global + team-workflow init <项目>
3. 可选：按 OpenSpec 社区 schema 规范提交到官方表格

变更记录

• 2026-08-01：本地散装脚本方案废弃（移入 _backup/旧方案_20260801/），重构为可分发 schema bundle
• 2026-08-01：新增 team-project 项目启动 schema，项目级三阶段（需求澄清 → 技术文档 → 路线图）进入 OpenSpec 状态机并通过主 specs 与功能级联动；原三 skill 的对话心法/决策机制完整嵌入
• 2026-08-01：正式 npm 化：openspec-workflow 包 + team-workflow CLI（install-global / init），.ps1 脚本退役