mcpField
C
chalk-logic

chalk-logic

github.com/calicastleクリエイティブ・メディア9673 回インストール14 週間前に更新
リポジトリ

chalk-logic について

Chalk Logicは、アイデアを抑制の効いた、通常は文字を含まないチョーク画に変換するスキルです。画像生成や検査が使えない場合はプロンプトのみを出力し、二つの表示サイズで確認して最大二回修正します。

主な機能

  1. 01単一の命題に基づく構図設計
  2. 02緑の黒板と白いチョークの視覚ルール
  3. 03六つの構図タイプと形式の指針
  4. 04画像プロンプトと詳細なレシピの作成
  5. 05二つのサイズでの検査と最大二回の修正

活用シーン

  1. 01一つのプロセスや関係の図解
  2. 02簡潔な循環図や分岐図の作成
  3. 03画像ツールが使えない場合のプロンプト作成
  4. 04視覚ルールに沿ったイラストの確認

インストール

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

$npx skills add https://github.com/calicastle/skills --skill chalk-logic

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

同梱ファイル

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

LICENSE
agents/
openai.yaml
references/
example-index.md
repair-playbook.md

詳細

Chalk Logic

1 つのアイデアを、均一な緑の黒板に描かれた、静かで白いチョークの命題へと変換します。画像の生成と確認が可能な場合は、デフォルトで画像を生成してください。それ以外の場合は、コンパイル済みのプロンプトと手順を返してください。

視覚的な要件

各箇条書きは、生成ルールであると同時に品質確認の基準として扱ってください。

  • 1 つの命題: 1 つのプロセス、関係、構造、循環、蓄積、減衰、または観察に関する前提を伝えます。ひと目でわかる読み進め方を 1 つ設けます。
  • 静かな画面: 黒板の約 65%~75% を空白に保ちます。単一の簡素な連続体や観察を描く場合は、空白を 76%~86% に増やします。ゆとりのある外周の余白を確保し、概念を担うモチーフはコンパクトにまとめます。
  • 均一な黒板: キャンバスの端から端まで、平坦で乾いた、彩度を抑えた教室の黒板の緑で満たします。サムネイルサイズでも目立たない、ごく微細なマットな粒子感を加えます。画面に含めるのは、黒板と概念を担うチョークのモチーフのみです。
  • 鉱物チョークの描線: 温かみのある白い鉱物チョークだけで描きます。コントラストは、薄い下描きや背景情報、読み取りやすい構造、そしてごく少数の明るい接点という、抑制された 3 段階にします。筆圧の変化、やや途切れた線の縁、ときおり重なる描線、小さな粉の付着を表現します。
  • 一貫した描線: 意味を持つ経路は、連続した動きとして描きます。素材感による途切れは、線の縁や端に限ります。交差は、明確な因果関係や構造的な意味がある場合にのみ使います。
  • 正確さと手描き感: 構図は意図的に整え、描線には人の手の温かみを残します。認識可能な形は、観察したシルエットと機能的な構造に基づいて描き、抽象的な形は具体的な空間的挙動に基づいて描きます。
  • 文字なしをデフォルトに: テキスト、文字、数字、数式、文字らしき記号、署名、ロゴ、透かしは一切描きません。ユーザーが明示的にテキストを求めた場合に限り、指定された文言そのままを、短いフレーズ 1 つ、または合計 6 語までの短いラベル 3 つ以内で使います。
  • 独自のトポロジー: ステップ 3 で定めるアンカーデルタを満たし、概念独自の仕組みに基づいて構図を組み立てます。
  • 2 段階の明瞭さ: サムネイルサイズで命題を読み取れるようにし、フルサイズで確認すると控えめな素材のディテールを楽しめるようにします。
  • 意図ある抑制: すべての描線を命題に役立てます。意図した読み取りを保てる範囲で、構造的な形は最小限にします。

フォーマット

  • デフォルトの横長イラストには 16:9 を使います。
  • 開いた循環やコンパクトな蓄積には 1:1 を使います。
  • 分岐を描く研究図、分解図、ポスターには 4:5 を使います。
  • 長い変化を超横長の画面にすると効果的な場合に限り、約 2.2:1 を使います。
  • ユーザーが指定した寸法を厳守し、その寸法に合わせて構図を作成します。

構図の種類

主要な種類を必ず 1 つだけ選びます。

種類適した内容基本的な表現
方向性のある進行変化、減衰、蓄積左から右、または斜めに進む単一の連続体。間隔、密度、スケール、反復、筆圧で変化を表現します
開いた循環再帰、段階、睡眠、再生大きな中央の空白を囲む、数や大きさが均等でない 3~5 個の段階を、不完全なループまたは戻る動き 1 つでつなぎます
起点から枝分かれ仕組み、分散、選択肢まとまった起点 1 つから、交差しない非対称な軌跡を 3~5 本伸ばし、見分けのつく形で差をつけます
軸に沿った観察構造、解剖、組み立て認識可能な物体を、共通の軸に沿って少数の正確なパーツ数に分け、位置合わせの線は控えめに添えます
環境内の流れ吸収、移動、成長抑制された境界または領域 1 つと、密度や筆圧で示す連続した因果経路 1 つを描きます
静かな情景内省、注意、欠如、間広大な画面に、中心から外れたコンパクトな物体の集まりを 1 つ配置します。図解の補助要素は使わず、配置と余白で印象を伝えます

手順

1. 概要を確定する

コンセプト、意図する説明、感情的な温度感、出力形式、テキストの方針、実行モードを特定します。出力形式は、指定がある場合は正確なピクセル寸法で、ない場合は比率で表します。画像生成と画像の確認の両方が可能な場合に限り、実行モードを rendered に設定します。

ユーザーが現在の会話で画像を禁止している場合は、rendered を選択する前に、独立した新しいワーカーを1つ用意します。アンカーの閲覧、生成、候補の閲覧、修正、画像の品質確認はすべてそのワーカーを介して行います。ワーカーには、テキストによる所見とローカルファイルのパスのみを返すよう求めます。要求された場合、または必要な機能や独立したワーカーが利用できない場合は、prompt-only を使用します。

完了条件:概要の6つの値と実行コンテキストがすべて明示されていること。画像を会話に含めない rendered の実行では、独立したワーカーが用意されていること。利用できない機能がある場合は、納品時にその旨が記録されていること。

2. 読み取りの流れを整理する

構図の系統を1つ選び、見る人が最初に何に出会い、何が変化または関連し、最後にどこへ注意が向かうかを示す、内部向けの視覚的な文を1つ記述します。意味を担わせる意味の担い手として、間隔、密度、スケール、反復、圧力、オブジェクトの配置などから1つ選びます。

完了条件:その文が、まとまりのある命題1つ、順序のある読み取りの流れ1つ、主要な系統1つ、名前を付けた意味の担い手1つを含み、無関係な筋書きを含まないこと。

3. 品質の基準を定める

references/example-index.md を最後まで読みます。アンカーの選択ルールに従って、項目を1つまたは2つ選びます。新しい構図に共通するアンカーとの差分を1つ記録します。

  • 選んだ各アンカーについて、保持する識別特性を3つ、観察可能な対象側の根拠とともに記録します。
  • 新しい構図のトポロジーを1つ定めます。
  • 主題、形式、視点、方向、数、焦点の位置、意味の担い手から、独立した対象軸を正確に2つ選びます。
  • 選んだ各アンカーについて、そのアンカーの元の値を、同じ対象トポロジーと2つの対象軸の値に対応付けます。各対象は、そのアンカーの元の値とは観察可能な形で異なる必要があります。

rendered の実行では、選んだローカルのサンプルだけを視覚的に確認します。prompt-only の実行では、テキストのインデックスで十分です。サンプルは品質の根拠として扱い、画像生成の入力にはしません。ユーザーが画像を会話に含めないよう求めた場合は、ステップ1で用意した独立したコンテキスト内で確認し、ファイルリンクのみを返します。

完了条件:アンカーが1つまたは2つ選ばれていること。各アンカーについて、保持する観察可能な特性が3つ記録され、共通のトポロジーと2つの独立した対象軸への対応付けが記録されていること。3つの対象値がすべての対応付けで同一であり、対応するすべての元の値と観察可能な形で異なること。さらに、rendered の実行では、選んだすべてのアンカーを視覚的に確認していること。

4. レシピを明示する

各軸について、次から値を正確に1つ選びます。

  • 形式
  • 系統
  • 命題
  • 読み取りの流れ
  • 意味の担い手
  • トポロジー
  • モチーフの配置
  • 認識の手がかり、または抽象的なマークの語彙
  • 数または状態:意味のある場合は正確な値、そうでない場合は not fixed
  • アンカーとの差分の対象:ステップ3で選んだ2つの対象値。アンカー名や由来は含めません。
  • 余白の対象
  • チョークのコントラスト階層
  • ムード
  • テキスト:wordless、または指定された文言そのものと、そのスケールおよび配置

完了条件:14の軸すべてに1つずつ選択肢があり、いずれも同じ命題を支えていること。

5. 画像プロンプトを作成する

ピクセルに反映すべき情報だけを含む、簡潔な4段落を記述します。

  1. キャンバス、比率、均一な緑色のボード、余白の目標を明記します。
  2. 命題、ファミリー、意味を担う要素、トポロジー、意味のある場合は正確な個数、読み進める順序、認識の手がかり、配置、および両方のアンカー変更の目標値を明記します。
  3. 温かみのある白色のチョークの表現、3段階のコントラスト、一貫した線の表現、ムードを明記します。
  4. テキストの方針と、誤読を防ぐために必要な対象固有の除外事項だけを明記します。

内部タイトル、手順、ファイル名、出典情報、アンカー分析、QA メモは画像プロンプトに含めず、外部に記載します。

完了条件:レシピのすべての軸が、プロンプト内でピクセル上の目標特性として表現されていること。固定の個数や状態がある場合は明記されていること。要求されたテキストがある場合は、正確な文言、サイズ、配置が含まれていること。プロンプトが1つの視覚的な命題を表していること。ボード、チョーク、線、ムード、テキストの各ゲートが明示されていること。

prompt-only の場合はステップ6と7を省略し、ステータスを PROMPT_ONLY としてステップ8に進みます。

6. 候補を1つ生成する

ステップ1で選択した実行環境と組み込みの画像生成機能を使用します。画像を扱わない会話では、隔離されたワーカーが画像を含むすべての操作を実行します。機能が対応している場合は、要求されたピクセル寸法で正確に生成します。対応していない場合は、同じネイティブ比率で生成し、比率が完全に一致する場合に限ってリサンプリングします。どちらの方法でも要求された寸法を満たせない場合は prompt-only に切り替え、機能に関するメモを記録します。ユーザーが参考画像を提供した場合は、要求された方向性の手がかりにのみ使用し、独自のトポロジーを維持します。

完了条件:正確な寸法が要求された場合、ファイルのメタデータが要求されたピクセル寸法の両方と完全に一致すること。比率が要求された場合、ファイルのメタデータが要求された比率と一致すること。

7. 点検して修正する

ステップ1で選択した実行環境で、候補を原寸とサムネイルの両方で点検します。視覚的な契約の箇条書き、14個すべてのレシピ軸、記録された各アンカー差分を確認します。レシピに not fixed と記載されている場合に限り、Exact counts を N/A と記録します。該当しないその他のゲートも N/A と記録します。

複数のゲートに不合格がある場合は、次の優先順位で最初の不合格を選択します。

  1. 要求された形式
  2. テキストの方針
  3. 命題
  4. ファミリー
  5. 読み進める順序
  6. 因果関係の順序
  7. 意味を担う要素
  8. 正確な個数
  9. 認識の手がかり
  10. トポロジーとアンカー変更の目標
  11. 維持されたアンカー特性
  12. 余白の目標
  13. モチーフの配置
  14. サムネイルでの明瞭さ
  15. 原寸での素材の細部
  16. 一貫したストローク
  17. 均一なボード
  18. ミネラル感のある手描き表現
  19. チョークのコントラスト階層
  20. ムード
  21. 作為の抑制

選択したゲートを references/repair-playbook.md に渡し、その修正方法を修正パス1に適用します。21個すべてのゲートを再点検します。パス2では、同じ優先順位で残っている不合格のうち最初のものを選択し、対応する修正方法を適用します。Topology and anchor-change targets が選択されたゲートである場合に限り、トポロジーを置き換えます。21個すべてのゲートを再点検し、パス2の後で停止します。

2つ目の新しい隔離サブエージェントを利用できる場合は、最終的な視覚QAに使用します。候補とゲートのみを渡し、テキストのみで所見を返すよう依頼します。以前の判断はそのコンテキストに含めません。画像を扱わない実行では、隔離されたワーカーがこのディスパッチを担当し、判定のみを返します。

完了条件:すべてのゲートを漏れなく点検していること。すべて合格した場合は DONE に設定します。修正上限に達した場合は DONE_WITH_CONCERNS に設定し、残っている不合格のゲートをすべて列挙します。

8. 納品

レンダリングを行った場合は、ユーザーの表示設定に応じて、承認済みの画像または通常のファイルリンクを提示し、その後に正確なプロンプトの順序、完全なレシピ、ステータスを示します。プロンプトの順序には、初回生成プロンプトと、すべての修正指示を順番どおりに含めます。プロジェクトに関連する画像は、納品前にユーザーのワークスペースに保存します。バンドルされた参照画像を生成物として提示してはいけません。プロンプトのみの実行では、画像を付けずに、コンパイル済みプロンプト、完全なレシピ、PROMPT_ONLY ステータスを納品します。プロンプトのみでの実行がユーザーのリクエストではなく、機能上のフォールバックである場合は、簡潔な機能に関する注記を一つ追加します。

完了条件:レンダリングを行った実行には、確認済みの候補、正確なプロンプトの順序、14項目すべてのレシピ軸、DONE または DONE_WITH_CONCERNS が含まれます。DONE_WITH_CONCERNS には、残っている失敗ゲートもすべて含めます。プロンプトのみの実行には、コンパイル済みプロンプト、14項目すべてのレシピ軸、PROMPT_ONLY、および必要な機能に関する注記が含まれます。

出力形式

PROMPT_ONLY の場合は、Image 行を省略します。使用しない修正行と条件付きフィールドはすべて省略します。

**Image**

[Chalk Logic illustration](absolute-image-path)

**Exact prompt sequence**

```text
Initial: [exact generation prompt]

Repair 1: [exact instruction, when used]

Repair 2: [exact instruction, when used]
```

**Recipe**

- Format: [ratio or dimensions]
- Family: [family]
- Proposition: [visual sentence]
- Reading path: [choice]
- Semantic carrier: [spacing/density/scale/repetition/pressure/object arrangement]
- Topology: [spatial structure]
- Motif placement: [choice]
- Recognition cues or marks: [choice]
- Counts or states: [exact values/not fixed]
- Anchor-change targets: [target value 1; target value 2]
- Quiet space: [percentage]
- Chalk hierarchy: [three levels]
- Mood: [emotional temperature]
- Text: [wordless or exact wording, scale, and placement]
- Status: [DONE/DONE_WITH_CONCERNS/PROMPT_ONLY]

[Concerns: required only for DONE_WITH_CONCERNS]

[Capability note: only when PROMPT_ONLY is a fallback]

コメント