alicloud-solution-content-article-illustrator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

维度	控制项	示例
类型	信息结构	信息图、场景图、流程图、对比图、架构图、时间线
风格	视觉美学	Notion风格、温暖风、极简风、蓝图风、水彩风、编辑风

Validation

验证

bash

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

Pass criteria: command exits 0 and

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

is generated with

"status": "pass"

bash

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

通过标准：命令执行退出码为0，且生成的

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.

将工作流产物写入

output/alicloud-solution-content-article-illustrator/<topic-slug>/

目录下。

至少保存以下文件：
```
source.md
```
、
```
outline.md
```
、一个提示词文件、生成的图片、
```
article.with-images.md
```
和
```
delivery-report.md
```
。
保留生成前的提示词顺序证据，以及修复过程中使用的任何编辑记录。

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.

一篇源Markdown文章。
符合
```
references/backend-contract.md
```
要求的生成后端。

如果需要使用仓库默认行为，优先选择

alicloud-ai-image-qwen-image

和

alicloud-ai-image-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
```
alicloud-ai-image-qwen-image
```
by default.
If needed, use the selected edit backend for one repair pass per image. Recommend
```
alicloud-ai-image-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文章，识别候选配图位置。
批量确认设置：类型、密度、风格、可选语言和输出尺寸。
选择或推荐一个后端，并构建
```
outline.md
```
。
在任何生成步骤前保存提示词文件。
使用选定的生成后端生成第一轮图片。默认推荐
```
alicloud-ai-image-qwen-image
```
。
如有需要，使用选定的编辑后端对每张图片进行一次修复。默认推荐
```
alicloud-ai-image-qwen-image-edit
```
。
编写包含相对路径
```
images/...
```
的Markdown链接的
```
article.with-images.md
```
。
保存证据并生成
```
delivery-report.md
```
。

Minimal Executable Run

最小可执行运行示例

bash

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

bash

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

```
drafted
```
：源文章和初始大纲已存在
```
confirmed
```
：用户设置、偏好和后端选择已确认
```
generated
```
：提示词文件和第一轮图片已生成
```
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
```
提示词构建规则：
```
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