aliyun-solution-article-illustrator について
Markdown記事を画像付きの原稿に仕上げる、記事制作者向けのスキルです。情報の種類と視覚スタイルを分けて設定し、画像生成と編集のバックエンドとしてAlibaba Cloudのスキルを既定で推奨します。
主な機能
- 01記事を分析して挿絵位置を計画
- 02種類、密度、視覚スタイルを設定
- 03プロンプトと初回画像を用意
- 04必要に応じて画像を修正
- 05画像を挿入して納品レポートを作成
活用シーン
- 01技術記事のインフォグラフィックやフローチャートを計画
- 02指定スタイルでMarkdown記事に挿絵を追加
- 03画像入り記事を検証して納品
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill aliyun-solution-article-illustratorインストール後、Claude Code で/aliyun-solution-article-illustratorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlprompts/system.mdreferences/backend-contract.mdoutput-spec.mdprompt-construction.mdsources.mdstyles.mdtest-plan.mdusage.mdworkflow.mdreferences/config/first-time-setup.mdpreferences-schema.mdreferences/styles/blueprint.mdeditorial.mdminimal.mdnotion.mdwarm.mdwatercolor.mdscripts/build_outline.pycollect_evidence.pyload_preferences.pyrun_workflow.pyvalidate_inputs.pytemplates/delivery-report.mdoutline.mdprompt.md詳細
Category: solution
記事イラストレーター
記事のイラスト制作ワークフローモデルを維持しながら、デフォルトの実行バックエンドとして Alibaba Cloud のスキルを推奨します。
2 つの軸
| 軸 | 制御対象 | 例 |
|---|---|---|
| タイプ | 情報構造 | インフォグラフィック、シーン、フローチャート、比較、フレームワーク、タイムライン |
| スタイル | 視覚的な美しさ | notion、温かみのあるスタイル、ミニマル、設計図、水彩、エディトリアル |
検証
mkdir -p output/aliyun-solution-article-illustrator
python3 tests/common/compile_skill_scripts.py \
--skill-path skills/solutions/aliyun-solution-article-illustrator \
--output output/aliyun-solution-article-illustrator/compile-check.json
合格基準:コマンドが 0 で終了し、output/aliyun-solution-article-illustrator/compile-check.json が "status": "pass" を含む状態で生成されます。
出力とエビデンス
- ワークフローの成果物を
output/aliyun-solution-article-illustrator/<topic-slug>/に保存します。 - 最低限、
source.md、outline.md、1 つ以上のプロンプトファイル、生成画像、article.with-images.md、delivery-report.mdを保存します。 - プロンプトを生成より先に作成した順序と、修復時に行った編集パスのエビデンスを保持します。
前提条件
- ソースとなる Markdown 記事。
references/backend-contract.mdの要件を満たす生成バックエンド。- リポジトリのデフォルト動作を希望する場合は、
aliyun-qwen-imageとaliyun-qwen-image-editを優先してください。 - プロジェクトまたはユーザースコープの任意の
EXTEND.md設定。
ワークフロー
- プロジェクトレベルまたはユーザーレベルの
EXTEND.mdを含め、設定と参照資料を事前に確認します。 - ソースの Markdown 記事を分析し、イラストを挿入する候補位置を特定します。
- タイプ、密度、スタイル、任意の言語、出力サイズの設定を一括で確認します。
- バックエンドを選択または推奨し、
outline.mdを作成します。 - 生成ステップの前にプロンプトファイルを保存します。
- 選択した生成バックエンドを使って、初回の画像を生成します。デフォルトでは
aliyun-qwen-imageを推奨します。 - 必要に応じて、選択した編集バックエンドを使い、画像ごとに 1 回の修復パスを実行します。デフォルトでは
aliyun-qwen-image-editを推奨します。 - 相対パスの
images/...Markdown リンクを含むarticle.with-images.mdを作成します。 - エビデンスを保存し、
delivery-report.mdを作成します。
最小実行例
python3 skills/solutions/aliyun-solution-article-illustrator/scripts/run_workflow.py \
--source path/to/article.md \
--output-dir output/aliyun-solution-article-illustrator/example-run \
--generation-backend mock
状態ゲート
drafted:ソース記事と初期アウトラインが存在しますconfirmed:ユーザー設定、環境設定、バックエンドの選択が確定していますgenerated:プロンプトファイルと初回の画像が存在しますvalidated:成果物の構成と Markdown への挿入がチェックに合格していますdelivered:最終記事とレポートが書き込まれています
参照資料
- 詳細なワークフロー:
references/workflow.md - 使用例:
references/usage.md - スタイルシステム:
references/styles.md - バックエンドの要件:
references/backend-contract.md - プロンプト作成ルール:
references/prompt-construction.md - 出力要件:
references/output-spec.md - 検証とテストの要件:
references/test-plan.md - 設定方法:
references/config/first-time-setup.md - 環境設定のスキーマ:
references/config/preferences-schema.md - ソース参照資料:
references/sources.md - ヘルパースクリプト:
scripts/load_preferences.py、scripts/validate_inputs.py、scripts/build_outline.py、scripts/collect_evidence.py
コメント
Markdown 対応