AIツール

OpenSpecでAI開発の仕様を揃える|Windows実機検証と通信・保存の注意点

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後は変更記録と正式仕様の両方に文章が残る。変更記録だけを削除しても正式仕様は消えない
一覧から消えても、ファイルの本文は残っています。

提案、仕様、設計、作業一覧は平文で保存されます。archive後はchanges/archive/に元の文書が残り、specs/には正式仕様が残りました。アプリを閉じても消えず、次の起動で読み出せます。

統計の比較試験では、専用設定ファイルに識別子と通知済み状態も保存されました。通常のWindowsでは設定が%APPDATA%/openspec/config.jsonに置かれますが、XDG設定があればそちらが優先されます。今回は専用のダミーホームへ分離しました。

後片付けで確認する範囲

  1. 処理が終了したことを確認する。
  2. 自分の検証用フォルダーがどこか、絶対パスで確認する。
  3. archiveだけでなく、正式仕様・設定・書き出した別コピーも確認する。
  4. 必要なものを判断してから、自分のダミーだけを削除し、残存を確認する。

実測では、アーカイブ側だけの削除後も正式仕様の本文を読み出せました。その後、検証用のプロジェクト・設定・一時領域をまとめた専用領域を削除し、不存在を確認しました。

再現用コード、取得パッケージ、公開原稿、ダミー本文を含む検証記録は別に保持しています。削除確認はその作業領域についての結果です。証拠やバックアップまで消した、ディスクから復元できない、と保証するものではありません。

版と安全性の判定を分ける

最初の候補だった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固定版、セキュリティ方針。更新によって挙動や条件が変わるため、別の版には今回の結果をそのまま当てはめないでください。

-AIツール