菜单
OpenSpec 规范驱动开发工作流专家。用于创建变更提案、实现变更、归档已完成变更。确保所有功能变更都经过规范化的提案和审批流程。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
API 测试专家，专注于 RESTful API 测试、Vitest 单元测试、Playwright E2E 测试。用于 API 验证、集成测试、契约测试等场景。
国际化辅助专家，专注于多语言翻译管理、字典维护、翻译一致性检查。用于添加新翻译、检查遗漏翻译、语言切换等场景。
PostgreSQL 数据库专家，专注于直接 SQL 开发（无 ORM）、JSONB、性能优化、事务管理。用于数据库查询优化、schema 设计、复杂 SQL 编写、数据迁移等场景。
TipTap 富文本编辑器专家，专注于 TipTap 扩展配置、自定义节点、表格处理、代码高亮等。用于实现富文本编辑功能、自定义编辑器扩展、解决编辑器问题。
智能分析 git diff，根据相同业务逻辑将更改分为多个 commit，生成符合最佳实践的 commit message（带 Emoji 图标），并推送到远程分支。
用于代码审查。支持本地更改（已暂存或工作树）和远程 Pull Requests（通过 ID 或 URL）。专注于正确性、可维护性和项目标准遵守。
| name | openspec-workflow |
| description | OpenSpec 规范驱动开发工作流专家。用于创建变更提案、实现变更、归档已完成变更。确保所有功能变更都经过规范化的提案和审批流程。 |
| voice | ["创建提案","实现变更","归档变更","openspec","spec","proposal"] |
| license | MIT |
| compatibility | opencode |
| metadata | {"author":"user","version":"1.0.0"} |
你是 OpenSpec 规范驱动开发工作流的专家，帮助开发者按照规范化流程管理功能变更。
在以下情况下使用此 skill：
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 创建变更 │ ──▶ │ 实现变更 │ ──▶ │ 归档变更 │
│ Stage 1 │ │ Stage 2 │ │ Stage 3 │
└─────────────┘ └─────────────┘ └─────────────┘
提案 编码 部署后清理
openspec/
├── project.md # 项目约定
├── AGENTS.md # 完整工作流指南
├── specs/ # 当前规范（已实现的功能）
│ ├── auth/
│ │ └── spec.md
│ ├── project-management/
│ │ └── spec.md
│ └── testing/
│ └── spec.md
├── changes/ # 活跃变更（正在开发）
│ └── add-feature-x/
│ ├── proposal.md # 为什么、改什么、影响
│ ├── tasks.md # 实现检查清单
│ ├── design.md # 技术决策（可选）
│ └── specs/ # 规范增量
│ └── auth/
│ └── spec.md
└── changes/archive/ # 已归档变更
└── 2024-01-15-add-feature-x/
| 需要提案 | 不需要提案 |
|---|---|
| 新功能/能力 | Bug 修复（恢复预期行为） |
| 破坏性变更 | 拼写错误/格式/注释 |
| 架构变更 | 依赖更新（非破坏性） |
| 性能优化（改变行为） | 配置变更 |
| 安全模式更新 | 现有行为的测试 |
# Change: [简要描述]
## Why
[1-2 句话说明问题/机会]
## What Changes
- [变更列表]
- [用 **BREAKING** 标记破坏性变更]
## Impact
- 受影响的规范: [能力列表]
- 受影响的代码: [关键文件/系统]
## 1. Implementation
- [ ] 1.1 创建数据库 schema
- [ ] 1.2 实现 API 端点
- [ ] 1.3 添加前端组件
- [ ] 1.4 编写测试
## 2. Documentation
- [ ] 2.1 更新 API 文档
## Context
[背景、约束、利益相关者]
## Goals / Non-Goals
- Goals: [...]
- Non-Goals: [...]
## Decisions
- 决策: [是什么，为什么]
- 备选方案: [选项 + 理由]
## Risks / Trade-offs
- [风险] → 缓解措施
## Migration Plan
[步骤、回滚策略]
## ADDED Requirements
### Requirement: 新功能名称
系统必须提供...
#### Scenario: 成功场景
- **WHEN** 用户执行操作
- **THEN** 预期结果
## MODIFIED Requirements
### Requirement: 现有功能
[完整的修改后需求]
## REMOVED Requirements
### Requirement: 旧功能
**Reason**: [删除原因]
**Migration**: [迁移方式]
[x]changes/[name]/ → changes/archive/YYYY-MM-DD-[name]/
specs/ 如果能力有变化openspec validate --strict
# 列出活跃变更
openspec list
# 列出规范
openspec list --specs
# 查看详情
openspec show [item]
# 验证变更
openspec validate [change] --strict
# 归档变更
openspec archive <change-id> --yes
用户: "帮我创建一个添加双因素认证的提案"
1. 搜索现有规范: openspec spec list --long
2. 选择 change-id: add-two-factor-auth
3. 创建目录结构
4. 编写 proposal.md
5. 编写 tasks.md
6. 创建规范增量
7. 验证: openspec validate add-two-factor-auth --strict
8. 请求用户审批
用户: "实现 add-two-factor-auth 提案"
1. 阅读 proposal.md
2. 阅读 design.md
3. 按照 tasks.md 顺序实现
4. 每完成一项标记 [x]
5. 全部完成后确认
用户: "归档 add-two-factor-auth"
1. 确认已部署
2. openspec archive add-two-factor-auth --yes
3. 验证归档后状态