aliyun-solution-article-illustrator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Category: solution

分类：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

维度	控制项	示例
Type	信息结构	infographic, scene, flowchart, comparison, framework, timeline
Style	视觉美学	notion, warm, minimal, blueprint, watercolor, editorial

Validation

验证

bash

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"

bash

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 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.

工作流产物写入

output/aliyun-solution-article-illustrator/<topic-slug>/

目录下。

至少保存：
```
source.md
```
、
```
outline.md
```
、一个prompt文件、生成的图片、
```
article.with-images.md
```
和
```
delivery-report.md
```
。
保留生成前prompt排序凭证，以及修复过程中使用的所有编辑步骤记录。

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.

一篇源Markdown文章。
符合
```
references/backend-contract.md
```
要求的生成后端。
若需要使用仓库默认行为，优先选择
```
aliyun-qwen-image
```
和
```
aliyun-qwen-image-edit
```
。
可选项目或用户层级的
```
EXTEND.md
```
偏好配置。

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
```
.

预检查偏好配置和参考文档，包括项目级或用户级的
```
EXTEND.md
```
。
分析源Markdown文章，识别候选配图位置。
批量确认配置：Type、密度、Style、可选语言和输出尺寸。
选择或推荐后端，构建
```
outline.md
```
。
在所有生成步骤之前保存prompt文件。
使用选中的生成后端生成第一版图片，默认推荐
```
aliyun-qwen-image
```
。
若有需要，使用选中的编辑后端对每张图片进行一次修复，默认推荐
```
aliyun-qwen-image-edit
```
。
写入包含相对路径
```
images/...
```
Markdown链接的
```
article.with-images.md
```
文件。
保存凭证并生成
```
delivery-report.md
```
。

Minimal Executable Run

最小可执行运行

bash

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

bash

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

```
drafted
```
：已存在源文章和初始大纲
```
confirmed
```
：用户配置、偏好和后端选择已确认
```
generated
```
：已存在prompt文件和第一版图片
```
validated
```
：产物结构和Markdown插入步骤校验通过
```
delivered
```
：已写入最终文章和报告

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

详细工作流：
```
references/workflow.md
```
使用示例：
```
references/usage.md
```
风格系统：
```
references/styles.md
```
后端协议：
```
references/backend-contract.md
```
Prompt构建规则：
```
references/prompt-construction.md
```
输出协议：
```
references/output-spec.md
```
验证与测试预期：
```
references/test-plan.md
```
配置设置：
```
references/config/first-time-setup.md
```
偏好配置schema：
```
references/config/preferences-schema.md
```
源参考：
```
references/sources.md
```

辅助脚本：

scripts/load_preferences.py

、

scripts/validate_inputs.py

、

scripts/build_outline.py

、

scripts/collect_evidence.py