Stats
Actions
Tags
From dev-skills
Guides spec-driven development using OPSX workflow: slash commands generate proposals, delta specs, designs, tasks; incrementally apply, verify, archive changes. For features, refactors, complex demands.
How this skill is triggered — by the user, by Claude, or both
Slash command
/dev-skills:openspecThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
OpenSpec 是规范驱动的 AI 编程框架。核心理念：**在编写代码前，与 AI 就需求达成一致**。
OpenSpec 是规范驱动的 AI 编程框架。核心理念：在编写代码前，与 AI 就需求达成一致。
| 命令 | 功能 |
|---|---|
/opsx:explore | 探索想法、调查问题、明确需求 |
/opsx:new | 启动新变更 |
/opsx:continue | 创建下一个就绪工件 |
/opsx:ff | 快进 - 一次创建所有规划工件 |
/opsx:apply | 实施任务，按需更新工件 |
/opsx:verify | 验证实现的完整性、正确性、一致性 |
/opsx:sync | 同步 delta specs 到主规范（可选） |
/opsx:archive | 归档完成的变更 |
/opsx:bulk-archive | 批量归档多个变更 |
/opsx:onboard | 交互式教程 |
快速功能流（需求明确时）：
/opsx:new → /opsx:ff → /opsx:apply → /opsx:verify → /opsx:archive
探索式流程（需求不明确时）：
/opsx:explore → /opsx:new → /opsx:continue → ... → /opsx:apply
增量式流程（需要更多控制时）：
/opsx:new → /opsx:continue (重复) → /opsx:apply → /opsx:archive
工件依赖链：
proposal → specs → design → tasks → implement
工件类型：
references/delta-specs-format.mdreferences/tasks-writing-guide.md工件状态：BLOCKED（缺少依赖）→ READY（依赖完成）→ DONE（文件存在）
openspec/
├── config.yaml # 项目配置（可选）
├── specs/ # 当前系统行为（事实来源）
├── changes/ # 活跃变更
│ └── add-feature/
│ ├── .openspec.yaml
│ ├── proposal.md
│ ├── specs/
│ ├── design.md
│ └── tasks.md
├── archive/ # 已归档变更
└── schemas/ # 自定义工作流（可选）
详细规范请读
references/tasks-writing-guide.md
两条最重要的原则：
[操作类型] 文件路径 - 具体改动描述，禁止写无法定位文件的模糊任务格式速记：
- [ ] [修改] `packages/foo/src/bar.ts` - 增加 processItem() 方法，实现单条数据处理
相同意图？ → YES: 更新现有变更 / NO: 启动新变更
>50% 重叠？ → YES: 更新现有变更 / NO: 启动新变更
原始能完成？→ NO: 更新现有变更 / YES: 启动新变更
/opsx:verify 检查三个维度：
tasks.md 的复选框tasks.md 全部任务openspec init # 初始化项目
openspec list # 列出活跃变更
openspec status --change <name> # 查看工件状态
openspec validate <name> --strict # 严格格式校验
openspec archive <name> --yes # 归档变更
配置、自定义 Schema、故障排除详见
references/configuration.md
| 文件 | 内容 |
|---|---|
references/tasks-writing-guide.md | tasks.md 编写规范（文件级粒度 + 试点分层详解） |
references/delta-specs-format.md | Delta Specs 完整格式规范 |
references/configuration.md | config.yaml 配置、自定义 Schema、故障排除 |
npx claudepluginhub ruan-cat/monorepo --plugin dev-skillsCreates OpenSpec change proposals by analyzing codebase for affected files, dependencies, and risks. Generates tasks and test strategies from proposals. Use for planning features in OpenSpec projects.
Transforms ideas into structured specifications (requirements, design, tasks) before implementation. Use when building features, fixing bugs, refactoring, or designing systems.
Writes structured specifications before coding. Use when requirements are ambiguous, starting a new project/feature, or changes touch multiple files.