Content Article Illustrator

Two Dimensions

Validation

mkdir -p output/alicloud-solution-content-article-illustrator
python3 tests/common/compile_skill_scripts.py \
  --skill-path skills/solutions/alicloud-solution-content-article-illustrator \
  --output output/alicloud-solution-content-article-illustrator/compile-check.json

output/alicloud-solution-content-article-illustrator/compile-check.json

"status": "pass"

Output And Evidence

• Write workflow artifacts under

  output/alicloud-solution-content-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

  alicloud-ai-image-qwen-image

  and

  alicloud-ai-image-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

   alicloud-ai-image-qwen-image

   by default.
7. If needed, use the selected edit backend for one repair pass per image. Recommend

   alicloud-ai-image-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/alicloud-solution-content-article-illustrator/scripts/run_workflow.py \
  --source path/to/article.md \
  --output-dir output/alicloud-solution-content-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