关于 aliyun-solution-article-illustrator
该技能将 Markdown 文章转化为带插图的成稿,面向需要按步骤制作文章配图的内容创作者。它结合结构类型与视觉风格设置,并将 Alibaba Cloud 技能作为默认图像生成和编辑后端建议。
主要功能
- 01分析文章并规划插图位置
- 02设置类型、密度与视觉风格
- 03生成提示词及首轮图像
- 04按需进行图像修复
- 05插入图片并输出交付报告
适用场景
- 01为技术文章规划信息图或流程图
- 02按指定风格为 Markdown 文章配图
- 03检查并交付含图片的文章文件
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill aliyun-solution-article-illustrator安装后在 Claude Code 中输入/aliyun-solution-article-illustrator确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlprompts/system.mdreferences/backend-contract.mdoutput-spec.mdprompt-construction.mdsources.mdstyles.mdtest-plan.mdusage.mdworkflow.mdreferences/config/first-time-setup.mdpreferences-schema.mdreferences/styles/blueprint.mdeditorial.mdminimal.mdnotion.mdwarm.mdwatercolor.mdscripts/build_outline.pycollect_evidence.pyload_preferences.pyrun_workflow.pyvalidate_inputs.pytemplates/delivery-report.mdoutline.mdprompt.md详细介绍
类别:解决方案
内容文章插图工具
保留文章插图工作流模型,同时推荐默认使用阿里云技能作为执行后端。
两个维度
| 维度 | 控制项 | 示例 |
|---|---|---|
| 类型 | 信息结构 | 信息图、场景、流程图、对比、框架、时间线 |
| 风格 | 视觉美学 | notion、温暖、极简、蓝图、水彩、编辑风 |
验证
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 退出,并生成包含 "status": "pass" 的 output/aliyun-solution-article-illustrator/compile-check.json。
输出与证据
- 将工作流产物写入
output/aliyun-solution-article-illustrator/<topic-slug>/。 - 至少保存:
source.md、outline.md、一个提示词文件、生成的图像、article.with-images.md和delivery-report.md。 - 保留提示词先于生成的顺序证据,以及修复过程中使用的任何编辑步骤的证据。
前提条件
- 一篇源 Markdown 文章。
- 一个符合
references/backend-contract.md的生成后端。 - 如果希望采用仓库默认行为,优先使用
aliyun-qwen-image和aliyun-qwen-image-edit。 - 可选的项目级或用户级
EXTEND.md偏好设置。
工作流
- 预先检查偏好设置和参考资料,包括项目级或用户级
EXTEND.md。 - 分析源 Markdown 文章并确定候选插图位置。
- 一次性确认设置:类型、密度、风格、可选的语言和输出尺寸。
- 选择或推荐后端,并构建
outline.md。 - 在任何生成步骤之前保存提示词文件。
- 使用所选生成后端生成首轮图像。默认推荐
aliyun-qwen-image。 - 如有需要,对每张图像使用所选编辑后端进行一次修复。默认推荐
aliyun-qwen-image-edit。 - 使用相对
images/...Markdown 链接编写article.with-images.md。 - 保存证据并生成
delivery-report.md。
最简可执行运行
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
状态关卡
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
评论
支持 Markdown