OpenSpec 初始化專案

OpenSpec 初始化專案。

事前要求

安裝好 OpenSpec，參考「OpenSpec 安裝」。

初始化專案

建立一個空目錄為專案目錄，開啟命令列並前往該目錄。

在專案目錄下輸入 openspec init 即可開始設置初始化一個新的 OpenSpec 專案，即 OpenSpec 的規格管理環境及 AI Agent 整合設定。

% openspec init
Note: OpenSpec collects anonymous usage stats. Opt out: OPENSPEC_TELEMETRY=0 or openspec config set telemetry.enabled false


                        Welcome to OpenSpec
                        A lightweight spec-driven framework

                        This setup will configure:
                          • Agent Skills for AI tools
        ████              • Workflow commands, if supported
        ████
        ████            Quick start after setup:
                          /opsx:propose  Start a change
                          /opsx:apply    Implement tasks
                          (spelling varies by tool)

                        Press Enter to select tools...

接著會請你勾選需要用的工具，按空白鍵 Space 勾選要用的Code Agent工具，本範例為 [Codex]，按 Enter 鍵確認。

↑↓ navigate • Space toggle • Backspace remove • Enter confirm
    [ ] Auggie (Augment CLI)
    [ ] IBM Bob
    [ ] Claude Code
    [ ] Cline
    [ ] Command Code
    [ ] CodeArts
    [x] Codex (selected)
  › [ ] DeepSeek Harness
    [ ] Devin Desktop (formerly Windsurf)
    [ ] ForgeCode
    [ ] CodeBuddy Code (CLI)
    [ ] Code Studio
    [ ] Continue
    [ ] CoStrict
    [ ] Crush

確認後便會在執行目錄下產生 openspec 及 .agents 目錄。openspec 用來存放專案規格與相關設定；.agents 裡面則包含提供給 AI Agent 使用的 Skills，用來協助建立規格、實作及管理開發流程。

✔ Select tools to set up (50 available) Codex
▌ OpenSpec structure created
✔ Setup complete for Codex

OpenSpec Setup Complete

Created: Codex
6 skills in .agents/
Commands skipped for: codex (uses skills)
Config: openspec/config.yaml (schema: spec-driven)

Getting started:
  Start your first change: $openspec-propose "your idea" (Codex CLI or IDE); in the Codex desktop app, select openspec-propose from Skills in the sidebar

Note: 6 more workflows are available (new, continue, ff, bulk-archive, verify, onboard).
Add them with `openspec config profile`.

Learn more: https://github.com/Fission-AI/OpenSpec
Feedback:   https://github.com/Fission-AI/OpenSpec/issues


Tip: Run 'openspec completion install' for shell completions

到此便完成 OpenSpec 專案的初始化，專案目錄結構如下。

project/
├── .agents/
│   └── skills/
└── openspec/
    └── config.yaml