Skip to content

v1.13.2 - Verify、Windows のアーカイブ修正とワークフロー改善

Choose a tag to compare

@ayumuwall ayumuwall released this 24 Sep 05:33
· 156 commits to ja-docs since this release
  • [OpenSpec-J] OpenSpec v1.13.1・v1.13.2 の変更を取り込み、ドキュメント、CLI、スキーマ、生成スキル・コマンドの追加・変更文言を日本語化
  • [OpenSpec-J] 日本語化した診断とワークフローの判定を整合させ、承認・書き込み指示の回帰テストを日本語にも対応

v1.13.1 の変更点

このリリースでは、まだ内容を確認していないリポジトリで OpenSpec をより安全に実行できるようにし、アーカイブ、検証、エージェントのワークフローをより予測しやすくしました。

改善

  • セキュリティ強化 — 新しくクローンしたリポジトリで、config.yaml の値からエージェント向け指示へディレクティブを注入できないようにしました。細工されたファイルによって openspec update や openspec archive が停止する問題を修正し、リポジトリ内の .npmrc が更新チェック先を変更できないようにしました。
  • openspec status の次の手順 — ステータスの末尾に、変更を先へ進めるための正確なコマンドを示す Next: 行を追加しました。ワークフローを覚えていなくても、作業を再開しやすくなります。
  • プロファイルに応じたスキル — 生成されるスキルとコマンドに、選択したプロファイルが導入するワークフローだけを記載するようにしました。また、「openspec propose」「do an openspec apply」のような自然な表現も認識します。
  • プロジェクトの初期化確認 — ワークフローで書き込みを行う前に openspec init が実行済みか確認し、副作用として openspec/ フォルダーを作成しないようにしました。
  • Explore と Update のワークフロー — Explore の各引き継ぎで /opsx:propose と /opsx:apply を明示するようにしました。また、変更を記録するという明示的な依頼を確認として扱います。/opsx:update は、確認を受けてから変更を書き込むよう、先に修正案を作成します。
  • アーティファクトのテンプレート — 生成する proposal、spec、design、tasks ファイルの先頭にレベル1の見出しを追加し、markdownlint が各アーティファクトをエラーにしないようにしました。
  • ツール選択画面 — ベンダーに依存しない選択肢を「Other / Universal」と表示し、universal、generic、custom などの語で検索できるようにしました。
  • Nix — flake パッケージに bash、zsh、fish の補完を含めました。

修正

  • アーカイブ — 既存要件名と大文字・小文字だけが異なる要件名、FROM: と TO: が対応しない RENAMED セクション、読み込まれない delta ファイルをアーカイブで拒否するようにしました。一括アーカイブでは spec を書き込む前にすべての対象を確認します。また、エージェントによる archive と sync で、新しい機能のメイン spec を作成するようにしました。
  • 検証 — openspec validate で delta セクション外に書かれた要件を報告し、本文のないシナリオを拒否し、チェックボックスのないタスクに警告し、スキーマの apply.requires とアーティファクトを照合するようにしました。
  • タスクの進捗 — +、1.、1) のリスト項目に続くタスクも数えるようにしました。また、[~] など認識できないマーカーを未完了として扱い、✓ Complete によって未完了タスクが隠れないようにしました。
  • 仕様の解析 — 閉じる ### を含む要件見出しを正しく解決し、openspec show --json --deltas-only が archive の適用対象となる delta だけを返すようにしました。
  • 変更一覧 — namespace フォルダー内の変更を誤って読み飛ばさず報告するようにしました。また、リンク切れのシンボリックリンクが1つあっても openspec list が失敗しないようにしました。
  • Stores — openspec store remove が、削除対象の store 内にある store を誤って削除しないようにしました。specs または changes という名前の store が planning root になる問題を修正し、既存の Git リポジトリ内でも store setup --no-init-git が動作するようにしました。
  • 設定 — 構文エラーのあるグローバル設定ファイルを上書きしないようにしました。openspec config edit で code --wait のように引数を含む EDITOR を使えるようにし、DO_NOT_TRACK=true でテレメトリーを無効にできるようにしました。
  • セットアップと補完 — 古いコマンド用フォルダーのクリーンアップでユーザー自身のファイルを保持するようにしました。また、bash 補完をアンインストールしたとき .bashrc をバイト単位で元どおりに復元するようにしました。

新しいコントリビューター

Full Changelog: Fission-AI/OpenSpec@v1.13.0...v1.13.1

v1.13.2 の変更点

このリリースでは、/opsx:verify が実際に確認した内容を報告するようになりました。Windows でのアーカイブ処理を安定させ、複数のツールにおけるワークフローの案内を修正しました。

改善

  • タスクの案内 — 各タスクグループに、そのグループで必要なテストとドキュメント更新を含めるようにしました。最後のグループまで先送りしないルールを、オンボーディングでも案内します。
  • 承認プロンプト — Fast-forward で確認を求めるのは、コンテキストが重大な点で不明確な場合だけになりました。オンボーディングでは、タスクの内訳を保存する前に承認を求めます。
  • シナリオ損失のメッセージ — openspec validate または openspec archive が、シナリオを失う MODIFIED ブロックを検出したとき、そのブロックで追加される内容も伝えるようにしました。
  • Codex のセットアップ案内 — Codex CLI、IDE、デスクトップアプリの利用者向けに、セットアップ案内を分かりやすくしました。

修正

  • Verify — /opsx:verify が、スキップしたチェックを合格として報告しないようにしました。また、変更で削除された要件を再実装するようエージェントに指示しないようにしました。要件が削除された場合は、その動作がなくなっていれば合格とし、名前が変更された要件は元の動作に照らして確認します。
  • Windows でのアーカイブ — アーカイブ後に .openspec-archive.lock が残らないようにしました。また、Windows が変更ディレクトリの名前変更を拒否した場合も、ロールバックせず処理を完了するようにしました。
  • 行末 — CRLF の spec、.bashrc、.zshrc、CLAUDE.md を書き換えるとき、既存の行末を保持するようにしました。Windows でファイル全体が差分になる問題を防ぎます。
  • アーカイブ時のタスク警告 — エージェントによる archive でスキーマに応じたタスク進捗を使い、カスタムタスクファイルや glob を使う場合も未完了タスクを警告するようにしました。
  • アーティファクトの出力先 — brace expansion または extglob を含むアーティファクトの出力パターンを解決し、リテラルのファイル名も引き続き使えるようにしました。
  • /opsx:update — glob 対象のアーティファクトが一部だけ作成済みの場合も、不足しているファイルを補えるようにしました。実行できない手順を案内する問題を修正しました。
  • ワークフロースキーマのラベル — openspec list --json が返さないスキーマ名をワークフローに表示しないようにしました。
  • Kilo Code — コマンドを Kilo Code が読み込む .kilo/command/ に生成するようにしました。openspec init と旧形式ファイルのクリーンアップでは、既知のファイル名に一致する OpenSpec 生成ファイルを .kilocode/workflows/ から削除します。編集済みのコピーも削除対象に含め、その他のファイルは保持します。
  • Continue — Continue のコマンドが、ローカルモデルに現在のワークフロー名をツールとして呼び出させないようにしました。
  • 検証 — validate --strict で、Purpose が「Todo」で始まるスペイン語またはポルトガル語の文章をプレースホルダーと誤判定しないようにしました。
  • Codex の更新 — 旧形式のみの Codex インストールを置き換えられない場合、openspec update --force が非ゼロの終了コードを返すようにしました。

新しいコントリビューター

Full Changelog: Fission-AI/OpenSpec@v1.13.1...v1.13.2