インストール
write the script and import directly誰向けか
スプレッドシートが主な入力または出力であるときは、この xlsx ガイドを使う。既存の .xlsx、.xlsm、.xltx、.csv、.tsv を開く、読む、編集する、修復する作業をカバーする。成果物はスプレッドシートファイルでなければならない。
主な成果物が Word、HTML レポート、独立した Python スクリプト、データベースパイプライン、Google Sheets API 連携であるときは、途中に表データがあっても起動しない。資料はエージェント製品の一覧を出しておらず、特定ソフトの独占だと捉えてはいけない。公式ガイドページは
https://raw.githubusercontent.com/anthropics/skills/main/skills/xlsx/SKILL.md
3 分で最初の試行を終える
推奨経路：openpyxl、pandas、markitdown はすべてプリインストール済み。先に pip install せず、スクリプトを書いて直接インポートする。
前提：今の環境でこの 3 つのライブラリを直接 import できること。低リスクな最初の試行は読み取り専用の確認であり、先にディスクへ書かない。すでに存在するローカルの表ファイルに対して markitdown をインポートして素早く見る。ファイルがなければオープン失敗で止め、指名されていないサンプル表を新規作成しない。
成功の合図：インポートが成功し、そのファイルのテキスト概要が見えること。修復でも上書きでもない。既存ファイルがなく、利用者が表の作成を明示したときだけ openpyxl での作成に切り替え、ディスク書き込みの前にファイル名と上書きの有無を確認する。
作成時は覚えること：数式を使い、Python が先に計算したハードコード結果を書き込まない。資料の例はセルを =SUM(B2:B9) のような数式として書く。入力が変わってもシートが再計算できる。
利用例
例 1：再計算する表を新規作成または変更する。プリインストール済みの openpyxl でスクリプトを書き、インポート後に合計を数式にする。例えば B10 は =SUM(B2:B9) を使い、先に Python で足して数字を書き込まない。完了基準はファイル内が数式であり、入力が変わるとシートが再計算できること。概要は一括読み書きを pandas、素早い確認を markitdown に残す。この例は数式の書き込みだけをカバーする。抜粋は完全なスタイル API を出していないので、現れない書式関数を作らない。
例 2：数式を含むファイルは、値を読む前に再計算しなければならない。資料は書く：ファイルに数式がある限り、再計算は必須手順である。openpyxl は数式を文字列として書き、キャッシュ値を持たない。再計算するまで、各数式セルの読み戻しは None である。これは可逆の確認である。書き終えたばかりのファイルを開き数式セルを読む。None ならまだ再計算していないのでそこで止め、再計算を終えてから読んだ値を結果とする。None を合計ゼロと解釈しない。
利用上の境界
スプレッドシート自体が主成果物であるときにだけ使う。Word、HTML、独立スクリプト、データベースパイプライン、Google Sheets API は表を含んでいてもこの経路を取らない。3 つのライブラリはプリインストール済みで、既定では先に pip install しない。数式は入力に応じて再計算できなければならない。書き込み後は再計算必須であり、さもなければ読み戻しは None になる。
現れないリポジトリパスをインストールコマンドとして書かない。ハードコードした数字を合計の代わりにしない。ディスク書き込みや元表の上書きの前に、対象パスと副作用を確認してから実行する。ここに書いたファイル種類、インポート方法、再計算要件を超える範囲は、この説明の対象外である。