aliyun-solution-article-illustrator

name	aliyun-solution-article-illustrator
description	Use when the user needs an end-to-end article illustration workflow in this repository that preserves Type x Style planning, loads article-illustration preferences, recommends Alibaba Cloud image backends, and produces a Markdown article with inserted local image references.
version	1.0.0

Category: solution

Content Article Illustrator

Preserve the article-illustration workflow model while recommending Alibaba Cloud skills as the default execution backends.

Two Dimensions

Dimension	Controls	Examples
Type	Information structure	infographic, scene, flowchart, comparison, framework, timeline
Style	Visual aesthetics	notion, warm, minimal, blueprint, watercolor, editorial

Validation

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

Pass criteria: command exits 0 and output/aliyun-solution-article-illustrator/compile-check.json is generated with "status": "pass".

Output And Evidence

• Write workflow artifacts under output/aliyun-solution-article-illustrator/<topic-slug>/.
• Save at least: source.md, outline.md, one prompt file, generated images, article.with-images.md, and delivery-report.md.
• Keep evidence for prompt-before-generation ordering and any edit pass used during repair.

Prerequisites

• A source Markdown article.
• A generation backend that satisfies references/backend-contract.md.
• If you want repository-default behavior, prefer aliyun-qwen-image and aliyun-qwen-image-edit.
• Optional EXTEND.md preferences at project or user scope.

Workflow

1. Pre-check preferences and references, including project-level or user-level EXTEND.md.
2. Analyze the source Markdown article and identify candidate illustration positions.
3. Confirm settings in one batch: Type, Density, Style, optional Language, and output size.
4. Choose or recommend a backend and build outline.md.
5. Save prompt files before any generation step.
6. Use the selected generation backend for first-pass images. Recommend aliyun-qwen-image by default.
7. If needed, use the selected edit backend for one repair pass per image. Recommend aliyun-qwen-image-edit by default.
8. Write article.with-images.md with relative images/... Markdown links.
9. Save evidence and produce delivery-report.md.

Minimal Executable Run

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

State Gates

• drafted: source article and initial outline exist
• confirmed: user settings, preferences, and backend choice are confirmed
• generated: prompt files and first-pass images exist
• validated: artifact structure and Markdown insertion pass checks
• delivered: final article and report are written

References

• Detailed workflow: references/workflow.md
• Usage examples: references/usage.md
• Style system: references/styles.md
• Backend contract: references/backend-contract.md
• Prompt construction rules: references/prompt-construction.md
• Output contract: references/output-spec.md
• Validation and test expectations: references/test-plan.md
• Config setup: references/config/first-time-setup.md
• Preferences schema: references/config/preferences-schema.md
• Source references: references/sources.md
• Helper scripts: scripts/load_preferences.py, scripts/validate_inputs.py, scripts/build_outline.py, scripts/collect_evidence.py