Qiaomu Bento

---
name: qiaomu-bento-ja
description: 編集できる単体HTMLのBento資料を作る。文書IDと固定shellを保って更新し、同じ要素IDの移動でページ間の関係を示すときに使う。
---
# Bento資料を日本語で作成・編集する

原典 [SKILL](source/upstream/SKILL.md) と README.md を読む。原典の固定コミット、MITとBento個別条件を保持する。PPTX/PDFの生成は対象外。

1. 原稿・ノート・データ・参照URLから新規作成するか、既存HTMLを更新するかを決め、読者・目的・オフライン範囲をdeck-planへ書く。同梱standalone shellが通常経路で、元リポcheckoutは前提ではない。locateで同梱format/shellを確認し、checkoutがある場合だけ追加のproject検査を使う。
2. 新規作成は文書JSONの必須項目から組み立てる。既存HTMLの更新では原本を保存し、extractで文書JSON全体を取り出す。docId、未知フィールド、要素ID、共同編集情報を勝手に消さない。JSONの更新は --identity-source 原本HTML で同一文書と確認する。
3. 別の出力先へbuildする。原本と出力を同じパスにしない。新しい文書へ明示的に複製するときだけ、継承したdocIdとcollabを外したコピーに --new-document を使い、一度だけIDを発行する。共同編集能力を公開資料へ混ぜない。
4. 数値はchart、仕様や比較はtable、連続変化はmorph、重要数値はcountUpへ割り当てる。同じ概念には同じ要素IDを使う。移動する対象、順序、最後の状態を本文と図の両方で説明し、形と字体の必須項目を満たす。固定shellを作り替えない。
5. validate、schema、shell、文書IDのgate結果を保存する。編集、保存、再表示と通常のmorphをブラウザーで確認する。直接保存、JSON書出し経由、別文書コピーを区別して記録する。

作例は社内検索の架空企画6頁。3役の位置を保ち、3→4頁で文書トークンと強調位置が権限確認から回答と出典へ移る。実際の検索・権限制御・共同編集・検索精度の実績は実装していない。日本語は固定版Noto Sans JPの必要字形を再収録し、OFLを保持する。

制作キットの `source/rebuild_bento.py --output-dir 新しいフォルダー` は元CLIと同じ固定shellで再生成する。元UIのJSON書出し→元CLIの別文書保存→再表示は実確認済み。IABの直接「コピーを保存」の完了は未確認。同じdocIdの再表示ではブラウザー既存状態が優先される場合があった。

## 現在の作例の実施範囲（Round4）

同梱standalone shellを通常の制作経路として使用。3→4頁は同じトークンのmorph、5頁は目標24/30の原典chartとcountUp、表紙と締めには本文に基づく図を配置した。

- 元リポのcheckoutは前提ではなく、同梱standaloneが通常経路。project側の追加validatorはcheckoutが無いため未実行。
- 画像+scrim/ken-burns、state slide、外部媒体、共同編集、実検索と権限制御は未実証。
- ブラウザーの直接「コピー保存」は完了未確認。同docIdコピーは既存状態の影響を受けたため、独立コピーは --new-document を使用した。
- countUpの初期化前に静的値が一瞬描画される原典挙動がある。途中値が増加する区間を撮影し、連続動画全フレームの品質保証とはしない。PPTX/PDF出力は対象外。

全6頁の実描画と個別の動作証拠は制作側の確認。独立Kimi K3/Opus5.5の新しい版の評価は別に行う。過去の採点を新しい画像へ引き継がない。