mcpField
P
pencil-design-bridge

pencil-design-bridge

github.com/sergekostenchukデザイン・UI3250 回インストール18 週間前に更新
リポジトリ

pencil-design-bridge について

Pencil Design Bridge は、承認済みのブリーフと Pencil ワークスペースをつなぎ、デザインとプロダクトの引き継ぎを支援するスキルです。キャンバス指示の作成、出力レビュー、Figma やコード向けの準備を行い、.pen ファイルは Pencil MCP/ツール経由で扱います。

主な機能

  1. 01承認済み方針をデザインブリーフに整理
  2. 02Pencil のキャンバス引き継ぎ指示を作成
  3. 03UX と実装制約に照らして出力をレビュー
  4. 04Figma またはコード向けの引き継ぎを準備
  5. 05Pencil ツールの利用可否を確認

活用シーン

  1. 01承認済み方針を Pencil ブリーフに変換
  2. 02Pencil MCP またはエージェント向け指示の準備
  3. 03アクセシビリティと実装制約に基づくデザイン確認
  4. 04Pencil の成果物を Figma またはコードへ引き継ぎ

MCP 対応

Pencil MCP/ツール経由で .pen ドキュメントにアクセスし、Pencil MCP または Pencil 対応エージェント向けの指示を準備できます。設定確認モードでは、実行環境で Pencil ツールが利用可能かを調べます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill pencil-design-bridge

インストール後、Claude Code で/pencil-design-bridgeを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
assets/
pencil-handoff.template.md
evals/
evals.json
references/
pencil-bridge-contract.md

詳細

Pencil デザインブリッジ

このスキルは、UI/UX エージェントスキルシステムにおける Pencil 層です。Pencil はデザインツールとのブリッジであり、編集可能なデザインワークスペースです。中心的なアーキテクトでも、単なるファイルパーサーでもありません。

動作モード

  • brief:承認済みの方針ブリーフを、Pencil ですぐに使えるデザインブリーフに変換します。
  • canvas-handoff:Pencil MCP/ツール、または Pencil 対応エージェント向けの指示を準備します。
  • review-output:UX、SEO/LLM、アクセシビリティ、ブランド、実装上の制約に照らして、Pencil の出力をレビューします。
  • figma-code-handoff:Figma またはコード実装向けに、Pencil の成果物を準備します。
  • config-check:.pen ファイルを直接読み込まずに、現在のランタイムで Pencil ツールが利用可能か確認します。

必須ワークフロー

  1. references/pencil-bridge-contract.md を読みます。
  2. ソースブリーフが senior-ui-ux-orchestrator によって承認済みであるか、明示的なユーザーの決定に基づいていることを確認します。
  3. 次の入力を確認します。
    • プロダクト/UX のジャーニー
    • 公開ページに関する SEO/LLM の制約
    • ui-ux-pro-max のデザインインテリジェンス
    • 任意の Stitch の出力または Figma の制約
    • 必要なアセットと禁止されている主張
  4. 引き継ぎパケットには assets/pencil-handoff.template.md を使用します。
  5. .pen ドキュメントには Pencil MCP/ツール経由でのみアクセスします。.pen ファイルに対して、シェルでの読み込み、grep、cat、または場当たり的な JSON 解析を使用しないでください。
  6. Pencil の出力はデザイン成果物の候補として扱います。Figma、コード、または本番環境で使用する前に、必ずレビューする必要があります。

安全ルール

  • API キー、トークン、Cookie、非公開 URL、非公開のスクリーンショット、.env の値を Pencil の引き継ぎ資料に保存しないでください。
  • 呼び出し可能な Pencil ツールが使用され、アーティファクトのパスまたはツールの応答が存在しない限り、Pencil ツールを実行したと主張しないでください。
  • Pencil ツールを利用できない場合は、手動で引き継ぎ資料を作成し、実行状況を Skipped または Planned と記載してください。
  • Pencil の出力がアクセシビリティ、表示されている事実、SEO/LLM の構成、または実装可能性と矛盾する場合は、評議会に回してください。

引き継ぎの形式

Mode:
Approved direction:
Pencil tool availability:
Input artifacts:
Data excluded:
Prompt or canvas instructions:
Design-system constraints:
Review criteria:
Next owner:
Checks:

検証

このスキルを編集した場合は、次を実行します。

python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/pencil-design-bridge
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/pencil-design-bridge
python3 -m json.tool $CODEX_HOME/skills/pencil-design-bridge/evals/evals.json >/dev/null

コメント