openspec-schema

OpenSpec スキーマスキル

openspec schema サブコマンドを使用して、カスタムワークフロースキーマを作成、管理します。スキーマは、存在する成果物とその依存関係を定義します。デフォルトの spec-driven スキーマでは、提案 → 仕様 → 設計 → タスクの順に進みますが、カスタムスキーマを使うと異なるワークフローを定義できます。

使用するタイミング

• ユーザーがカスタムワークフロー（例：リサーチ優先、迅速な反復）を求めている場合。
• ユーザーが「スキーマを作成」「カスタムワークフロー」「spec-driven スキーマをフォーク」と言った場合。
• スキーマ解決のデバッグ（openspec schema which）。
• カスタムスキーマの構造の検証。

前提条件

• OpenSpec CLI がインストールされていること（openspec-install を参照）。

ワークフロー

新しいスキーマを最初から作成する

openspec schema init my-workflow
# Interactive: prompts for description, artifacts, default
# Non-interactive:
openspec schema init rapid --description "Rapid iteration" --artifacts "proposal,tasks" --default

openspec/schemas/my-workflow/ に schema.yaml と templates/ を作成します。

既存のスキーマをフォークする

openspec schema fork spec-driven my-workflow

カスタマイズ用に spec-driven スキーマをコピーします。

スキーマを検証する

openspec schema validate my-workflow
# Or validate all:
openspec schema validate

スキーマの解決結果を確認する

openspec schema which spec-driven
# Shows: package, project, or user source
openspec schema which --all

スキーマの構造

openspec/schemas/<name>/
├── schema.yaml       # Artifact definitions and dependencies
└── templates/
    ├── proposal.md   # Template for each artifact
    ├── specs.md
    ├── design.md
    └── tasks.md

schema.yaml の例

name: research-first
artifacts:
  - id: research
    generates: research.md
    requires: []
  - id: proposal
    generates: proposal.md
    requires: [research]
  - id: tasks
    generates: tasks.md
    requires: [proposal]

スキーマの優先順位

1. プロジェクト: openspec/schemas/<name>/（ローカル、バージョン管理対象）
2. ユーザー: ~/.local/share/openspec/schemas/<name>/（グローバル）
3. パッケージ: 組み込みスキーマ（例：spec-driven）

出力

• schema.yaml とテンプレートを含む、openspec/schemas/<name>/ 内のカスタムスキーマ。

次のステップ

• openspec-new でスキーマを使用します：/opsx:new my-change --schema my-workflow。
• または、openspec-config（openspec/config.yaml）でデフォルトに設定します。

トラブルシューティング

• 「Schema not found」：利用可能なスキーマを openspec schemas で確認し、解決結果を openspec schema which <name> で確認します。
• 検証エラー：詳細を確認するには、openspec schema validate <name> --verbose を実行します。
• ルール内の不明な成果物 ID：スキーマごとの成果物 ID を openspec schemas --json で確認します。

参考資料

• OpenSpec CLI：schema コマンド
• OpenSpec の概念：スキーマ
• OpenSpec のカスタマイズ