创作工作流

这几条工作流适合直接交给 Agent 执行。Agent 应先检查授权和模型，再提交生成任务，最后确认任务结果与本地文件改动。

Markdown 自动配图

适合文章、教程、产品文档和 MDX 页面。

1. 读取目标 Markdown/MDX，理解标题、二级标题和正文主题。
2. 确认 xianchou CLI 可用，并检查 Access Key 与项目 ID。
3. 运行 dry-run，查看生成计划：

xianchou markdown images ./article.md --cover --count 3

4. 如果计划合理，再写回文件：

xianchou markdown images ./article.md --cover --count 3 --write

5. 检查 frontmatter、图片链接和正文图片块。

CLI 会插入带标记的图片块，重复运行时用它更新已有图片，避免重复插入：

<!-- xianchou:image title="章节标题" -->
![章节标题配图](./assets/article-01.webp)

单张图片素材

适合快速生成封面、插图、社媒图或视频参考图。

1. 先查询图片模型：

xianchou models image

2. 根据返回结果选择 provider、model、比例和分辨率。
3. 提交生图任务并轮询：

xianchou generate image   --prompt "一张适合 AI 视频教程的横版封面图，干净、科技感、中文留白"   --ratio 16:9   --poll

4. 保存返回的图片 URL，必要时下载到项目资源目录。

AI 视频创作

适合文生视频、图生视频和风格参考视频。

1. 先查询视频模型：

xianchou models video

2. 根据素材选择模式：没有素材用 text，一张首帧用 first，首尾帧明确用 first-last，需要保留主体或风格用 reference。
3. 确保所有图片或视频 URL 都能被献丑服务访问。本地路径不能直接作为 URL 使用。
4. 提交任务并使用 --poll：

xianchou generate video   --mode reference   --prompt "保留参考图人物形象，镜头缓慢推进，电影感光影"   --reference-url "https://example.com/reference.png"   --poll

5. 记录返回的视频 URL，确认任务已经 settle。

交给 Agent 的推荐说法

你可以这样描述需求：

请使用献丑 Skill，为 ./docs/tutorial.md 生成 1 张封面和 4 张正文配图，先 dry-run 给我确认，不要直接写回。

请用 xianchou CLI 生成一段 5 秒 AI 视频。先查询可用视频模型，再根据这张参考图选择合适模式。

请为这篇 MDX 自动插图，图片保存到 ./static/images，Markdown 中使用 /images 作为 URL 前缀。