القائمة
既存の reStructuredText 製 Sphinx ドキュメントを rst-to-myst で MyST Markdown へ移行するスキル。実質的な RST コンテンツを持つプロジェクトの移行を求められたときに使用する(sphinx-quickstart の雛形だけの場合は対象外)。変換結果を検証してから元ファイルを削除する。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | rst-to-myst |
| description | 既存の reStructuredText 製 Sphinx ドキュメントを rst-to-myst で MyST Markdown へ移行するスキル。実質的な RST コンテンツを持つプロジェクトの移行を求められたときに使用する(sphinx-quickstart の雛形だけの場合は対象外)。変換結果を検証してから元ファイルを削除する。 |
| license | MIT |
| allowed-tools | Bash, Read, Write |
検出優先順位 (該当した時点で確定):
| 優先 | 判定条件 | 採用 |
|---|---|---|
| 1 | uv.lock が存在 | uv |
| 2 | poetry.lock が存在 | poetry |
| 3 | Pipfile.lock が存在 | pipenv |
| 4 | .venv/ のみ存在 | plain venv |
| 5 | 上記すべて該当しない | ユーザー問い合わせ (推奨: uv) |
rst-to-myst パッケージは依存に含めず単発実行する (ad-hoc)。PM ごとの実行コマンド:
| PM | ad-hoc 実行 |
|---|---|
| uv | uvx --from "rst-to-myst[sphinx]" rst2myst convert <files> |
| poetry | pipx run --spec "rst-to-myst[sphinx]" rst2myst convert <files> (要 pipx) |
| pipenv | pipx run --spec "rst-to-myst[sphinx]" rst2myst convert <files> (要 pipx) |
| plain venv | pipx run --spec "rst-to-myst[sphinx]" rst2myst convert <files> または pip install で venv に追加 |
pipx 不在時はパッケージを一時的に依存追加 → 実行 → 削除する手順を提示する。
数ファイル以上の実コンテンツを持つ既存 RST プロジェクトの移行。
sphinx-quickstart -q が生成した最小 index.rst 単体 — sphinx-init が直接 MyST テンプレートで生成するため、本スキルは呼ばれない。
docs/ 配下に複数の .rst ファイルが存在し (sphinx-quickstart 生成 index.rst のみではない)、移行希望が示された場合sphinx-init MyST 選択時に index.rst 以外の .rst を検出した場合 (sphinx-init からの委譲呼出)docs/ 配下全体.rst のサイズを記録 (検証で参照)冒頭の「パッケージマネージャ検出と一時ツール実行」表に従い、検出した PM に対応するコマンドを実行する。
# uv の例
uvx --from "rst-to-myst[sphinx]" rst2myst convert <files>
以下のすべてを満たす場合のみ「変換成功」とみなす:
.md ファイルが生成されている (存在確認).md ファイルが空でない、かつサイズが原本 .rst の 30% 以上<SYSTEM MESSAGE: ...> 等の rst-to-myst 既知エラーマーカ) を含まないいずれか不成立の場合:
.rst を残す.md を削除上記 3 が「変換成功」の場合のみ .rst を削除する。
sphinx-config スキルへ委譲し myst-parser を extensions に追加する。
myst-authoring スキルが今後 .md 編集時に自動発火する旨を伝える。
sphinx-config (myst-parser 追加)myst-authoring (変換後の MyST 執筆)sphinx-init (index.rst 以外の .rst 検出時)Sphinx ドキュメントの MyST Markdown 執筆支援スキル(ディレクティブ・ロール・相互参照・数式・sphinx-design)。extensions に myst_parser があるプロジェクトで docs/ 配下の .md を編集・作成するときや、MyST 記法について質問されたときに使用する。
sphinx-revealjs のスライドを MyST で書くための記法ルール(見出しレベルによるスライド分割、list-table、2 カラムレイアウト等)。extensions に sphinx_revealjs があるプロジェクトで docs/ 配下の .md を編集・作成するときに使用する。汎用 MyST 記法は myst-authoring が担当。
sphinx-revealjs の conf.py 設定(プラグイン・コードハイライト・テーマ・スライド寸法・表の中央寄せ・Mermaid 統合)の知識を提供するスキル。sphinx-revealjs プロジェクトでスライドの見た目や挙動を変更・修正するときに使用する。conf.py 編集の実行は sphinx-config に委譲する。
sphinx-revealjs によるスライド専用プロジェクトを初期化するスキル。docs/ が未作成のプロジェクトで発表スライドの新規作成を求められたときに使用する。依存追加・MyST テンプレート生成・テーマ選定・Makefile 整備までを行う。
Sphinx ドキュメント・スライドを Makefile 経由でビルドするスキル(HTML・latexpdfja・EPUB・linkcheck・livehtml・revealjs)。ドキュメントやスライドのビルド・プレビュー・開発サーバー起動・リンクチェックを求められたときに使用する。パッケージマネージャ検出とビルドエラーの解釈は本文参照。
docs/conf.py を既存設定を保ちながら安全に更新するスキル。Sphinx 拡張の追加・削除、テーマ、プロジェクトメタデータなど conf.py の変更を求められたときに使用する。