1仕組みと動作原理
中核は Type（情報構造）× Style（視覚的美学）の2次元の直交モデルであり、挿絵プランを柔軟に組み合わせ可能です。
skills/canghe-article-illustrator/SKILL.md
| **Type** | Information structure | infographic, scene, flowchart, comparison, framework, timeline |
ここでの処理：「どんな画像を付けるか」を2つの独立した次元に分解します。Type が情報構造（データ/infographic、物語/scene、フロー/flowchart…）を決定し、Style が視覚的な印象（notion/warm/blueprint…）を決定し、両者を任意に掛け合わせられます。
プロセスは6ステップのチェックリストに固定されており、「設定の読み込み」と「生成前のプロンプトファイルのディスク保存」が厳格なブロッキングゲートとなっています。
skills/canghe-article-illustrator/SKILL.md
- [ ] Step 1: Pre-check (EXTEND.md, references, config)
ここでの処理：6ステップ（Pre-check→Analyze→Confirm→Outline→Generate→Finalize）がワークフローの骨格であり、Step 1.5 と Step 5 の2箇所に ⛔ BLOCKING が指定されています。
設定は EXTEND.md に依存し、プロジェクト単位→ユーザー単位の優先度で検索され、未設定の場合は初期セットアップの実行が必須です。
skills/canghe-article-illustrator/SKILL.md
test -f .canghe-skills/canghe-article-illustrator/EXTEND.md && echo "project"
ここでの処理：`test -f` で2階層のパスの存在を確認し、検出された場合は解析して要約を表示し、見つからない場合は first-time-setup の実行を強制します。
コンテンツ分析フェーズでは比喩を「根本概念の可視化」へ変換することを求め、文字通りの描写を明確に禁止しています。
skills/canghe-article-illustrator/SKILL.md
**CRITICAL**: Metaphors → visualize underlying concept, NOT literal image.
ここでの処理：Step 2 の4つの分析（コンテンツ種別/目的/コア主張/挿絵位置）の後、比喩の描写方法を制限する CRITICAL な制約ルールを適用します。
確認フェーズは1回の AskUserQuestion（最大4問）に集約され、Type、Density、Style の3問は回答必須です。
skills/canghe-article-illustrator/SKILL.md
**ONE AskUserQuestion, max 4 Qs. Q1-Q3 REQUIRED.**
ここでの処理：複数ターンのやり取りを避けるため選択式の質問を一度に行います。Q4（言語）は記事の言語と EXTEND.md の設定が一致しない場合にのみ表示されます。
生成前に構造化されたプロンプトファイルをディスクに保存する必要があり、LABELS には記事の実際のデータを含める必要があります。
skills/canghe-article-illustrator/SKILL.md
⛔ **BLOCKING: Prompt files MUST be saved before ANY image generation.**
ここでの処理：Step 5 では各挿絵についてテンプレート（ZONES/LABELS/COLORS/STYLE/ASPECT）に沿って prompts/NN-{type}-{slug}.md を書き出すことを要求し、未保存のまま直接 `--prompt` に渡すことを禁止しています。
出力ディレクトリと命名規則は固定：Slug は2〜4語の kebab-case で、競合時はタイムスタンプを追加します。
skills/canghe-article-illustrator/SKILL.md
**Slug**: 2-4 words, kebab-case. **Conflict**: append `-YYYYMMDD-HHMMSS`.
ここでの処理：成果物は illustrations/{topic-slug}/ に保存され、source、outline.md、prompts/、および NN-{type}-{slug}.png が含まれます。
20以上のスタイル定義ファイルが背景、hexカラーパレット、視覚要素、Do/Don't、Best For を提示し、styles.md に集約されます。
skills/canghe-article-illustrator/references/styles/editorial.md
Magazine-style editorial infographic for professional content
ここでの処理：各スタイルはオンデマンドで読み込まれる独立したリファレンスです。editorial は「雑誌風のプロフェッショナルなインフォグラフィック」と定義され、9つの役割に対応する hex パレットを提供します。
2コア機能
012次元選定（Type × Style）による挿絵方向性の柔軟な組み合わせ
026種類のイラストタイプ（infographic/scene/flowchart/comparison/framework/timeline）
03カラーパレットとルールを備えた20以上のビジュアルスタイルライブラリ（notion/warm/minimal/blueprint/watercolor…）
04挿絵の点数を決定する密度制御（minimal/balanced/per-section/rich）
05構造化プロンプトテンプレート（ZONES/LABELS/COLORS/STYLE/ASPECT）＋事前のディスク保存の必須化
06outline.md アウトライン成果物（位置/用途/描画内容/ファイル名）
07修正ワークフロー（Edit/Add/Delete の3アクション、プロンプトおよびアウトラインの更新を含む）
08設定の永続化と出力ディレクトリの選択肢（same-dir/illustrations-subdir/independent）
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| api | 图像生成 skill（由 Step 5.6 在宿主可用 skill 中挑选；SKILL.md 未点名具体后端） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- 本地工作目录: ファイルの読み書きと成果物の出力: SKILL.md の指示に基づきエージェントがディスク書き込みを実行：illustrations/{topic-slug}/ 配下の source-{slug}、outline.md、prompts/*.md、*.png
- SKILL.md: ホストの CLI インタプリタまたは外部実行環境の呼び出しを宣言
監査ノート： (a) 本スキルの明示された用途は記事コンテンツからの挿絵生成です。Step 5.6 の「Select generation skill, process references」により、エージェントは構築されたプロンプト（記事の実データを含む）を利用可能な画像生成スキル/バックエンドに渡します。これに従うと、記事内容と参考画像がサードパーティの画像モデルへ外部送信され、アカウント枠を消費します。(b) ローカルへのディスク書き込みが明確です：illustrations/{topic-slug}/ 配下の source、outline.md、prompts/*.md、*.png、および EXTEND.md。(c) 当該ディレクトリ自体にはスクリプト、内蔵ネットワークエンドポイント、認証情報の読み取りが存在せず、外部送信と認証情報のリスクは呼び出される画像生成バックエンド側に委ねられているため、Red とは判定しません。本ドキュメントでは具体的なバックエンドは特定されていませんが（「Select generation skill」とのみ記載）、ワークフロー設計上、素材を外部生成サービスへ送ることが前提となっています。先行事例（baoyu-article-illustrator や ai-image-generation など、素材を生成バックエンドへ送るスキル）に倣い、一律で Orange と判定します。
5二重目の独立検証
- [ok] 自身目录无任何脚本或可执行文件 — 文件清单只有 .md；扫描“执行外部程序/写盘/网络请求”均为 0 命中，脚本执行面为空。
- [discrepancy] 外部生成后端名称 — SKILL.md 仅写 'Select generation skill'，未像仓库内其它 skill 那样点名具体后端；出网事实由 skill 的声明用途（生成插画）推出，档位仍为 orange。
- [ok] EXTEND.md 查找只探测存在性 — $HOME 命中仅是 test -f 的存在性判断，未读取文件内容之外的凭证或环境变量。
- [ok] Type × Style 取值集合一致 — SKILL.md Types 表 6 项、Styles 表 6 项示例与 references/styles.md 汇总一致，未发现夸大。
- [ok] prompt 先落盘纪律 — SKILL.md Step 5 明确 'Prompt files MUST be saved before ANY image generation'，并禁止未落盘直接 --prompt。
- [ok] meta 元数据 — commit dd0bf355…、path skills/canghe-article-illustrator、license MIT 与 bundle §0 核定值一致。
6結論
最適な用途： 長文記事、チュートリアル、技術文書の章ごとに一括で挿絵を配置し、スタイルの統一性と再現可能なプロンプトを必要とする執筆者やコンテンツチームに最適です。
不向きな用途： 完全オフラインまたはコンテンツの外部送信が禁止されている環境、単一のカバー画像のみを求める用途（canghe-cover-image を推奨）、確認プロセスを省いて素早くドラフトを作りたい用途には不向きです。
Install Agent-Ready
① Verified Mirror 2026-10-10
Option A · Direct DownloadDownload canghe-article-illustrator.tar.gz
sha256:
Option B · Copy Guide for Agent0fd4e11132236e3d…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit dd0bf35595.