alicloud-solution-content-article-illustrator

类别：解决方案

内容文章插图工具

保留文章插图工作流模型，同时推荐默认使用阿里云技能作为执行后端。

两个维度

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

验证

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/alicloud-solution-content-article-illustrator/<topic-slug>/。
• 至少保存：source.md、outline.md、一个提示词文件、生成的图片、article.with-images.md 和 delivery-report.md。
• 保留提示词先于生成的顺序证据，以及修复过程中使用的任何编辑步骤证据。

前置条件

• 一篇源 Markdown 文章。
• 一个符合 references/backend-contract.md 要求的生成后端。
• 如果希望使用仓库默认行为，优先选择 alicloud-ai-image-qwen-image 和 alicloud-ai-image-qwen-image-edit。
• 可选：项目级或用户级的 EXTEND.md 偏好设置。

工作流

1. 预先检查偏好设置和参考资料，包括项目级或用户级的 EXTEND.md。
2. 分析源 Markdown 文章并确定候选插图位置。
3. 一次性确认设置：类型、密度、风格、可选语言和输出尺寸。
4. 选择或推荐后端，并构建 outline.md。
5. 在任何生成步骤之前保存提示词文件。
6. 使用所选生成后端生成第一版图片。默认推荐 alicloud-ai-image-qwen-image。
7. 如有需要，使用所选编辑后端对每张图片进行一轮修复。默认推荐 alicloud-ai-image-qwen-image-edit。
8. 编写 article.with-images.md，其中使用相对路径 images/... 的 Markdown 链接。
9. 保存证据并生成 delivery-report.md。

最小可执行运行

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

状态关卡

• drafted：源文章和初始大纲已存在
• confirmed：用户设置、偏好和后端选择已确认
• generated：提示词文件和第一版图片已存在
• validated：产物结构和 Markdown 插入内容均通过检查
• delivered：最终文章和报告已写入

参考资料

• 详细工作流：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
• 偏好设置模式：references/config/preferences-schema.md
• 源参考资料：references/sources.md
• 辅助脚本：scripts/load_preferences.py、scripts/validate_inputs.py、scripts/build_outline.py、scripts/collect_evidence.py