Run `openspec init` to initialize OpenSpec in a project directory, creating the openspec/ folder structure and configuring AI tool integrations. Use when the user says "initialize OpenSpec", "openspec init", or "set up OpenSpec in this project".
Run openspec init to initialize OpenSpec in a project: creates the openspec/ directory (specs, changes, config) and configures AI tool integrations (skills and slash commands). This skill assumes the OpenSpec CLI is already installed; if not, direct the user to openspec-install first.
openspec is not in PATH, guide the user to run openspec-install before proceeding.Verify CLI
Choose parameters
all, none, or comma-separated list (e.g. claude,cursor).Run the command
openspec initopenspec init --tools claude,cursoropenspec init --tools allopenspec init ./my-projectOptionally create project config
openspec/config.yaml with project context, schema defaults, and per-artifact rules. This is optional but recommended. See openspec-config for details.Confirm outputs
openspec/ directory with specs/, changes/, and optionally config.yaml. Tool-specific directories (.claude/skills/, .cursor/rules/, etc.) are created based on selected tools.amazon-q, antigravity, auggie, claude, cline, codebuddy, codex, continue, costrict, crush, cursor, factory, gemini, github-copilot, iflow, kilocode, opencode, qoder, qwen, roocode, trae, windsurf
specs/ — Specifications (source of truth)changes/ — Proposed changesconfig.yaml — Project configuration (optional).claude/skills/, .cursor/rules/, .windsurf/skills/, etc. based on selected tools.| Scenario | Command |
|----------|---------|
| Interactive | openspec init |
| Claude + Cursor | openspec init --tools claude,cursor |
| All tools | openspec init --tools all |
| Specific directory | openspec init ./my-project |
| CI / non-interactive | openspec init --tools claude --force |
| Skip tool config | openspec init --tools none |
--force to auto-cleanup, or follow the interactive prompts.确保开发环境已安装必要的依赖和工具。
根据项目需求进行基础配置。
按照示例代码实现核心功能。
运行测试确保功能正常。
完成开发后进行部署和监控。