mcpField
C
ccf-visual-composer

ccf-visual-composer

github.com/mikubaka88デザイン・UI3.3k1.9k 回インストール1 週間前に更新
リポジトリ

ccf-visual-composer について

ccf-visual-composerは、研究図、模式図、プロットなどの作成・編集を支援するスキルです。研究者やプロジェクトチーム向けに、根拠の保持、内容に応じた制作手順、科学的正確さと視覚品質の確認を扱います。

主な機能

  1. 01根拠を保つビジュアル設計
  2. 02科学プロットのガイダンス
  3. 03図と模式図のワークフロー
  4. 04編集可能な出力のガイダンス
  5. 05視覚・科学面の品質確認

活用シーン

  1. 01研究手法の模式図を作成
  2. 02既存のプロットや図を編集
  3. 03編集可能なビジュアルを再構成
  4. 04納品前に図を確認

インストール

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

$npx skills add https://github.com/mikubaka88/ccfa-skills --skill ccf-visual-composer

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

同梱ファイル

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

agents/
openai.yaml
references/
paper-vs-presentation-diagrams.md
plot-inspiration-map.md
icon-system.md
architecture-diagram-generation.md
editable-pptx.md
adaptive-architecture-style.md
palette-and-accessibility.md
figure-table-layout.md
reference-layout-blueprint.md
python-plot-recipes.md
render-qa.md
visual-contract.md
resources/python/
ccfa_plot_recipes.py
scripts/
test_plot_recipes.py

詳細

CCF Visual Composer

ファイルファミリーの契約

ファイル作業の前に、正規のパスと、タスク/成果物ごとの作業ディレクトリを再利用します。既定では、プロジェクトルートの ccfa-workfiles/<purpose>/<artifact-id>/ を使用します。入力を保持したまま同じ場所で更新し、UTF-8 を使用して中国語テキストが含まれていないことを確認します。命名、所有権、タスクで作成したファイルのクリーンアップには、artifact-contracts.md を適用します。引き継ぎ時も、これらのパスを引き継ぎます。

コラボレーションの契約

専門家が作業を開始する前に、まず ccf-humanization、次に ccf-common を読み、適用します。引き継ぎのたびに、適用可能な有効なルールを再利用するか、不足または変更されたルールを再確認します。文章がなくても、両方の事前確認が必要です。詳細な編集、実験、保守のモードは、関連する場合にのみ実行します。

必要な専門家の貢献を、単一の担当者のもとに統合します。有効な前提条件を再利用し、影響を受ける成果を検証します。重複した報告を避け、協力ルートに従います。

呼び出し時の制御

CCFA Handoff Mode: PARTIAL(推奨)。metadata.ccf_skill_controls.handoff_question_mode、../ccf-common/references/handoff-modes.md、../ccf-common/references/task-modes.md に従います。すでにコンテキストにある共通ルールを再利用します。

新しい科学的手法またはアーキテクチャの概念では、ユーザーが純粋な SVG/コード優先の出力を要求するか、使用しないことを選択しない限り、GPT Image 2 を既定の初回レンダラーとします。検証済みのホスト機能と、そのプライバシー/画像に関する指示を使用します。バックエンドが不明な場合は、GPT Image 2 と表示しないでください。必要な生成と、依頼された再構成は既存の許可で対応できます。依頼の範囲外となる追加形式は、必要に応じて提案します。

基本ルール

提供されたコンテンツから、読みやすいビジュアルを作成します。値、単位、不確実性、正確なラベル、手法の各モジュール、型付き接続を保持します。定量プロットには再現可能なコードを使用します。データやトポロジーが不足している場合は、該当するエビデンスの担当者に確認します。構成を完成させるために、情報を捏造してはいけません。科学用語と正式な大文字表記の頭字語を保持し、通常のラベルには自然な大文字・小文字を使用します。

掲載先を、論文のメカニズム図、プレゼンテーション/ポスター、または README/アウトリーチに分類します。論文の図では、表現と計算を示します。固定のステージカードテンプレートではなく、手法に適したビジュアル文法を選びます。

新しい構成には references/visual-contract.md を使用します。コンテンツに適したコンパクトなキャンバス、共通の位置合わせ基準、適切な間隔を設定し、最終サイズで文字組みを確認します。正方形を既定にしたり、固定のアスペクト比を強制したりしないでください。既定の書体は Times New Roman です。ユーザーまたは掲載先の書体指定に従いつつ、依頼されたコミック調には Comic Sans MS を使用します。新しいビジュアルの方向性には、references/adaptive-architecture-style.md から機能的なプリセットを1つ選びます。提供された参考資料を確認し、説明上の重要度に応じてスペースを配分し、必要なラベルと数値だけを残します。

モードと参照先の選択

以下の関連セクションのみを読みます。ローカル編集では既存のソースと該当する QA を使用し、生成ワークフロー全体を再読み込みする必要はありません。

モード用途と参照先
visual-contract内容・エビデンス・出力に関する重要な判断:references/visual-contract.md。
figure-design、python-plotting生物学的データを含む、分野横断的な数値プロット:references/python-plot-recipes.md に、共通スケール、エンティティの色、物理的な文字サイズ、検証済み入力の実行可能な例があります。必要なレシピを resources/python/ccfa_plot_recipes.py からインポートします。実装は、デバッグまたは調整が必要な場合にのみ読みます。チャートの選択に迷う場合は、references/plot-inspiration-map.md を参照できます。
architecture-generation新しいコンセプト:references/architecture-diagram-generation.md。論文固有の文法は、references/paper-vs-presentation-diagrams.md のみを参照します。
pure-svg-generation決定的な手法を明示的に指定する場合:サポート対象のトポロジーとベクター作成用ソースを直接使用します。
editable-reconstructionreferences/architecture-diagram-generation.md のセマンティック再構築のセクション。PPTX の場合にのみ references/editable-pptx.md を読み込みます。
reference-layout-blueprint提供された参考構成:references/reference-layout-blueprint.md。プロンプトの調整が必要な場合は、references/adaptive-architecture-style.md を使用します。
icon-systemネイティブプリミティブ、再利用可能なライセンス付きアイコン、または必要なカスタムアセット:references/icon-system.md。
table-design、layout-integration提供された値、パネル・フロート・キャプションの配置:references/figure-table-layout.md。
render-qareferences/render-qa.md の該当するチェック項目を使用して、指定された形式を確認します。

色の意味づけを選択または変更する場合にのみ、references/palette-and-accessibility.md を使用します。既存のパレットとアイコンファミリーが適切であれば、それらを再利用します。

ワークフロー

  1. 要求された成果物、既存のソース、最終サイズ、保存先、形式、科学的な要点を確認します。ファイル作業では、../ccf-common/references/artifact-contracts.mdを一度読み、レンダリング前に正規の出力パスと作業パスを確定します。関係のない図は、それぞれ安定した作業ディレクトリに分けて保存し、既存のプロジェクトパスを尊重します。
  2. 依存するコンテンツをレンダリングする前に、科学的な前提条件を確定します。具体的には、ソース値、単位、指標の意味、トポロジー、意図するメッセージです。関連するパネルでは、エンティティ ID/順序、共通のエンコーディング、比較可能なスケール、必要な画像のアスペクト比も確定します。不正な入力はプロット前に拒否し、もっともらしい結果になるようにクランプしてはいけません。結果の意味が未解決の場合はccf-experiment-designer、トポロジーについては手法の担当者、ソース間に矛盾がある場合はccf-integrity-auditorを使用します。有効な根拠は再利用し、不足している部分だけを補います。トポロジー、ラベル、データの場所、レイアウト、スタイル、来歴については仕様を一つにまとめ、契約書、プロンプト、ワイヤーフレーム、QA ファイルを重複して作成しないでください。
  3. タスクを完了できる最小限のレンダリング手順を選択します。新しいアーキテクチャのコンセプトには、デフォルトの画像ワークフローを使用します。既存の SVG、PPTX、プロットスクリプトについては、そのオーサリングソースを直接編集し、要求された影響範囲の形式を書き出します。ラベル、色、間隔、データ、エクスポートの変更に、新たなラスターコンセプトの工程を実行してはいけません。ラスター画像の編集では、ホスト側の画像編集ワークフローに従い、既存画像を参照として使用します。
  4. 詳細なユーザープロンプトを保持し、不足している制約は一度だけ追加します。全面的な再設計では、具体化に必要な参照画像の役割、レイアウトの幾何学的構成、テキスト一覧、タイポグラフィ、配色を含めます。これらを恣意的な語数制限で短縮してはいけません。承認済みのトポロジー、レイアウトトークン、アセットを再利用します。まず、完全な候補を一つ作成します。要求された代替案、またはCommonの該当するfigure_variantsの設定により、承認済みのコンテンツを使った、構成が明確に異なる案を追加できます。autoはデザイン上の選択が未解決の場合に使用し、onは新しいデザインの比較に適用します。局所的な編集には適用しません。採用する各候補は、既存の成果物作業ディレクトリに保存し、正規の成果物として選択したものを明示します。アセットの検索または生成は、具体的な不足を解消する場合に限って行います。
  5. レイアウトと科学的な仕様に照らしてドラフトを確認します。要求された再構成では、ベクター/ネイティブのテキストと幾何学的構成を調整します。ラスター形式で納品する場合は、テキスト、間隔、イラストの不備を対象を絞って画像編集し、問題のない領域は維持します。同じ不備の修正を2回試みても解消しない場合は、原因を診断し、関連する方針を変更します。実現可能な修正が残っているのに、試行回数だけを理由に作業を止めてはいけません。
  6. 要求された編集可能な出力は、意味のあるグループ、編集可能なテキスト、図形、型付きコネクターとして作成します。ラスター画像全体を埋め込んで編集可能だと称してはいけません。避けられないラスターアセットは分けて保存し、実際の編集可能性を説明します。派生する PDF/PPTX は、非可逆な変換を繰り返さず、正規のオーサリングソースから生成します。必要な再利用可能なソースとアセットのみを保持します。
  7. 統合された確認を一度行い、科学的な忠実性(データ、スケール、ID、トポロジー、ラベル)と視覚的な品質(配置、コンパクトさ、最終サイズでの文字、コントラスト、クリッピング、編集可能性)について、別々に判断します。局所的な編集では、影響を受ける依存関係と保護対象の領域を確認します。問題のない確認結果は再利用します。作業用ビルドディレクトリに、現在のプレビューを一つ保存します。Commonの有効なindependent_review設定、または明示的な要求に応じて、追加の独立評価を行います。通常のQAでは、別のエージェントや生成処理を追加する必要はありません。
  8. 要求された成果物を仕上げ、ファイルの配置、最新のエクスポート、一時ファイルの削除を確認します。新たなデータ/プロトコルに関する判断はccf-experiment-designer、論文の文章はccf-paper-writer、主張との不一致はccf-integrity-auditorに委ねます。影響を受けない、許可済みの作業は進めてください。

出力仕様

依頼されたビジュアルと、必要な編集可能なソース/形式を最初に納品してください。仕様のみの依頼では、レンダリングは不要です。正規パス、有用な来歴情報、実際の QA 結果、編集可能性に関する重要な制限を返してください。完全なプロンプト、仕様、インベントリは、必要な場合または求められた場合にのみ、再利用可能な 1 つのソース記録にまとめてください。最終回答で重ねて記載しないでください。明示された完全一致の出力要求は維持してください。

コメント