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
- Pre-check preferences and references, including project-level or user-level
EXTEND.md.
- Analyze the source Markdown article and identify candidate illustration positions.
- Confirm settings in one batch: Type, Density, Style, optional Language, and output size.
- Choose or recommend a backend and build
outline.md.
- Save prompt files before any generation step.
- Use the selected generation backend for first-pass images. Recommend
aliyun-qwen-image by default.
- If needed, use the selected edit backend for one repair pass per image. Recommend
aliyun-qwen-image-edit by default.
- Write
article.with-images.md with relative images/... Markdown links.
- 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 existconfirmed: user settings, preferences, and backend choice are confirmedgenerated: prompt files and first-pass images existvalidated: artifact structure and Markdown insertion pass checksdelivered: 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
1---
2name: aliyun-solution-article-illustrator
3description: 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.
4version: 1.0.0
5---
6
7Category: solution
8
9# Content Article Illustrator
10
11Preserve the article-illustration workflow model while recommending Alibaba Cloud skills as the default execution backends.
12
13## Two Dimensions
14
15| Dimension | Controls | Examples |
16|-----------|----------|----------|
17| **Type** | Information structure | infographic, scene, flowchart, comparison, framework, timeline |
18| **Style** | Visual aesthetics | notion, warm, minimal, blueprint, watercolor, editorial |
19
20## Validation
21
22```bash
23mkdir -p output/aliyun-solution-article-illustrator
24python3 tests/common/compile_skill_scripts.py \
25 --skill-path skills/solutions/aliyun-solution-article-illustrator \
26 --output output/aliyun-solution-article-illustrator/compile-check.json
27```
28
29Pass criteria: command exits 0 and `output/aliyun-solution-article-illustrator/compile-check.json` is generated with `"status": "pass"`.
30
31## Output And Evidence
32
33- Write workflow artifacts under `output/aliyun-solution-article-illustrator/<topic-slug>/`.
34- Save at least: `source.md`, `outline.md`, one prompt file, generated images, `article.with-images.md`, and `delivery-report.md`.
35- Keep evidence for prompt-before-generation ordering and any edit pass used during repair.
36
37## Prerequisites
38
39- A source Markdown article.
40- A generation backend that satisfies `references/backend-contract.md`.
41- If you want repository-default behavior, prefer `aliyun-qwen-image` and `aliyun-qwen-image-edit`.
42- Optional `EXTEND.md` preferences at project or user scope.
43
44## Workflow
45
461. Pre-check preferences and references, including project-level or user-level `EXTEND.md`.
472. Analyze the source Markdown article and identify candidate illustration positions.
483. Confirm settings in one batch: Type, Density, Style, optional Language, and output size.
494. Choose or recommend a backend and build `outline.md`.
505. Save prompt files before any generation step.
516. Use the selected generation backend for first-pass images. Recommend `aliyun-qwen-image` by default.
527. If needed, use the selected edit backend for one repair pass per image. Recommend `aliyun-qwen-image-edit` by default.
538. Write `article.with-images.md` with relative `images/...` Markdown links.
549. Save evidence and produce `delivery-report.md`.
55
56## Minimal Executable Run
57
58```bash
59python3 skills/solutions/aliyun-solution-article-illustrator/scripts/run_workflow.py \
60 --source path/to/article.md \
61 --output-dir output/aliyun-solution-article-illustrator/example-run \
62 --generation-backend mock
63```
64
65## State Gates
66
67- `drafted`: source article and initial outline exist
68- `confirmed`: user settings, preferences, and backend choice are confirmed
69- `generated`: prompt files and first-pass images exist
70- `validated`: artifact structure and Markdown insertion pass checks
71- `delivered`: final article and report are written
72
73## References
74
75- Detailed workflow: `references/workflow.md`
76- Usage examples: `references/usage.md`
77- Style system: `references/styles.md`
78- Backend contract: `references/backend-contract.md`
79- Prompt construction rules: `references/prompt-construction.md`
80- Output contract: `references/output-spec.md`
81- Validation and test expectations: `references/test-plan.md`
82- Config setup: `references/config/first-time-setup.md`
83- Preferences schema: `references/config/preferences-schema.md`
84- Source references: `references/sources.md`
85- Helper scripts: `scripts/load_preferences.py`, `scripts/validate_inputs.py`, `scripts/build_outline.py`, `scripts/collect_evidence.py`
cinience