top of page
検索

性格を仕様として書く ── SAKU_UNIFIED_SCHEMA_V1 の読み方

wTokyoWireless
2 日前
読了時間: 2分

更新日：11 時間前

KOKOROSAKU では、キャラクターの人格や判断の傾向を、文章の印象ではなく機械が検査できる仕様（Character File）として書きます。その型を定めるのが、schema/adopted/unified-v1/ にある SAKU_UNIFIED_SCHEMA_V1 です。

本体一つと、付属の契約文書

  • saku-unified-character.v1.schema.json ── Character File 本体の型（schema_id: SAKU_UNIFIED_CHARACTER_SCHEMA_FROZEN_CANDIDATE、schema_version: final-delta-recovery-closure-2026-09-04）

  • character-extension.v1.schema.json ── 名前空間付きの拡張項目（extensions）の型

  • internal-consistency-semantic-contract.json ── 項目どうしの意味的な整合についての契約

  • input-integrity-invariant.json ── 「必要な入力を、AI が生成した代替物で埋めない」という不変条件

Character File の七つの必須項目

本体スキーマが要求する項目は次の七つです（required）。これ以外の項目は、任意の expression_semantics（一人称・呼びかけ・声の設定）と extensions を除いて足せません（additionalProperties: false）。

  • schema ── スキーマ ID と版

  • identity ── 不変の ID、改訂番号、表示名

  • purpose ── 要約、主な価値、作業モード、やらないこと（non_goals）

  • character_core ── 役割、価値観、破ってはならない不変条件（hard_invariants: minItems 1）、許される幅と禁じる逸脱（expressive_range）、人へ引き継ぐ条件（human_handoff_conditions: minItems 1）

  • assistant_composition ── 内部の席 1〜8 の構成（別記事で説明します）

  • personality_axes ── 語り口や間の取り方などを表す 15 の軸（a_motif 〜 o_closing）

  • conformance_expectations ── 守るべき要件、禁じる逸脱、引き継ぐべき要件を、hard_invariants などの ID で参照する

サンプル「WI-T ガイド」（sample-wit-guide）で読む

合成サンプルの一つ「WI-T ガイド」（character_id: sample-wit-guide）は、問い合わせを整理する案内役のサンプルです。値をそのまま写します。

  • purpose.non_goals：「法的確約」「料金や利用権の確定」「セキュリティ判断の承認」「人間による回答完了の代行」

  • character_core.hard_invariants[0]：INV-OSS-H90-1「AIによる応答を人間の回答、承認、法的確約として扱わない。」

  • character_core.human_handoff_conditions[0]：HO-OSS-H90-1、reason_class「EXTERNAL_IRREVERSIBLE」、trigger「契約、料金、利用権、セキュリティまたは例外対応の確定が必要な場合」、boundary_statement「状況と未確認事項を整理し、確定は人間へ戻す」、action「HANDOFF_TO_HUMAN」（const）

  • personality_axes.e_vocabulary_tone：WARM_EMBRACING、personality_axes.f_acknowledgement：MIRRORING

  • conformance_expectations.prohibited_drift_refs：INV-OSS-H90-1 と INV-OSS-H90-2 を参照

「親しみやすく慎重」と文章で書く代わりに、値と条件と参照で書く。これが「性格を仕様として書く」の意味です。

読むときの注意

human_handoff_conditions は論理的な条件だけを表し、実際に誰が受け取るか、どこへ送るかは含みません（スキーマの x-wit-boundary）。スキーマは「凍結候補」の状態で、採択の状態と正本リポジトリの改訂は同じフォルダの ADOPTION_STATUS.json に記しています。将来の版で項目が変わる可能性があるため、ファイル先頭の schema を確認してから読んでください。

次の一歩：SAKU の機能説明 → https://www.wi-t.com/features-saku

関連リンク

訂正の履歴：（訂正があれば日付と内容をここに追記します）


コメント

bottom of page