SzTk OpenL Tablets 編集スキル
OpenL Tablets 形式の Excel ファイルを読み書きする openl CLI を使い、確認・編集・書き戻しを行う。
前提
openl コマンドがインストール済みであること。
未インストールの場合は以下を実行:
uv tool install git+https://github.com/SzTk/openl-tablets-tool
または
cd <リポジトリ>/excel-tool && uv tool install .
ステップ
Step 1: 対象ファイルの確定
引数 $ARGUMENTS が指定されていればそれを対象ファイルとする。
指定がなければ、カレントディレクトリの .xlsx ファイルを一覧してユーザーに選択を求める。
対象ファイルのパスを絶対パスに解決する。
Step 2: Excel → JSON 変換
openl read <対象Excelの絶対パス> --format json
JSON は Excel と同じディレクトリに <元ファイル名>.json として出力される。
Step 3: 構造サマリーの表示
JSON を Read ツールで読み取り、以下の形式でユーザーに示す。
ファイル: <ファイル名>
[PriceRules] SimpleDecisionTable
条件: Origin (String), Destination (String), Class (String), Age (int)
結果: BasePrice (double)
ルール数: 12 件
[DiscountRules] SimpleDecisionTable
...
[Airports] DataTable
列: Code, City, Country, Region, Notes
行数: 12 件
[Constants] DataTable
...
[FinalPriceCalc] SpreadsheetTable
パラメータ: 6 件 / ステップ: 6 件
Step 4: 編集内容の受け付け
ユーザーの指示に従い、JSON ファイルを Edit/Write ツールで変更する。
編集の典型例:
- ルール追加:
tables[n].rulesに新しいRuleオブジェクトを追加。idは末尾の最大値 +1。 - ルール変更: 対象ルールの
conditionsまたはresultsの値を変更。 - 行追加 (DataTable):
tables[n].rowsに{"data": {...}}を追加。 - 定数変更 (Constants): 対象行の
data.Valueを変更。 - パラメータ変更 (SpreadsheetTable):
parametersのvalueを変更。
制約の遵守:
idの連番を崩さない- 型 (
col_type) に合った値を使う（String は"\"値\""形式、数値はそのまま） conditionsの書式（>= 12 && < 65など）を既存ルールに合わせる
Step 5: JSON → Excel 書き戻し
openl write <JSONファイルパス> --out <元ファイル名>_edited.xlsx
openl write は、JSON に記録された元Excel（source_file、openl read 実行時のファイル名）が同じディレクトリに存在する場合はパッチモードで書き込む。パッチモードはセルスタイル・書式・列幅などを保持し、変更箇所のみを差分反映する。元ファイルが見つからない場合はフルリビルド（全体再構築）にフォールバックする。どちらのモードが使われたかは実行結果に表示される。
元ファイルが別の場所にある場合は --source <元のExcelパス> で明示する。
元ファイルを上書きする場合はユーザーの明示的な確認を得てから --out <元のExcelパス> を使う（パッチモードであればスタイルは保持される）。
Step 6: 完了報告
✅ 編集完了
変更内容:
- <変更点の要約>
出力ファイル: <出力パス>
JSON スキーマ
JSON 構造・型記法・制約の詳細は skills/openl-lib/SCHEMA.md を Read して参照すること。
注意事項
- String 型の条件値は OpenL 記法に従い
"\"値\""形式でラップする