메뉴
Use when the user asks to "open" a file, folder, notebook, or design document. Generates SystemOpen[] calls that launch files/folders in the OS default application. Does NOT read/write file contents.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when locating a function, option, symbol, or "where is X handled/implemented" inside this system's own packages (SourceVault, ClaudeOrchestrator, ClaudeRuntime, NBAccess, claudecode, github) — i.e. the initial narrowing step of a code-investigation task, before reading files. Prefer SourceVault MCP packageapi mining over a broad full-text rg sweep of $packageDirectory. Covers concept-token query discipline, sourcevault_get view=body, freshness (StaleDocs) handling, filters.packages scoping, and the bounded grep fallback.
Manipulate/DynamicModule/Dynamic ベースの一覧パネル (SourceVault ワークフロー一覧・ 保存プロンプト一覧など) が「一瞬フリーズしてから $Aborted」になり中身が出ない事故の 原因と直し方。真因は (1) DynamicModule の body や Dynamic[...] の中身の評価は FE の 評価予算で外部 Abort される (通常セル評価と違い時間切れで $Aborted になる)、 (2) Grid 描画 Dynamic の中で「行ごとに重い全走査関数」を呼ぶと row*N 倍のコストで 予算超過する、の 2 点。重いデータは DynamicModule の外 (公開関数の通常評価) で先に 算出して焼き込み、繰り返し読む registry はキャッシュし、行ごとの重い lookup は NextFire 等の不要フィールド計算を外す。headless で再現しないときは FE だけがロード する副パッケージ (SourceVault_autotrigger 等) の差分を疑う。 Use when a Wolfram panel/palette shows $Aborted (especially after a brief FE freeze) instead of its list/grid, when a DynamicModule/Manipulate UI is slow to render or gets aborted, when adding per-row badges/status cells to a list Grid, or when a UI bug reproduces in the FrontEnd but not in headless wolframscript. 関連 rules: 95 (ScheduledTask 安全)。関連 skill: ui-output-font-customization, wolfram-syntax-pitfalls。
Use when generating or updating package documentation with ClaudeCreateDocumentation or ClaudeUpdateDocumentation. Covers resumption after limits, README structure, document queue ordering, and option usage.
Use when the user reports the SourceVault MCP server (or any SourceVault detached service) is stuck "停止中"/Stopped and clicking the palette toggle does not bring it back, when SourceVaultMCPRunningQ stays False, or when diagnosing detached WL service kernel + Python proxy lifecycle (start/stop/restart/heartbeat/scheduled-task/per-machine runtime) issues in SourceVault_servicemanager.wl. Covers the stale status.json "Running" after a kernel crash trap, the PidAlive gate, runtime file inspection, and immediate recovery.
SourceVault.wl の ingest 済みソース行 (SourceVaultSources / SourceVaultArXiv) の Summary 列を埋める設計 (2026-06-24 実装)。arXiv ソースは ingest 時にアブストラクトを arXiv API から取得し $Language へ翻訳して meta["Summary"] に格納する (iIngestURL フック、 同期/非同期両カバー、TimeConstrained best-effort)。既存ソースは公開 API SourceVaultBackfillArXivSummaries[] で backfill。翻訳は cloud LLM (arXiv は公開なので PL 0.0)、iSVLooksLikeLLMError ゲートで利用制限/エラー本文の保存を防ぐ、失敗時は原文 fallback。 Use when implementing or modifying source-row Summary population, arXiv abstract fetch, ingest-time enrichment, or summary translation in SourceVault. 表示パスを LLM-free に保つ 原則と headless $Language 罠を含む。
Use when generating or editing .wl or .m files, dealing with Unicode escapes, Windows Mathematica encoding issues, Japanese identifiers, or RegularExpression patterns in Wolfram Language.
| name | system-open |
| description | Use when the user asks to "open" a file, folder, notebook, or design document. Generates SystemOpen[] calls that launch files/folders in the OS default application. Does NOT read/write file contents. |
ユーザーが以下のような表現を使ったとき:
| ユーザーの意図 | 使う関数 | 例 |
|---|---|---|
| ファイルをOSで開いて表示 | SystemOpen[path] | 「init.m を開いて」 |
| ファイルの中身を読んで処理 | Import[path] / ClaudeEval | 「init.m に〜を追加して」 |
| ファイルの中身を教えて | Import[path, "Text"] | 「init.m の内容は？」 |
「開いて」だけの場合は SystemOpen を使う。 内容の変更・読み取りが目的の場合は SystemOpen を使わない。
(* パッケージファイル *)
SystemOpen[FileNameJoin[{$packageDirectory, "init.m"}]]
(* パッケージの _info/design フォルダ *)
SystemOpen[FileNameJoin[{$packageDirectory, "claudecode_info", "design"}]]
(* NotebookDirectory 内のファイル *)
SystemOpen[FileNameJoin[{Quiet @ Check[NotebookDirectory[], $packageDirectory], "file.xlsx"}]]
(* _info/history フォルダ *)
SystemOpen[FileNameJoin[{$packageDirectory, "PackageName_info", "history"}]]
$packageDirectory — パッケージルートFileNameJoin[{$packageDirectory, "init.m"}] — 初期化ファイルFileNameJoin[{$packageDirectory, name <> "_info", "design"}] — デザインノートFileNameJoin[{$packageDirectory, name <> "_info", "docs"}] — ドキュメントFileNameJoin[{$packageDirectory, name <> "_info", "history"}] — バックアップ履歴FileNameJoin[{$packageDirectory, "Claude Directives"}] — ディレクティブIf[FileExistsQ[...], SystemOpen[...], "ファイルが見つかりません"] で安全に処理するSystemOpen はメインカーネルのトップレベル評価機会でのみ効く。 SessionSubmit / ScheduledTask / 共有 polling tick の評価コンテキストで呼ぶと、エラーも出さず何も起きない (silent no-op)。
| コンテキスト | SystemOpen の効き |
|---|---|
| トップレベルセル評価 (直接) | ✅ 開く |
Button 本体 (Method -> "Queued" = メイン評価) | ✅ 開く |
SessionSubmit[SystemOpen[...]] | ❌ 開かない |
SessionSubmit[ScheduledTask[SystemOpen[...], ...]] | ❌ 開かない |
共有 polling tick (ClaudeRegisterPollingTick) 経由 | ❌ 開かない |
承認ボタンや非同期処理の中から「開いて」を実行する設計では、SystemOpen だけはメイン評価機会で呼ぶこと。重い処理を SessionSubmit で非同期化していても、desktop 操作はボタン本体 (メイン評価) に分離する。詳細は rule 95-scheduled-task-safety 節 G。
(* ✅ 承認ボタン: パス検証は委譲、SystemOpen はボタン本体で直接 *)
Button["承認",
If[!decided, decided = True;
Module[{info},
info = NBAccess`NBResolveDesktopActionPath[heldExpr, accessSpec];
If[TrueQ[info["Validated"]], SystemOpen[info["Path"]]]]],
Method -> "Queued"]
(* ❌ SystemOpen を非同期コンテキストで呼ぶと silent no-op *)
Button["承認",
SessionSubmit[ScheduledTask[SystemOpen[path], {0.3, 1}]],
Method -> "Queued"]
LLM が生成する無修飾 NBOpenFolderWithApproval[...] は、$ContextPath に NBAccess\`` が無いと Global`NBOpenFolderWithApproval (未定義) に解決され、ReleaseHold` しても未評価式のまま返り SystemOpen に到達しない。
対策として NBAccess は NBResolveDesktopActionPath[held, accessSpec] を提供する。これは head の context に依存せず SymbolName で wrapper を検出し、パス式を安全評価して検証だけ行う (SystemOpen は呼ばない)。呼び出し側 (承認ボタン本体 = メイン評価) が検証済みパスに対して raw SystemOpen を直接呼ぶ。これで Global\`` shadow にも $ContextPath` にも左右されない。