ref-cross-platform-runtime

Purpose & Output Contract

Python 標準ライブラリを実行基盤の正本とし、Mac / Linux / Windows / unknown を横串で扱うための共通契約を提供する。 本 ref を import した skill は次の dict を呼び出し元へ返せる:

{
  "os": "mac|linux|windows|unknown",
  "python_cmd": "python3|python|unknown",
  "python_available": true,
  "fallback_used": false
}

Boundary

• 責務: OS 判定動線・フォールバック文面・no-deps 原則の宣言
• 非責務: 個別 secret 取得（→ scripts/cross_platform_secret.py に委譲）

Key Rules

1. 実行は Python 標準ライブラリを既定にする。生成・検証・adapter・hook（設計書 28 章 §3.2 の L2）は .py を正本とし、.js / .sh で新規に作らない。
2. Node.js / npm / npx / yarn / pnpm を必須化しない。既存の Node 前提が見つかった場合は Python stdlib に置換する。
3. Bash は Claude/Codex 側の tool 名として Python (python_cmd) を起動する場合と、本文の OS 判定の注入 (Rule 4) に限って使う。L2 の処理を shell script にして配布しない（lifecycle の .sh は Gotchas）。
4. OS 判定は、Skill 本文では uname -s の注入（設計書 22 章）、script の中では Python の platform / shutil.which で行う。判定不能または Python 不在なら自走せずユーザーへ問い合わせる。
5. ユーザー宣言値は 会話スコープのみ に保持。長期記憶へ焼き込まない。
6. 追加導入を要求する CLI を呼ばない（jq, yq, rg, node, npm, requests, PyYAML 禁止）。

Steps

参照用。手順なし。本文を import する skill 側が以下を組み込むこと。

Runtime 判定 (script に貼る雛形)

import platform
import shutil

system = platform.system().lower()
os_kind = {"darwin": "mac", "linux": "linux", "windows": "windows"}.get(system, "unknown")
order = ("python", "python3") if os_kind == "windows" else ("python3", "python")  # Windows は python を先に探す
python_cmd = next((c for c in order if shutil.which(c)), "unknown")  # path でなく名前を返す
python_available = python_cmd != "unknown"

unknown フォールバックプロンプト

Python 実行環境または OS を判定できませんでした。次を教えてください。
  1. OS: macOS / Linux / Windows
  2. Python 起動コマンド: python3 / python / 未インストール
回答に応じて、以降は os=mac|linux|windows、python_cmd=python3|python で分岐します。

Gotchas

• 生成・検証・adapter・hook の処理は、macOS 向けでも bash 前提の .sh で配布せず、Python の pathlib / shutil / subprocess で書く。install などの lifecycle の .sh（設計書 28 章 §3.2 の L1。同 06 章 第10条で scripts/ に置ける）はこの対象の外。
• WSL は platform.system() == "Linux" として扱う（ユーザーに確認しない）。
• Windows では PowerShell 固有構文を本文に直書きせず、Python 実装に閉じる。

Additional Resources

• references/os-matrix.md — OS × Python × 判定マトリクス
• references/forbidden-clis.md — no-deps 原則で禁止される CLI 一覧
• 設計書 22 章 — クロスプラットフォームランタイム正本
• plugins/skill-governance-automation/scripts/cross_platform_secret.py — secret OS 分岐実装例