> For the complete documentation index, see [llms.txt](https://getsquish.gitbook.io/squish/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://getsquish.gitbook.io/squish/ja/reshipi/build-week-audio-navigation.md).

# Build Week: 音声ガイド付きの候補選定

Build Week 拡張は、ローカル CLI と MCP サーバーに 2 つ目の機械的シグナルを与えます。それは、視覚セルと同じ絶対ソースタイムラインに揃えられた正規化済みの音声アクティビティ帯です。これは 1 つの問いに答えます—**どのタイミングで、より詳しく見ると有用でしょうか？**—音声を理解していると主張するものではありません。

## イベントの前から存在していたもの

Squish はすでにタイムスタンプ付きのコンタクトシートを生成し、反復的な `開始`/`終了` ズームをサポートしていました。これらの絶対タイムコードと、概要 → ズームのループが基盤であり、Build Week の作業ではありません。

## Build Week で追加されたもの

* クリップ全体にわたる `clip_peak` ローカル CLI/MCP シート上の音声アクティビティ帯；
* 加算的な絶対時刻 `audio.samples[]` メタデータ；
* 短時間かつ高周波のアクティビティの保持；
* テスト、ドキュメント、および音声ガイド付きの候補選定ワークフローです。

これは意味ではなく、エネルギーです。文字起こし、音イベントラベル、話者分離、感情推定はありません。公開版では、1 つのソースクリップ全体に対して単一の参照スケールを使用しており、共有スケールで別々のファイルを比較することはありません。

## 2 つの証明層

**ナラティブによる証明。** 公開デモでは、所有者の許可を得たカメラ映像を使用しています。視覚的に反復的な 1 分クリップが 22 本、音声ガイド付きの候補範囲、そして出入り口の端に人が一瞬現れることを確認できる高密度のビジュアルズームです。映像は非公開であり、配布されません。

**再現可能な証明。** 公開リポジトリには、次のパス配下に生成済みの 24 秒の fixture が含まれています `examples/audio-navigation/`。通常の概要では見た目は静的なままで、短い音声トランジェントを含み、その直後にピンクのマーカーが一瞬表示されます。

```bash
git clone https://github.com/getsquish/squish.git
cd squish
./examples/audio-navigation/generate-sample.sh

npx -y @getsquish/squish@0.3.1 \
  examples/audio-navigation/sample.mp4 \
  --json \
  --out /tmp/squish-audio-overview

npx -y @getsquish/squish@0.3.1 \
  examples/audio-navigation/sample.mp4 \
  --density 6x6 \
  --start 11.5 \
  --end 13.5 \
  --json \
  --out /tmp/squish-audio-zoom
```

まず概要を読んでください。音声アクティビティは、次の候補を提案するためだけに使ってください。 `11.5–13.5 秒` その近傍を確認し、その後、高密度のビジュアルシートでマーカーがいつ現れるかを確かめてください。インデックスは提案し、拡大画像が証明します。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://getsquish.gitbook.io/squish/ja/reshipi/build-week-audio-navigation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.