AIに開発を頼むとき、「何を作るか」が会話の途中でずれたり、別の担当に説明し直したりしていませんか。OpenSpecは、その約束を文章のファイルに整理するためのツールです。
今回はWindows上で、公開してよい架空の仕様だけを使い、OpenSpec 1.14.3の作成・検査・保管と、通信・保存・削除を実機で確かめました。AIによるコード生成の性能比較ではありません。
先に結論:AIへ頼む前の「約束」を揃える用途に
仕様を整理するローカル機能は、AIサービスへ接続せずに使えました。変更の目的、期待する動作、設計、作業一覧をファイルに分けられます。担当が変わっても同じ文書を読めることが利点です。
ただし、書類が揃ったことと、実装が正しいことは別です。さらに、利用統計は初期設定で有効です。ローカルのツールだから絶対に安全、とは言えません。機密利用は保留です。
検証したローカル機能は、APIキー・有料契約・追加課金なしで動作しました。AI連携には連携先の料金とデータ送信の条件が別にあります。今回の仕様はAIには送っていません。電力・保存容量・作業時間の負担はあります。
OpenSpecで何を整理するのか
例えば「メモを書き出すボタンを追加して」と頼む前に、次の内容を揃えます。Markdownは、見出しや箇条書きを書ける普通のテキストファイルです。
- proposal.md:なぜ変更するか、何を変えるか。
- specs/:どの操作で、どんな結果になるべきか。
- design.md:どう作るか、注意すべき制約。
- tasks.md:実施する作業と確認事項。

図の最後まで進めても、実装の合格を示すわけではありません。statusのdoneは書類の状態です。
複数のAIを使う開発では、公開可能な仕様と完了条件を共通にする使い方が考えられます。ただし、現在の各開発プロジェクトへの適合や生産性向上は未測定です。
公開ダミーで試した手順
準備:既存プロジェクトから離れた空のフォルダーを使う
検証環境はWindows、Node.js v24.19.0、OpenSpec 1.14.3です。ツールの要件はNode.js 20.19.0以上。公式配布を専用フォルダーへ取得し、導入時のスクリプト実行を無効にしました。グローバル導入や既存プロジェクトの設定変更はしていません。
以下はOpenSpec 1.14.3を確認済みの環境での操作例です。初めて準備する場合は公式の固定版の案内を参照してください。普段のプロジェクトやログイン情報を検証用フォルダーに入れないでください。
PowerShellでは、最初の操作より前に、利用統計と更新確認を無効にします。これはOpenSpecの設定であり、PC全体を通信遮断する設定ではありません。
$env:OPENSPEC_TELEMETRY = "0"
$env:DO_NOT_TRACK = "1"
$env:OPENSPEC_NO_UPDATE_CHECK = "1"
openspec --version
バージョンが1.14.3であることを確認します。今回の記事のコマンドを入力しただけでは、検証用の独自通信ガードや読取制限は付きません。
空の作業場所を初期化する
openspec init --tools none --no-animation
openspec new change safe-export --goal PUBLIC-DEMO
openspec status --change safe-export --json
--tools noneは、AIツール向けの設定を追加しない指定です。実測ではCopilot用ファイルを作らない指定も付けましたが、AIツールを選んでいないため無視されたと表示されました。
最初のstatusではproposalが未作成で、後続の文書がblockedになりました。これは前提となる文書が足りないという意味です。
提案・仕様・設計・作業一覧を書く
openspec/changes/safe-export/の下に、先ほどの文書を用意します。今回の題材は「公開用の架空メモを、端末のテキストファイルへ書き出す」です。実際の書き出し機能を実装したわけではありません。
仕様の例は、同フォルダーのspecs/export/spec.mdに書きます。下の英語の見出しは検査が読む形式なので、そのまま使います。
## ADDED Requirements
### Requirement: Local export
The system SHALL save the public note locally.
#### Scenario: Export public note
- **WHEN** the user exports PUBLIC_DEMO_NOTE_314
- **THEN** a local text file contains the note
意味は「公開メモを書き出したら、端末のファイルにメモが入ること」です。提案には目的と変更内容、設計には平文保存への注意、作業一覧には確認することを書きます。文書の書式は固定版の標準テンプレートを参照できます。
厳格な検査で、保管時に落ちる文章を見つける
openspec validate safe-export --strict --no-interactive
openspec show safe-export --json
openspec status --change safe-export --json
検証では、仕様に## Extra Notesという追加欄を付けると「正式仕様に引き継がれない」という警告が出て、strict検査が終了コード1で止まりました。必要な内容は要件の中、提案、設計など適切な場所へ整理します。警告を消すために大事な文章を捨てるのは避けましょう。
追加欄を外したダミーでは検査が通り、文書を揃えるとstatusがdoneになりました。doneは書類の状態です。製品の動作確認や安全性の合格を示しません。
確認してから保管する
openspec archive safe-export --yes
openspec list --json
openspec show export --type spec --json
この操作は正式仕様を更新し、変更記録をarchiveへ移します。今回のダミーは正常終了しましたが、提案のWhyが短いという警告は残りました。警告が出ることと、処理が止まることは別なので、先にstrict検査を行い、出力を読んでください。
archive後の主仕様にはPurposeのTBDも残りました。自動で文書が完成するわけではなく、概要の追記や人による内容確認が必要です。
今回の実測結果
- 公開ダミーの作成、検査、再読込、保管:動作を確認。
x-ownerの独自メタデータを追加:strict検査を通過。- 正式仕様に引き継がれない追加欄:strict検査で停止。
- 統計を無効にした操作:監視した通信APIへの追加試行なし。
- アーカイブ側を削除:正式仕様には本文が残り、再読込可能。
実測結果のdoneは書類の状態であり、実装の合格ではありません。
通信・保存・削除の注意点
利用統計は、何をどこへ送ろうとしたか
統計は既定で有効で、通常利用では送信されます。今回の検証では送出直前に捕捉し、実際には送らずに内容を確認しました。
比較のため統計の設定を既定へ戻し、送出を拒否するガードを維持したままlistを実行しました。https://edge.openspec.dev/batch/への送信試行を捕捉して拒否しました。
捕捉した本文は、実行したコマンド名、版、CLIという区分、ランダムな識別子、時刻などです。その送信本文にダミー仕様の文章やファイルパスは含まれていませんでした。$ip: nullもありましたが、通常の通信で相手に接続元IPが見えないことを意味するわけではありません。
更新確認には、コード上、npmのregistryへのGETもあります。設定したregistryによって宛先は変わり得ます。今回は更新確認を無効にし、update自体は実行していません。受信側の保持期間・転送・学習利用・削除は未確認です。
「止まったつもり」にしないための確認
各起動で、ダミー宛先へのDNS・HTTPS・ソケット・TLS・WebSocketの試行を行い、同じ実行の中で「試行開始→その操作を拒否→確認結果」が対応することを照合しました。別の読取エラーや、名前が見つからないだけのDNS失敗を遮断の証拠にしていません。
確認したのはJavaScriptの通信APIの呼び出し境界です。Nodeのファイル権限制限で、許可範囲外の自作ダミーを読めないことも確認しました。OS全体、別プロセス、ネイティブ処理まで全通信を封鎖したという証明ではありません。
archiveは削除ではなく、保管
archiveは変更記録を履歴へ移す操作で、本文は正式仕様側にも残ります。削除する場所によって失われる情報は異なります。

提案、仕様、設計、作業一覧は平文で保存されます。archive後はchanges/archive/に元の文書が残り、specs/には正式仕様が残りました。アプリを閉じても消えず、次の起動で読み出せます。
統計の比較試験では、専用設定ファイルに識別子と通知済み状態も保存されました。通常のWindowsでは設定が%APPDATA%/openspec/config.jsonに置かれますが、XDG設定があればそちらが優先されます。今回は専用のダミーホームへ分離しました。
後片付けで確認する範囲
- 処理が終了したことを確認する。
- 自分の検証用フォルダーがどこか、絶対パスで確認する。
- archiveだけでなく、正式仕様・設定・書き出した別コピーも確認する。
- 必要なものを判断してから、自分のダミーだけを削除し、残存を確認する。
実測では、アーカイブ側だけの削除後も正式仕様の本文を読み出せました。その後、検証用のプロジェクト・設定・一時領域をまとめた専用領域を削除し、不存在を確認しました。
再現用コード、取得パッケージ、公開原稿、ダミー本文を含む検証記録は別に保持しています。削除確認はその作業領域についての結果です。証拠やバックアップまで消した、ディスクから復元できない、と保証するものではありません。
版と安全性の判定を分ける
最初の候補だった1.14.2には、依存パッケージbracesの深い入れ子で処理が停止する脆弱性の警告が出ました。依存関係をたどって複数の警告として表示されたため、その版での記事公開を止めました。
公式修正版1.14.3に固定して再検証すると、今回の依存照会は報告0件になりました。配布物の整合性も照合しています。ただし、警告0件は未知の問題がないという保証ではありません。全依存のコード監査や署名の独立検証は未実施です。修正版の公式説明と対象の脆弱性情報も参照してください。
確認できた範囲と未確認の範囲
確認できたのは、Windowsと固定版で、自作の公開ダミーを扱ったローカルCLI機能です。macOS・Linux、任意の外来スキーマやリンク、AI連携、実案件での品質・速度、サーバー側の保持・削除は未確認です。第三者の設定や文書に書かれた指示を、そのまま実行しないでください。
利用条件はMITライセンスです。まずは公開可能な小さな仕様だけで使い勝手を確かめ、実データの導入は通信・権限・保管条件を別に確認してから判断します。
よくある質問
doneになったら、実装も合格?
いいえ。doneは書類が揃った状態です。実装の合格ではありません。
OpenSpecだけで実装してくれる?
今回使った機能は文書の作成補助・管理・検査です。実装や実装内容の正しさは別途確認が必要です。
通信を無効にしたら、保存もされなくなる?
いいえ。統計の設定と、端末に文書を保存する処理は別です。平文のファイルやアーカイブが残ります。
Claudeへ渡してよい?
外部AIへ渡す行為は別のデータ送信です。OpenSpecのローカル検証に通ったことを、機密情報を送ってよい理由にしないでください。
まとめ・関連記事
OpenSpecは、AIへ頼む前の仕様を整理し、担当が変わっても約束を追えるようにする候補です。公開ダミーで操作を学び、strict検査と人の確認を組み合わせましょう。archiveが保管であること、統計設定と保存・削除は別であることも押さえておくと安心です。
検証日:2026年10月18日。公式資料:OpenSpec固定版、セキュリティ方針。更新によって挙動や条件が変わるため、別の版には今回の結果をそのまま当てはめないでください。