rehydrate について
confide:rehydrateは、CONFIDEのマスキング後に分析文の値をローカルのマップで復元するスキルです。復元文は標準出力ではなくファイルに保存し、未一致のプレースホルダーはそのまま残して報告します。
主な機能
- 01ローカルマップから値を復元
- 02形式が崩れたプレースホルダーに対応
- 03未一致項目を変更せず報告
- 04マップ検証と旧形式に対応
- 05繰り返し実行しても結果が変わらない
活用シーン
- 01マスキング文から生成した分析の復元
- 02モデル出力内の未知のプレースホルダー確認
- 03対象文書とマップの一致確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ glebis/ claude-skills --skill rehydrateインストール後、Claude Code で/rehydrateを入力して読み込まれたか確認します。
同梱ファイルscripts/rehydrate.py
詳細
confide:rehydrate — プレースホルダーを含む分析に実際の値を復元する
CONFIDE の往復処理の最後のステップです。
confide:anonでローカルに墨消しします(デフォルトの可逆モード)→ 一意の予約済みセンチネルプレースホルダー([CONFIDE_PERSON_0001]、[CONFIDE_EMAIL_0001]、[CONFIDE_DATE_0002]…)と、秘密の<name>.map.json(構造化形式:green_sha256、entries[]…)を含む GREEN コピーが作成され、マップは マシン上に保管されます。- GREEN テキストをどこでも分析できます。クラウド LLM も利用できます。分析結果には同じプレースホルダーが
多数含まれます(
CONFIDE_PERSON_0001、[CONFIDE PERSON 0001]…のように変形する場合もありますが、 完全なCONFIDE_TYPE_NNNNコアは常に維持されます)。 - ここで復元します。ご自身のマップにある元の値ですべてのプレースホルダーを置き換え、実際の分析結果を 作成します。クラウドに元の値を見せることはありません。
プライバシーに関する不変条件(必ず守ってください)
- ユーザー自身のマップを使い、ローカルでのみ処理します。 マップがマシンから外部に送信されることはありません。このスキルは 何も取得・送信しません。
- 標準出力に表示するのは件数のみです。 概要には
restored N, unmatched Mと表示されます。復元されたテキスト(元の値を含む)は ローカルファイルに書き込まれ、件数以外が標準出力に出力されることはありません。 - 未一致の項目は、ハルシネーションの可能性があります。 マップにないプレースホルダーは
unmatchedとして 報告され、そのまま残されます。値を捏造することはありません。 これらは LLM によるハルシネーションの可能性があると、ユーザーに警告してください。 <name>.restored.mdの出力には元の値が含まれます。ローカルのみで扱い、共有や コミットはしないでください。
実行方法
python3 skills/rehydrate/scripts/rehydrate.py ANALYSIS_FILE [--map <name>.map.json]
ANALYSIS_FILE— プレースホルダーを含むテキスト/分析結果です。--map <name>.map.json—confide:anonが作成した秘密のマップです。省略した場合は、同じ ディレクトリにある*.map.jsonを自動検出します(例:session.map.jsonの隣にある分析ファイル、 またはsession.green.mdから派生したファイル)。--out PATH— 出力先のパスです(デフォルト:入力ファイルと同じディレクトリにある<name>.restored.md)。--verify-green <green_file>— マップのgreen_sha256をその GREEN ファイルと照合します。一致しない場合(このドキュメントに対するマップが間違っている場合)は、大きく警告します。
完全な CONFIDE_TYPE_NNNN コアが維持されていれば、LLM による変形にも対応します。
[CONFIDE_PERSON_0001]、[CONFIDE PERSON 0001]、CONFIDE_PERSON_0001、および
confide_person_0001 はすべて、同じマップエントリに復元されます。CONFIDE 接頭辞のない通常の文章
(例:「Person 1」、「patient 1」、「section 2」)には決して触れず、
0001 が 0010 に誤って一致することもありません。再水和処理は冪等です(復元済みのテキストに再度実行しても
何も変更されません)。構造化マップ形式と旧形式のフラットマップの両方を受け付けます。
実行後
- 復元の概要(
restored N, unmatched M)を報告します。PII を貼り付けないでください。 unmatched > 0の場合は、該当するプレースホルダーがマップにないハルシネーションの可能性があると伝えてください。*.restored.mdはローカルのみで扱うよう、ユーザーに念を押してください(このファイルには元の値が含まれています)。
コメント
Markdown 対応