openpress-create-pages について
openpress-create-pagesは、OpenPressでページ形式の文書を作成するスキルです。成果物の構成、内容のルール、ソースの確認、レビューの範囲を扱い、レポートや書籍などの作成を支援します。
主な機能
- 01新規または既存のPressを準備
- 02ページ成果物とソースファイルを整理
- 03文書構成とレイアウト規則を適用
- 04確認済みの事実を保ち不足を明示
- 05レビュー前に作成内容を確認
活用シーン
- 01OpenPressでレポートや提案書を作成
- 02書籍や教材の構成を整理
- 03納品前にページ内容を確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/openpress-create-pagesを入力して読み込まれたか確認します。
同梱ファイルreferences/press-tree.mdreferences/theme.md
詳細
OpenPress Create Pages
このスキルでは、ページ成果物の構造と内容を判断します。openpress では CLI のライフサイクルと納品を扱い、openpress-collaborate では既存の作成済みコンテンツの改訂モードを扱います。
セットアップ
OpenPress を利用するには、Node 20 以降が必要です。ワークスペースに Press がすでにあるかどうかを確認します。
node -v
find press -mindepth 2 -maxdepth 2 -name press.tsx -print -quit 2>/dev/null | grep -q . && echo EXISTING || echo FRESH
- 空の新規フォルダー：
npm create @open-press <target> -- --type pagesを使用して、生成された最小構成の pages Press を拡張します。空でないターゲットを強制的に指定しないでください。 - 既存のワークスペース：
press/*/press.tsxを調べ、新しい slug を選び、open-press create <slug> --type pages --title "<title>"を実行してから、新しいpress/<slug>/のみを拡張します。
ページの要件
執筆前に、文書の概要と確認済みの資料を集めます。OpenPress 固有の既定値と制約は次のとおりです。
- レポート、提案書、ホワイトペーパー、論文、書籍、講義ノート、ハンドブックには
page="a4"を使用します。カスタムのページ寸法が必要な場合に限り、確認してください。 - ページ寸法は CSS ではなく、
<Press page>に設定します。 - 公開する MDX ソースは
press/<slug>/press.tsxに登録します。内部向けの計画はpress/design.md、memory/、またはスキル内に保管します。 - 成果物固有のコンポーネント、メディア、テーマは
press/<slug>/内に保管します。意図的に複数の Press 間で再利用する場合に限り、press/shared/を使用します。 - ライセンスが許諾されたセルフホストフォント、またはシステムフォントのフォールバックを使用します。最終的なテーマをリモートのフォント CSS に依存させないでください。
- 確認済みの事実を維持します。不足している資料は創作せず、
[TODO: ...]、[DRAFT: ...]、または[FIX: ...]と記します。
フォルダーツリーまたは Press TSX を作成する前に、references/press-tree.md を読んでください。テーマまたはページコンポーネントを書く前に、references/theme.md を読んでください。
文書構造
#：文書タイトルまたは表紙の識別情報のみ。##：正式な章または文書単位。目次に含まれます。###：主要なトピックグループ。目次に含まれます。####：手順、定理、例、参考項目などの局所的な項目。通常、目次には含まれません。- キャプション付きの表の前には
<TableCaption>を置きます。図表番号は OpenPress が管理します。 - 本文で図や表に言及する場合は、参照先に安定したセマンティック ID を付け、番号を直接記述する代わりに
@fig-stable-nameまたは@tbl-stable-nameと記します。OpenPress はレンダリング時に、現在のローカライズ済み番号を解決します。これらのリンクを記述する前に、references/press-tree.md→ Caption Targets And Semantic References を読んでください。 - 作成者が後続のコンテンツを新しいページから始めることを明示的に望む場合は、その直前に
<PageBreak />を置きます。スペーサーコンテンツや、より詳細なページネーション CSS でその意図を再現しないでください。
学習者向けの文書では、検証に役立つ場合、状態が変化する手順と期待される結果を示します。専用の図、アーキテクチャ図、またはビジュアルツールが必要な場合は、openpress-plugins を読み込みます。
検証
共通のレビューチェックに進む前に、作成したソースをスキャンします。
open-press search . "[TODO:" --scope all --json
open-press search . "[DRAFT:" --scope all --json
open-press search . "[FIX:" --scope all --json
その後、openpress → Review And Delivery Gate に従います。ビルドや PDF のエクスポートに成功しただけでは、ページレイアウトの検証にはなりません。
Press の slug、タイトル、ページ寸法、ソースルート、書き込んだファイル、未解決の入力、および最新の検証結果を報告します。
適用範囲
- アップグレードや移行には create コマンドを使用しないでください。
- このスキルでは、生成された出力を編集したり、公開したりしないでください。