메뉴
This skill should be used when the user asks to "create a template", "テンプレート作成", "書式を登録", "XLSXをテンプレート化", "テンプレート登録", "この書式を登録して", "テンプレートを追加", or wants to register a new court document template from an XLSX file.
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/ThomasMoreAI/legal-skills-open --skill template-create명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | template-create |
| title | テンプレート作成（template-create） |
| description | This skill should be used when the user asks to "create a template", "テンプレート作成", "書式を登録", "XLSXをテンプレート化", "テンプレート登録", "この書式を登録して", "テンプレートを追加", or wants to register a new court document template from an XLSX file. |
| author | llamadrive |
| author_url | https://github.com/llamadrive/bengo-toolkit/tree/main/skills/template-create |
| license | MIT |
| version | 0.1.0 |
| execution_mode | open |
| jurisdiction | general |
| practice | general |
| language | ja |
ユーザーが持ち込んだXLSXファイルを分析し、入力フィールドを定義してテンプレートとして登録する。
初回使用時のみ案内メッセージを表示する（2 回目以降は silent、処理は決してブロックしない）:
python3 skills/_lib/first_run.py notice
出力があれば、そのままユーザーに提示してから保存場所の決定へ進む。
テンプレートは 保存場所 を 3 通りから選べる:
case、既定、安全側）— 現在の案件フォルダの中にだけ保存
（<案件フォルダ>/.claude-bengo/templates/）。他の案件には影響しないため、試しに
登録する・案件固有の派生版を作る、といった用途に安全。後から
/template-promote --to user|firm で他の案件からも使えるようにできる。firm）— 事務所全員で共有するクラウド同期フォルダに保存。
/template-firm-setup で事前に設定した Google Drive / Dropbox / OneDrive 等の
パスに保存される。事務所全員から見えるため、クライアントの個人情報が含まれて
いると保存できない（以下のガード参照）。未設定や同期フォルダに到達できない
場合は使えない（その旨を案内する）。user）— この PC 限定で、すべての案件から使える
ように ~/.claude-bengo/templates/ に保存。この PC 上の全案件から見えるため、
クライアントの個人情報が含まれていると保存できない（以下のガード参照）。優先順: 実行時は $ARGUMENTS の --scope フラグがあればそれを採用。なければ
以下を 1 度だけ尋ねる:
このテンプレートをどこに保存する？
1. この案件のみ（推奨・既定） — {案件フォルダ名} の中にだけ保存される
2. 事務所全員で共有 — クラウド同期フォルダに保存（要 /template-firm-setup、個人情報の混入注意）
3. この PC の全案件で共通 — この PC 上の全案件から使える形で保存（個人情報の混入注意）
番号で回答（未回答は 1）:
選択肢 2 を選んだ場合、事務所共有フォルダに到達できないと保存できない。事前に
python3 skills/_lib/workspace.py firm-status を呼んで確認するか、エラーが返ったら
/template-firm-setup <パス> を案内する。
保存場所が決まったら保存先ディレクトリを解決する:
# user スコープ
python3 skills/_lib/workspace.py templates # user_templates_dir を読む
# case スコープ
python3 skills/_lib/workspace.py resolve # workspace_root を読む
user → 保存先 = ~/.claude-bengo/templates/（workspace 初期化不要）case → 保存先 = {workspace_root}/.claude-bengo/templates/。walk-up で
見つからなければ CWD を silently 初期化する。重要（case スコープの制限）: CWD が ~/.claude-bengo/ 配下の場合、
ensure_workspace() は WorkspaceUnderGlobalError を投げて拒否する。
~/.claude-bengo/ は予約領域であり、その下を案件フォルダ扱いすると監査ログや
user テンプレートが混線する。エラーが発生したらユーザーに「別のフォルダ
に してから再実行してほしい」と案内する。
cdセキュリティ（user スコープ時の必須チェック）: user 保存前に、対象 XLSX に クライアントの実データが残っていないかを決定論的に走査する:
python3 skills/_lib/pii_scan.py scan --xlsx "<source.xlsx>" --json
戻り値 JSON:
{
"verdict": "clean" | "suspicious",
"count": 0,
"findings": [
{"category": "personal_name", "cell": "B3", "excerpt": "[シート:Sheet1] …甲野太郎様…", ...},
...
],
"by_category": {"personal_name": 2, "postal_code": 1}
}
verdict == "clean" ならそのまま Step 1 へ進む。"suspicious" の場合は、
user 保存は自動的に拒否 される（ユーザー override 不可）。
発見箇所を全件列挙したうえで、以下のいずれかを案内する:
⛔ 「この PC の全案件で共通」での保存は中止した。
このファイルにクライアントの個人情報のような記述が {N} 件検出されたため:
- B3 [氏名]: 「…甲野太郎様…」
- D7 [住所]: 「…東京都千代田区丸の内1丁目…」
- E9 [生年月日]: 「…生年月日: 昭和50年1月1日…」
次のいずれかを選んでほしい:
1. 「この案件のみ」に保存する — 現在の案件フォルダの中にだけ保存される
2. 中止する — 元の XLSX から上記の記述を削除して再実行
注意: pii_scan.py は conservative（偽陽性寄り）で、検出がプレースホルダや
記入例であることもある。しかし user はこの端末の全案件に波及するため、
偽陽性側に倒して拒否を既定とする。
開発者バックドア（ユーザーには案内しないこと）: 環境変数
CLAUDE_BENGO_ALLOW_PII_ON_GLOBAL=1 で findings を無視して保存できる（テスト・
CI 用 escape hatch）。通常運用では設定しない。
ユーザーにベースとなるXLSXファイルのパスを確認する。$ARGUMENTS で指定されている場合はそれを使用する。
ファイルが存在することを Glob または Read で確認する。
以下のMCPツールでXLSXの構造を把握する:
mcp__xlsx-editor__get_workbook_info — シート一覧、行数・列数、結合セル情報を取得mcp__xlsx-editor__read_sheet — セルデータを取得。大きなシート（50行超 or 結合セル多数）は range パラメータで30行ずつ分割して読み取る（例: range: "A1:N30" → range: "A31:N60" → ...）。全体を一括読取するとトークン制限を超えてエラーになる場合がある複数シートがある場合はユーザーにどのシートをテンプレート対象とするか確認する。
検出方法は 2 つ ある。$ARGUMENTS に --sample <path> が含まれているか、
あるいはユーザーが「記入済みの例がある」と申告した場合は A（サンプル差分モード、推奨）、
それ以外は B（LLM 近傍推論モード、従来） を使う。
--sample 指定または申告あり空テンプレ (blank.xlsx) と 1 件完全記入済みのサンプル (sample.xlsx) を
決定論的に突き合わせ、field を抽出する。section 見出し・小計行・2 列ラベルに強い。
python3 skills/_lib/template_detect.py diff \
--blank "<blank.xlsx>" \
--sample "<sample.xlsx>" \
[--sheet "<シート名>"]
戻り値 JSON の fields 配列にそのまま提案候補が入っている:
{
"fields": [
{"id": "field_1", "label": "事件番号:", "type": "text", "required": true,
"position": {"row": 3, "column": 2}, "example_value": "令和5年(ワ)第100号"},
{"id": "table_1", "label": "債権者一覧表", "type": "table", "required": true,
"range": {"headerRow": 5, "dataStartRow": 6, "startColumn": 1, "endRow": 8, "endColumn": 3},
"columns": [{"id": "col_1", "label": "№", "type": "number"}, ...]}
],
"warnings": []
}
これをそのまま Step 4 のテーブルに流し込み、ユーザーには「検出を確認して ほしい」と 1 発で提示する。LLM の勘よりも精度が高いため、フィールド個別の type 推論や position の手直しは最小限で済む。
ユーザーが sample を持っていない場合は「過去に同じ書式で作成した XLSX があれば それを使えばよい。なければ B モードに切り替える」と案内する。
セルデータを分析し、入力フィールド候補を特定する。以下のパターンを探す:
単一セルフィールド候補:
テーブルフィールド候補:
重要: テーブルの headerRow と dataStartRow の区別
range.dataStartRow には必ずデータ開始行を指定する。ヘッダ行を指定してはならない選択フィールド候補:
ユーザーにフィールド候補の一覧をテーブルで提示する:
| # | ラベル | セル位置 | 推定タイプ | 根拠 |
|---|--------|----------|-----------|------|
| 1 | 原告氏名 | C3 | text | 「原告氏名」(B3)の右隣が空 |
| 2 | 事故日 | C5 | date | 「事故年月日」(B5)の右隣が空 |
| 3 | 損害一覧 | A10:E20 | table | ヘッダ行+空行の繰り返し |
ユーザーと対話しながら以下を確定する:
フィールドの採否: 候補を承認/却下/追加
フィールドID: 英数字のスネークケースID（例: plaintiff_name, accident_date）。
判断に困ったら label をローマ字化した field_N 形式で自動生成してよい（ID は
内部キー、label が表示・マッピングの主軸のため）。
フィールドラベル: 日本語表示名
フィールドタイプ: text | number | date | textarea | select | table
必須/任意: required: true/false
セル位置:
position: { row: N, column: N } (1-indexed)range: { headerRow, dataStartRow, startColumn, endRow, endColumn } (1-indexed)
headerRow: 列ラベルの行番号dataStartRow: 最初のデータ行番号（ヘッダ行ではなく、その下の行）テーブルの場合: 各列の定義 columns: [{ id, label, type }]
選択の場合: 選択肢 options: [...]
マッピング補助（任意、推奨）: /template-fill が PDF からこのフィールドに
入れる値を正しく拾うためのヒント。label だけで曖昧な場合は必ず聞く:
description: 1-2 文で「何を入れるフィールドか」を書く（例:「債務者の戸籍上の
氏名。相手方弁護士の氏名ではない」）synonyms: ソース文書で使われそうな別名（例: ["借主", "お名前", "契約者名"]）example_value: 記入例（例: "甲野太郎" / "1,000,000" / "令和5年3月1日"）label が明確（例: 「事件番号」）ならスキップしてよい。曖昧（例: 「氏名」「金額」 「日付」）の場合はユーザーに「これはどの場面の氏名か」などを 1 回だけ確認し、 その回答を description に転写する。
Step 4 で確定したフィールドのセル位置が本当に正しいかを視覚的に確認するため、
blank XLSX のコピーに センチネル値（<<氏名>> <<金額>> 等）を書き込んで
ユーザーに見てもらう:
<blank>.preview.xlsx にコピーposition に mcp__xlsx-editor__write_cell で
<<{label}>> を書き込む（label が空なら <<{id}>>）dataStartRow の 1 行目にだけ各列のセンチネルを書き込む<blank>.preview.xlsx を開いて、各 <<...>> が想定どおりの
セルに入っているか確認してほしい」と案内スキップ条件: Step 3 で A（サンプル差分モード）を使った場合は検出が 決定論的なので、ユーザーが「差分モードの結果を信用してスキップ」と明示すれば 省略してよい。B モード（LLM 近傍推論）の場合は必ず通す。
一時プレビューファイルは Step 7 完了後に削除する。
テンプレートの基本情報をユーザーに確認する:
id: 一意識別子（ファイル名に使用。英数字・ハイフン）title: テンプレート名（日本語）description: 説明（1-2文）category: カテゴリ（自由記述。例: 民事訴訟, 家事事件, 交通事故, 相続, 労働）確定したフィールド定義を YAML 形式の文字列として組み立てる（まだ書き込まない）。 Step 7 で XLSX と一緒に保存する。
Write + copy_file.py で直接保存してはならない。 template_lib.py save-user
を呼ぶことで、user スコープ時に PII 混入を code レベルで ブロックする:
# YAML を一時ファイルに書いてから
# /tmp/template-{id}.yaml に組み立て結果を Write
python3 skills/_lib/template_lib.py save-user \
--source "<original xlsx>" \
--id "<template_id>" \
--scope "<case|user>" \
--yaml-file /tmp/template-{id}.yaml \
[--replace]
戻り値 JSON の code: "pii_found" が返った場合（exit 4）は以下を行う:
findings 配列をユーザーに全件表示--scope case）他の exit コード:
--replace を検討）Step 7 は本コマンドで置換されるため不要。
ID 検証（必須）: テンプレート {id} は以下の正規表現を必ず満たすこと:
^[a-z0-9][-a-z0-9_]{0,63}$
.、/、\、空白、大文字、非 ASCII は禁止。これは {dest_dir}/{id}.yaml を生成するときに .. や絶対パスで保存先ディレクトリの外に書き出す path-traversal を防ぐためである。ユーザーが提案する ID が規則に合わない場合は、該当箇所を示して「英小文字・数字・ハイフン・アンダースコアのみで再提案してほしい」と返す。
YAML形式はプラグインの templates/_schema.yaml に準拠する。
v3.3.0-iter1 以降は template_lib.py save-user が YAML 書込と XLSX コピーを
一括で行う。個別の Write / copy_file.py は呼び出さない（PII code-gate を迂回
させないため）。
以下を表示する:
/template-fill での使用方法XLSXのセルアドレス（A1, B3 等）をYAMLの行列番号に変換する:
/template-fill では「この案件のみ」が「この PC の全案件で共通」を上書きして見えるため、意図しているか確認を促す。テンプレート登録完了時、以下を提案する:
💡 次の一手:
- 登録した書式にデータを入れる: /template-fill <ソース PDF>
- 登録済み書式を一覧: /template-list
- 別の書式も登録: /template-create <別の XLSX>