Sonir.

Sonir Bench モジュール仕様

SPEC V1

DSPモジュールとレート変換段の設計に必要な情報を1ファイルにまとめました。本文・JSON Schema 2本・エラーコード全件・そのまま通るリファレンスの実例。読み手は人だけでなくAIも想定しています。

MARKDOWN / JA
日本語版
原文。実装で使われている用語に基づいています。
MARKDOWN / EN
English
本文の英訳。付録（Schema・エラー・実例）は実装が出すままで、訳していません。

AIに書かせる

この仕様は人だけでなくAIが読むことを前提に書かれています。手順は3ステップだけで、そのどこにもAIが再生中の音を直接操作する仕組みはありません。

  1. 01

    仕様を渡す。

    下のURLを貼るか、ファイルを添えて渡します。1ファイルにまとめてあるため、解説・Schema・エラーコード全件・動作する実例がすべて一度に渡ります。

  2. 02

    JSONを1つ書かせる。

    モジュールはJSONファイル1つです。spec_versionを必ず含めさせ、付録Cのリファレンスモジュールを参考に作成させます。

  3. 03

    アプリの画面にファイルをドロップする。

    「グラフ設計」で「新規作成」を押し、「ファイルから読み込む」の欄にファイルをドロップします。事前検証により、実際の再生時と同じ検証ステージが無音で実行されます。合格しなかった場合は該当するステージ・エラーコード・測定値が返るため、「結果をコピー」してAIに渡すことで誤りを修正させられます。

プロンプト例

https://sonir.app/spec/sonir-bench-v1.ja.md にあるSonir Benchのモジュール仕様を読んで、DSPモジュールをJSONで1つ書いてください。spec_versionを必ず含め、付録Cのリファレンスモジュールを参考にし、Schemaに定義されていない項目は追加しないでください。
  • AI自体に音を再生する機能はありません。Sonir Benchを直接操作する仕組みはないため、AIとのやり取りによって再生中の音が変わることはありません。
  • AIが作成できるのは設計ファイル（JSON）のみです。仕様にはグラフとレート変換段の設計フォーマットが含まれますが、再生の実行やアプリ本体の設定変更などは行えません。
  • 音を再生するのはSonir Bench本体です。モジュール仕様単体では音は出ません。

この文書の作り

  • 実装から自動生成されています。

    本文は仕様書、JSON Schemaとエラーコードは実装、実例はテスト済みのリファレンスモジュールから組み立てています。手作業による転記はありません。

  • 掲載されているJSONはすべて検証を通過します。

    構造チェック・検証・シミュレーション・安全起動の4段階のテストを通過したものだけを掲載しています。通らない実例を載せると、それを真似した誤った実装が作られてしまうためです。

  • 数値の閾値や範囲は本文に記載していません。

    数値はJSON Schemaが実装の定数から取得して展開しています。本文側にも転記すると二重管理になり、必ず乖離が生じるためです。

  • 必要な情報のみに絞り込んでいます。

    モジュールを作成するにあたって必要な情報に限定しています。OS別の入出力実装・内部構造・今後の予定などは含めていません。