excel-cli

Excel CLI の検出

このプラグインは excelcli を PATH に配置しません。ランチャーは npx -y @sbroenne/excelcli@latest を実行します。単独の実行可能ファイルが インストールされていると想定したり、廃止された GitHub リリースのダウンローダーを 復活させたりしないでください。

このスキルのプラグイン同梱版では、SKILL.md があるディレクトリから見て ..\..\bin\start-cli.ps1 にプラグインのランチャーがあります。 以下の <plugin-root> を、そのプラグインが実際にインストールされているディレクトリに置き換えてください。 これらのコマンドは Windows PowerShell 5.1 ではなく、PowerShell 7.4 以降（pwsh）で実行してください。

& "<plugin-root>\bin\start-cli.ps1" --help
& "<plugin-root>\bin\start-cli.ps1" session --help

以降のコマンド、特に引用符で囲んだ JSON 引数には、同じ完全なランチャーパスを使用してください。 正確なコマンド名、フラグ、既定値、保存／終了時の動作は、ネイティブの --help で確認してください。 構文を推測してはいけません。

リクエストに関係する既存のブックの状態を調べてください。無関係な内容は保持し、許可された結果だけを保存してください。操作が失敗した場合は、ロールバックされたと想定したり、自動的に後片付けしたりせず、報告された部分的な状態を確認してください。 ブックを開く前に session discover を実行し、すでに開いているブックを探してください。対象の workbookId を確認してから、ブックが再度開かれないように session attach --workbook-id <ID> を使用してください。検出結果の complete と errors を確認してください。スキャンが不完全な場合、ブックが存在しないことは確認できません。attach は未保存の編集内容を保持し、サービスの終了後もブックを開いたままにします。その応答には現在の AutoSave 設定が報告されます。open も設定を保持します。AutoSave が有効な場合、Excel が編集内容を自動保存することがあります。通常のサービス終了では、所有する未保存のブックは保存も破棄もされず、開いたまま表示されます。作業が完了したら、明示的に保存して閉じてください。 待機がタイムアウトした場合は、session list で操作の開始時刻、保留中の作業、最終的な結果を確認してください。自動的に再実行してはいけません。アクティブなリクエストがゼロでも、Excel の処理が完了したとは限りません。完了後にブックを確認してください。 service status と service stop は、以前のサービスから記録された Excel のコピーを報告します。すでに停止しているサービスを停止しても、それらのコピーは開いたままであり、新しいサービスを妨げません。service stop は常にサービスを停止します。ブックが処理中だった場合、または状態を確認できなかった場合、その Excel のコピーはそのまま残され、shutdownWarning に報告されます。それらを調べるには、検出と明示的なアタッチを使用してください。不明または不完全な情報を、Excel を終了する許可と見なしてはいけません。 JSON エラーの場合は、唯一のエラーテキストフィールドとして errorMessage を読み取り、存在する場合は復旧方法の判断に errorCategory を使用してください。 excel-cli-report-formatting は、レポートの表示形式がリクエストされた場合にのみ読み込んでください。通常の Excel の読み取りや対象を絞った更新には読み込まないでください。