openpress について
openpressは、OpenPress CLIとコンテンツ納品向けのワークフロー型スキルです。Pressプロジェクトの編集や公開を行う人を対象に、作業を専門スキルへ振り分け、ソースの境界とローカルレビュー手順を定めます。
主な機能
- 01作業をOpenPressの専門スキルへ振り分け
- 02編集可能領域と読み取り専用領域の区分
- 03ビルドとWorkbenchレビューの確認項目
- 04エクスポートと更新手順の説明
活用シーン
- 01ページやスライド作業に適したスキルの選択
- 02レイアウトやページ割り変更のローカル確認
- 03指定されたPDF、画像、Wordのエクスポート準備
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ quan0715/ open-press --skill openpressインストール後、Claude Code で/openpressを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/cli-commands.mdlocal-review.mdrender-boundary.md詳細
OpenPress
OpenPress CLI とデリバリーの作業では、まずこのスキルを使用します。
ルート
| 必要な作業 | スキル |
|---|---|
| ページ成果物の作成 | openpress-create-pages |
| スライドの作成または編集 | openpress-create-slide |
| 作成済みコンテンツの分析、提案、または改訂 | openpress-collaborate |
保留中の @openpress-comment マーカー | openpress-apply-comments |
| 外部プラグイン(図表、ビジュアルツール、ライティング支援ツール) | openpress-plugins |
| パッケージのアップグレードまたは移行 | openpress-upgrade |
| デプロイまたは公開 | openpress-deploy |
コンテンツ上必要な場合に限り、汎用の言語スキルまたはジャンルスキルを読み込みます。
ソースの境界
| レイヤー | パス | ルール |
|---|---|---|
| ワークスペースのソース | press/*/press.tsx、登録済みの MDX/TSX ソース、press/<slug>/{components,theme,media}/、任意の press/shared/、press/design.md、openpress/settings.json | 編集可能 |
| スキルのソース | skills/、.agents/skills/、.claude/skills/ | スキル関連の作業では編集可能 |
| フレームワークのソース | packages/core/、packages/cli/、apps/web/、ルートの設定/ドキュメント/テスト | フレームワーク関連の作業に限る |
| レビュー引き継ぎ | .openpress/review/current.json | openpress-collaborate は置き換えまたは削除できます。デリバリーやコミットはしないでください |
| インストール済みフレームワーク | node_modules/@open-press/{core,cli}/ | 読み取り専用。上流で修正してください |
| 生成物/キャッシュ | public/openpress/、dist-react/、.deploy/、その他の .openpress/、.turbo/cache/ | 直接編集しないでください |
openpress/settings.json は、ワークスペースの外観、ページのデフォルト、キャプションの番号付け、PDF ファイル名、デプロイ設定を管理します。Press のビジュアルデザインは press/design.md と各 Press のテーマで管理します。
memory/AGENTS.md が存在する場合は、最初に読み込んでください。そこには、下流のワークスペースとそのプロジェクトのルールが記載されています。
ローカルレビューチェック
コンテンツ、レイアウト、コンポーネント、Press Tree、またはページネーションに影響するテーマを変更した後は、次の手順を実施します。
npm run build
npm run dev # downstream workspace
# npm run dev:workspace # framework dogfood repo
Vite の /workspace を開き、該当する Press を確認して、ページ数、はみ出し/切り抜き、ページネーション、タイポグラフィ/メディア、保留中のコメントを確認します。必要に応じてソースを修正し、確認を繰り返します。
ローカル Workbench でレビューした後、依頼された形式のみをエクスポートします。
npm run openpress:pdf
npm run openpress:image
npm run openpress:word
PDF/画像/Word のエクスポートは、Workbench でのレビューの代わりにはなりません。
更新の境界
Vite HMR では public/openpress/<slug>/document.json は再生成されません。MDX、Press Tree、コンポーネント、メタデータ、またはページネーションに影響するテーマを編集した後は、レビュー前に npm run build を実行してください。反復作業を速めるには、open-press export . を実行してブラウザーを更新します。コンテンツの位置を変えない純粋な CSS 編集では、HMR のみを使用できます。
CLI とリファレンス
- パッケージスクリプトを優先してください。ラッパーのない下流のコマンドでは
open-pressを使用します。フレームワークリポジトリでは、バイナリがローカルでビルドされていないため、node packages/core/engine/cli.mjsを使用します。 - 上記に記載されていないコマンド、ソースの検索/置換、検査、または標準以外の詳細な検証については、
references/cli-commands.mdを読み込みます。 - レビューチェックが適用される場合、または Workbench の操作が必要な場合は、
references/local-review.mdを読み込みます。 - Press Tree/ランタイムの契約を変更するフレームワーク関連の作業に限り、
references/render-boundary.mdを読み込みます。通常のワークスペースでのコンテンツ作成では読み込みません。 - 新しい成果物は
openpress-create-pagesまたはopenpress-create-slideが担当します。作成コマンドをアップグレードツールとして使用しないでください。