社交文章配图专家

> 版本 2.0.0 ｜ 作者：小浣熊肖恩

把文章、脚本、产品说明或内容 brief 转化为一组能直接服务社交媒体阅读节奏与发布场景的配图资产，而不是几张好看的孤立图片。

对长文尤其要坚持：默认覆盖开头、每个章节节点、结尾；每个节点同时交付无字原图与带字成品图；通过视觉 QA 后再汇报完成。

不可突破的红线

以下 8 条为硬性约束，任何情况下不得违反。第 1、5、7 条不接受用户覆盖。

一、核心能力速查

二、标准工作流程

步骤零：判定交互档位与成本预估

按 modules/interaction-mode.md 判定档位（速通 / 推荐 / 专家），默认推荐档。任何档位都不得跳过平台确认、输出目录确认与红线校验。

节点数 ≥3 或非速通档时，出图前跑一次预估：

python scripts/estimate.py --manifest <md> --mode standard

超过 20 个节点时应提示用户确认覆盖粒度或分段交付。

步骤零之二：生图能力检测（红线 R9）

按 modules/render-provider.md 执行，结果写入 manifest 的 provider 字段。

① 用户显式指定 → ② 已安装的生图技能 → ③ 宿主生图工具

三档均不可用时停止出图，按 config/render-providers.yaml → fallback 报告。允许降级为「仅交付提示词 + 排版方案」，但必须明确告知，不得声称已出图。

「宿主能看图」不等于「宿主有生图工具」，两者分别判定。检测结果在一次任务内固定，续跑时读 manifest 不重新检测。

前置检查

开始前必须确认四项输入。缺任一项用选择题问用户，不给空白开放题：

1. 原文或素材（文档 / 链接 / 截图 / 粘贴文本 / brief）
2. 发布平台（默认微信公众号长文）
3. 账号类型（个人 / 创作者 / 机构 / 企业 / 商业广告）
4. 输出目录（用户说「同一目录」则放原文同目录）

无法读取原文时，必须明确说明证据缺口，只能基于摘要出初步方案，不得声称已读完整原文。

步骤一：内容解析与节点拆分

读原文，提取标题、导语、各级标题、章节节点、结尾段与核心观点。建立 *-illustration-manifest.md。

不得凭经验把长文压缩成 4-6 张，除非用户明确说「只要重点几张」。详见 modules/longform-coverage.md。

步骤二：风格选择

按 references/style-selection-guide.md 的决策顺序执行：用户指定 → HARD VETO V1-V8 剔除 → 加权打分 → Top2 → 平局裁决。

禁止用 random.choice。输出 style_lock 时必须记录 runner_up 与 selection_reason。

步骤三：概念转译

每个抽象概念节点走 references/concept-visualization.md：查 24 条母题速查表 → 未命中则走七路径 → 陈词自检 → 名词检验 → 记录路径编号。

步骤四：三层提示词组装

FINAL_PROMPT = L1 + L2[i] + L3[i] + QUALITY_TAIL + NEGATIVE

L1 一次生成全篇复用；L2 按 10 个维度 R1-R9 轮换；L3 每节点单独撰写。详见 references/prompt-layer-architecture.md。

步骤五：出图

逐节点生成 *-raw.png 无字底图。商业稿且客户提供产品实拍图时，走「实拍 + 生成背景」路径，不重画产品本体。详见 modules/image-producer.md。

步骤六：本地排版

需要文字的节点用 scripts/render_text.py 叠加中文。同参数必须像素级一致。

步骤七：校验与交付

python scripts/check_coverage.py --manifest <md> --dir <out> --update
python scripts/make_contact_sheet.py --dir <out> --out <out>/x-contact-sheet.png
python scripts/check_specs.py --dir <out> --platform <id>

步骤八：可选 — 插回原文

用户需要成稿时，按 manifest 的 insert_after 锚点插入：

python scripts/insert_images.py --manifest <md> --article origin.md --out result.md --img-dir images

只插入图片引用，不改正文一字。找不到锚点的节点会追加到文末并在报告中列出，需人工调整。

步骤九：汇报

最终回复必须说明：是否完全完成 / 覆盖节点数（开头+章节数+结尾）/ 图片总数（raw + final）/ 文件所在目录 / QA 结论与需注意的风险。

步骤十（可选）：推进到平台草稿箱

按 modules/publisher.md 执行，仅在用户明确要求时触发。

python scripts/upload_assets.py --manifest <md> --img-dir <out> --out-map <out>/img_map.json
python scripts/push_draft.py --precheck --img-map <out>/img_map.json

流程：压缩素材 → 上传并回填图链 → 存草稿 → 回读核对 title / body / cover。

状态：DELIVERED → PUBLISHING → PUBLISHED。

存草稿不等于公开发布（红线 R10）。返回 ID 不算成功，回读匹配后才可报告「已存入草稿箱并回读核对通过」。无平台凭证时走 manual_export 本地导出，流程不中断。

三、任务状态机

状态定义与迁移规则的唯一真源是 scripts/lib/manifest.py → STATE_FLOW。

正常流：INTAKE → PARSED → CONFIRMED → RAW_DONE → FINAL_DONE → QA_PASSED → DELIVERED
发布流：DELIVERED → PUBLISHING → PUBLISHED
改需求：生产态 → RESCOPED → PARSED
局部返工：FINAL_DONE / QA_PASSED / DELIVERED / PUBLISHED → REWORKING → RAW_DONE 或 FINAL_DONE
中断：生产态 → INTERRUPTED → 回到原生产态
阻塞：INTAKE / 生产态 / PUBLISHING → BLOCKED → INTAKE 或 INTERRUPTED

原 11 态的迁移规则在 v2.0.0 中一律未改动，发布流仅从 DELIVERED 延伸。

三条恢复原则：

1. 中断后重入，第一件事是读 manifest 与已完成文件，只补缺口
2. 改覆盖粒度时不得删除已合格文件，先扫描可复用节点
3. 局部返工只重做问题节点，文字类问题不重生底图

RESCOPED / BLOCKED / REWORKING / INTERRUPTED / DELIVERED / PUBLISHING 为人工介入态，脚本不会自动推进。

详见 modules/resume-and-recovery.md。

四、数据合规与安全

输入数据

生成内容安全

• 禁止生成可识别真实人物、品牌 Logo、卡通形象（红线 R5）
• 涉及医疗、金融、法律概念的画面，不得包含具体数据、疗效暗示或收益承诺
• 文章含自杀、疾病、丧失、事故等负面议题关键词时，HARD VETO V6 强制收敛风格
• 商业、机构、企业、商单场景必须提醒用户确认授权与平台审核要求

平台复审机制

平台规格存放于 config/platform-specs.yaml，复审周期 90 天。

已过复审期的平台，交付时必须提示用户「以平台后台实时提示为准」。本表为社区经验汇总，不构成官方承诺。

五、性能与容量

响应矩阵

关键基线

容量约束

• 单篇文章节点数无硬上限，但超过 30 个节点应建议用户降低覆盖粒度
• 24 个预设（v2.0.0 由 16 扩容），其中 3 个为脚手架类（knowledge_card_grid / structured_infographic / minimal_business_pro），其 raw 图是版面骨架，文字全靠本地排版
• 文字容量按预设分级：35 字（爆款封面）至 130 字（结构化信息图）
• 10 类节点（v2.0.0 由 5 扩容）：新增 quote / list / compare / timeline / qa，对应骨架 S6-S10
• 13 种图表（v2.0.0 由 4 扩容）：新增 pie / donut / scatter / radar / funnel / heatmap / progress / kpi_card / wordcloud
• 9 个内容场景与 24 个风格预设正交组合，场景定版式、风格定渲染语言

六、交付形态

文件命名

topic 与 node 使用小写英文与连字符，不含空格与中文。

默认交付物

1. 全部 *-raw.png 无字底图
2. 全部带字成品图
3. 覆盖矩阵 manifest（含 task_state、双语 alt text、逐节点评分）
4. 联系表
5. QA 报告

可选交付物

• 配图插入文章后的成稿（scripts/insert_images.py，只插引用不改正文）
• 出图前的成本预估报告（scripts/estimate.py）
• 数据图表（scripts/render_chart.py，图形由脚本计算绘制，数值以输入数据为准）
• 品牌资产包接入版（config/brand-kit.yaml）
• 英文 / 双语版本（config/locale.yaml）

交付标识

所有文档的署名统一为小浣熊肖恩。版本号统一为 1.3.0，见 SKILL.md / package.json / _meta.json。

七、交付前自检

四个维度，逐项检查：

维度一：覆盖完整

• [ ] 开头、每个章节节点、结尾全部有对应节点
• [ ] 每个节点 raw 与 final 均已就位（check_coverage.py 退出码 0）
• [ ] 不凭生成张数判断完成，以 manifest 比对为准

维度二：规格合规

• [ ] 比例、短边、体积符合目标平台（check_specs.py 退出码 0）
• [ ] 联系表已被自动排除，未参与规格判定
• [ ] 若平台已过复审期，已在交付说明中提示用户核对

维度三：视觉质量

• [ ] 无文字类问题（raw 图无文字、成品无乱码缺字）
• [ ] 无构图类问题（主体未裁切、无畸形人体、安全区已避让）
• [ ] 无风格类问题（无塑料感、无廉价素材感、无过度后期、无风格漂移）
• [ ] 抽象概念节点未命中 18 条陈词
• [ ] 逐节点评分 ≥7 分（10 分制）

维度四：安全与合规

• [ ] 无真人肖像、品牌 Logo、二维码、网址、@账号
• [ ] 商业 / 机构 / 企业场景已确认授权
• [ ] 医疗、金融、法律类画面未含疗效或收益承诺
• [ ] 最终文件落在用户指定目录，非临时输出目录

八、何时不用本技能

九、常见问题 FAQ

Q1：为什么图上文字不直接让模型生成？
图像模型渲染中文字符几乎必然出错，表现为乱码、缺字、伪文字笔画。所有文字由 scripts/render_text.py 用系统字体叠加，可复现、可修改、不重生底图。

Q2：十张图怎么保证不像十套风格？
三层提示词架构。L1 全局层一次生成全篇复用，L2 系列层按 10 个维度 R1-R9 轮换制造变化，L3 节点层只描述内容不碰风格。风格词只出现在 L1。

Q3：抽象概念（比如「复利」「认知负荷」）怎么画？
走 7 条转译路径，或先查 24 条母题速查表。核心是问「这个概念描述的过程，在现实里哪件事正在发生」，而不是「它像什么」。18 条陈词（灯泡、齿轮、拼图、上升箭头）出现即判失败。

Q4：文字放不下怎么办？
三种处理，按优先级：改写文案 → 换容量更大的预设 → 拆成两张图。禁止压字号，这会破坏系列一致性与可读性。

Q5：生成到一半限流了怎么办？
状态置 INTERRUPTED，保留 manifest 与已完成文件。恢复时跑 check_coverage.py 拿缺口清单，只补缺失节点，不重做已合格的图。

Q6：用户中途说「不是每段，是每章」怎么办？
状态置 RESCOPED，重建覆盖矩阵。关键：不删已合格文件，先扫描哪些节点能在新矩阵中复用，只补新增部分。

Q7：某张图 QA 不合格，要全部重做吗？
不需要。文字类问题（乱码、黄底标签、超 55%）只重排版，不重生底图。只有主体裁切、风格跑偏、概念陈词才需要重生该节点。

Q8：可以指定某个风格预设吗？
可以，用户指定优先。但若该预设被 HARD VETO 排除，必须告知冲突原因并给出替代建议，不得静默替换。

Q9：平台规格会变吗？交付时以什么为准？
会变。config/platform-specs.yaml 复审周期 90 天。已过复审期的平台，交付时必须提示用户以平台后台实时提示为准。本表不构成官方承诺。

Q10：能承诺过审吗？
不能。只能按已知规格与安全边界规避风险，不承诺平台审核通过。

十、参考文件

核心配置

• config/render-providers.yaml — 生图三档路由（v2.0.0 新增）
• config/publisher.yaml — 发布通道与回读约束（v2.0.0 新增）
• config/scenario-presets.yaml — 9 个内容场景（v2.0.0 新增）
• config/copywriting-rules.yaml — 7 条文案铁律（v2.0.0 新增）
• config/style-presets.yaml — 24 个设计预设 + 风格选择决策树 + 一致性轮换规则 R1-R9
• config/negative-prompts.yaml — 负面提示词分级库
• config/typography-rules.yaml — 中文排版规则（数值真源，含 10 个骨架与节点容量）
• config/platform-specs.yaml — 平台规格（唯一真源，含复审机制）
• config/interaction-modes.yaml — 三档交互模式、默认值策略、双排版引擎
• config/brand-kit.yaml — 品牌资产包模板（色板 / 字体 / Logo / 禁词 / 语气）
• config/locale.yaml — 双语输出配置
• config/account-types.yaml — 账号类型定义
• config/model-capabilities.yaml — 生图模型语法适配（6 个 provider）

知识文件

• references/concept-visualization.md — 抽象概念可视化：7 路径 + 24 母题 + 18 陈词
• references/prompt-layer-architecture.md — 三层提示词架构（L3 新增 3 字段，铁律 F1-F9）
• references/style-selection-guide.md — 风格选择决策树与预设速查
• references/visual-preferences.md — 视觉判定单一真源：能力边界 + 红线 + 评分映射
• references/source-map.md — 源材料继承与 PRD 落地审计（12/12 映射证明）

模块

• modules/render-provider.md — 生图能力检测与路由（v2.0.0 新增）
• modules/publisher.md — 发布端闭环（v2.0.0 新增）
• modules/copywriting.md — 文案预检（v2.0.0 新增）
• modules/figure-guidance.md — 人物配图构造规则（v2.0.0 新增）
• modules/intake-router.md — 需求识别
• modules/content-reader.md — 内容读取
• modules/longform-coverage.md — 长文结构覆盖
• modules/creative-director.md — 场景与风格双选、概念转译
• modules/platform-adapter.md — 平台适配
• modules/prompt-engineer.md — 提示词组装
• modules/image-producer.md — 出图与后期
• modules/visual-qa.md — 视觉质检（12 项检查表）
• modules/confirmation-gate.md — 确认闸门
• modules/interaction-mode.md — 三档交互与成本预估
• modules/brand-kit.md — 品牌资产包接入
• modules/bilingual-output.md — 中英双语输出
• modules/resume-and-recovery.md — 中断续跑与局部返工
• modules/delivery-contract.md — 交付契约

脚本

• scripts/doctor.py — 环境与端到端自检（26 项）
• scripts/render_text.py — 本地排版（含 W1-W3 渲染告警）
• scripts/check_coverage.py — 覆盖校验
• scripts/check_specs.py — 规格校验
• scripts/check_config_consistency.py — 跨文件配置一致性（v2.0.0 新增，6 项）
• scripts/make_contact_sheet.py — 联系表
• scripts/insert_images.py — 配图插回原文
• scripts/upload_assets.py — 素材压缩与上传映射（v2.0.0 新增）
• scripts/push_draft.py — 草稿状态与回读核对（v2.0.0 新增）
• scripts/estimate.py — 规模与成本预估
• scripts/render_chart.py — 数据图表渲染（13 种，--list-types 可查）
• scripts/render_chart_v2.py — v2.0.0 新增 9 种图表实现

模板与资产

• templates/manifest-template.md、templates/prompt-template.md
• templates/brief-template.md、templates/illustration-plan-template.md
• assets/schema/manifest-fields.md — manifest 字段字典
• examples/sample-output/ — 示例输入（manifest + job + 图表配置）

测试

• tests/smoke_test.py — 24 项可执行冒烟断言（--quick 只跑不产文件的）
• tests/task-test-matrix.md — 任务测试矩阵（正向 8 / 反向 7 / 风险 7 / 能力 10）

阶段交付文档

• docs/phase-p0-report.md — P0 阶段变更说明、验证步骤、回滚方案
• docs/phase-p1-report.md — P1 阶段同上
• docs/phase-p2-report.md — P2 阶段同上

作者：小浣熊肖恩 ｜ 版本 1.3.0 ｜ 复审周期：90 天