AgentSkillsCN

openspec-guide

OpenSpec 使用指南与工作流参考。当用户询问 OpenSpec 相关问题时，可使用此指南，包括：(1) 如何使用 /opsx 命令，(2) OpenSpec 工作流说明，(3) 规范驱动开发 (SDD) 最佳实践，(4) 提案、规范、设计与任务文件的目的与格式，(5) Delta 规范的概念与使用。

SKILL.md
--- frontmatter
name: openspec-guide
description: "OpenSpec usage guide and workflow reference. Triggers when users ask about OpenSpec, including: (1) how to use /opsx commands, (2) OpenSpec workflow explanations, (3) Spec-Driven Development (SDD) best practices, (4) purpose and format of proposal, specs, design, and tasks files, (5) delta specs concepts and usage."

OpenSpec User Guide

OpenSpec is a lightweight Spec-Driven Development (SDD) framework. Core philosophy: fluid not rigid, iterative not waterfall, simple not complex.

Four-Layer Document Structure

code
.openspec/changes/<change-id>/
├── proposal.md      # Purpose and changes (Why & What)
├── specs/           # Requirements specifications (delta specs)
│   └── *.spec.md    # Incremental spec files
├── design.md        # Technical approach (How)
└── tasks.md         # Implementation checklist

Command Quick Reference

CommandPurpose
/opsx:newCreate a new change
/opsx:ffFast-forward: generate all planning documents
/opsx:continueCreate next artifact in dependency chain
/opsx:applyExecute implementation tasks
/opsx:verifyVerify implementation matches specs
/opsx:syncSync delta specs to main specifications
/opsx:archiveArchive completed change
/opsx:bulk-archiveBulk archive multiple changes
/opsx:exploreExplore mode (think without implementing)
/opsx:onboardOnboarding tutorial for new users

Command Syntax by Tool

OpenSpec supports 21+ AI coding tools with tool-specific syntax:

ToolSyntax
Claude Code/opsx:command
Cursor / Windsurf / Copilot/opsx-command
Trae/openspec-command-name

Other supported tools include: Amazon Q Developer, Antigravity, Auggie, Cline, CodeBuddy, Codex, Continue, CoStrict, Crush, Factory Droid, Gemini CLI, iFlow, Kilo Code, OpenCode, Qoder, Qwen Code, RooCode, and more.

Note: Legacy commands (/openspec:proposal, /openspec:apply, /openspec:archive) were removed in v1.0.0.

Typical Workflows

Standard Flow

code
/opsx:new → /opsx:ff → /opsx:apply → /opsx:verify → /opsx:archive
  1. •Create change: /opsx:new initializes the change directory
  2. •Fast planning: /opsx:ff generates proposal, specs, design, tasks
  3. •Implement: /opsx:apply writes code based on tasks.md
  4. •Verify specs: /opsx:verify confirms implementation matches specs
  5. •Archive: /opsx:archive completes and archives the change

Resume Work

Use /opsx:continue to create the next artifact based on dependencies, automatically loading context and determining what to generate next.

Explore Mode

Use /opsx:explore for technical research or evaluation without modifying any files. Once direction is confirmed, use /opsx:new to start a formal change.

References

For detailed documentation: