Penpot デザイン は何をしますか?
Penpot MCP のみを使用します。並行した HTML/CSS は、依頼がない限り使用しません。high_level_overview を一度読み、書き込みの前にフォーカスされたページ (shapeStructure、コンポーネント/トークン) を検査します。
最初に確認すること
- モード:
mockupまたはdesign? - 指示: 何を構築/変更するか。複数のバリアント案は 依頼があった場合のみ 提示します。
- プラットフォーム: プロジェクトルールが設定されていればそれに従い、それ以外は確認します。iOS/Android/Web を推測してはいけません。
いずれかが不足している場合は停止します。
モード
Mockup — 低忠実度の検証: 構造、階層、フロー。シンプルな塗り、実際のスペーシング。依頼がない限り磨き上げは行いません。
Design — 高忠実度: トークン、タイポグラフィ、状態、クローム。同じコンポーネント/フレックスのルールに従います。再構築よりも、グループ化 → コンポーネント化 → 洗練を優先します。
ルール
コンポーネント: 2 回以上表示される → コンポーネント/インスタンス。同じ基礎で異なる状態 → バリアント (Active、State、Size、…)。構造は メイン に、上書きはコピーに。フォークする場合のみ detach() を使用。命名: Toolbar/Button。レイヤー: background、icon、label (バリアント間で安定)。深さ ≤ 4。メインの中にメインを入れない。
レイアウト: フレックス/グリッド。子要素が存在する場合は penpotUtils.addFlexLayout を使用。スペーシング: 8dp スケール (4 は半ステップ)。コントロール: material-alignment.md を参照。アクティブ = バリアント/スタイル、レイアウトのシフトではない。Z オーダー: 背景 → コンテンツ → オーバーレイ。
ビルドツリー: 外部優先のみ — コンテナ (空 + フレックス) → その直下の子シェル (Z オーダー) → 各子の要素に再帰。既存のリーフをラップしない。詳細: build-order.md。
処理プロセス: ライブラリ: トークン → アトム → バリアント。次にビルドツリーで画面を組み立てる。既存の作業: グループ化 → createComponent → 重複をインスタンスで置き換える。export_shape で確認。大規模な書き換えの前に計画を立てる。
API: penpot-api.md。詳細: リポジトリ research/penpot-design-practices.md。
拡張性
フィードバックが 汎用的な Penpot ルールになる可能性がある場合 (プロジェクト固有ではない)、次のように質問します: "これを penpot-design に追加しますか?タスク完了後に行います。"
- はい: タスク中に言い回しをメモし、タスク終了後に
personal-skills/skills/penpot-design/を編集し、再インストール:
その後、変更内容を確認します。npx skills add cucoreanu/personal-skills --skill penpot-design - いいえ: セッション内のみ。ユーザーが今すぐ依頼しない限り、タスクの途中でスキルを編集してはいけません。
完了条件
- モード、指示、プラットフォーム (必要な場合) が確認済み
- 重複はコンポーネント、状態はバリアント
- フレックス/グリッド + Material に着想を得たコントロール配置
- キャンバスが外部優先で構築されている (コンテナ → 子シェル → ネスト要素)
- モックアップは低忠実度 / デザインは高忠実度。エクスポートが確認済み