微信公众号文章创作技能

Script: python3 {baseDir}/scripts/writer.py

本技能为微信公众号文章创作提供全流程的核心指导。它不是一个必须从头走到尾的线性工作流，而是由多个独立模块组成的创作指导集——agent 应根据用户当前所处的创作阶段和实际需求，灵活调用对应模块。

核心规则

1. API Key 未配置 = 技能不可用，必须停止一切创作动作

• 技能激活后第一步必须执行 python3 {baseDir}/scripts/writer.py check 确认 Key 配置状态。
• 如果 check 失败：立即停止，只做一件事——告诉用户需要配置 Key，给出配置方法，然后等待用户完成配置。 不要读模块文档，不要搜索热点，不要分析选题，不要用网络搜索替代，不要做任何创作相关的事情。
• 没有 Key 就没有热点聚合搜索、没有风格拆解、没有图片生成——整个创作流程无法运行，用网络搜索凑出来的内容不符合本技能的质量标准。

2. 通过脚本调用 API — skill内的能力通过 writer.py和 render.py 脚本调用，因为脚本封装了 API 认证、错误处理和格式化输出，直接 curl 会缺少这些保障。
3. API 失败最多重试 1 次 — 同一个接口连续失败 2 次后停止重试，告知用户原因并给出替代方案，避免无意义的等待。

API Key Setup

编辑 {baseDir}/scripts/config.json，填写 api_key。或设置环境变量 100CITY_API_KEY。

快速检查：python3 {baseDir}/scripts/writer.py check

Script Quick Reference

# 检查连接
python3 {baseDir}/scripts/writer.py check

# 统一搜索（news/wechat_article/image）
python3 {baseDir}/scripts/writer.py search --query "关键词" --action news
python3 {baseDir}/scripts/writer.py search --query "关键词" --action wechat_article

# 获取最新热点新闻
python3 {baseDir}/scripts/writer.py trend

# 关键词热点总结
python3 {baseDir}/scripts/writer.py trend-summary --keyword "关键词"

# 按公众号名称拆解创作风格
python3 {baseDir}/scripts/writer.py style-by-name --name "公众号名称"

# 按文章链接拆解创作风格
python3 {baseDir}/scripts/writer.py style-by-url --url "文章链接"

# AI 生成图片
python3 {baseDir}/scripts/writer.py generate-image --prompt "图片描述"
python3 {baseDir}/scripts/writer.py generate-image --prompt "图片描述" --ratio 16:9
python3 {baseDir}/scripts/writer.py generate-image --prompt "图片描述" --ref-url "参考图URL"

所有命令支持 --json 获取原始 JSON 输出。

Script: python3 {baseDir}/scripts/render.py

# 渲染 MD 为带样式的 HTML（微信公众号排版）
python3 {baseDir}/scripts/render.py render article.md --theme blue-minimal -o article.html

# 查看可用主题
python3 {baseDir}/scripts/render.py list-themes

# 从公众号文章链接拆解排版样式
python3 {baseDir}/scripts/render.py extract-style "https://mp.weixin.qq.com/s/xxxxx" --name "主题名" --id theme-id

模块总览

进入某个模块的详细执行时，读取对应的 reference 文件获取完整指导。

模块间协作关系

用户发起创作请求
    │
    ▼
[模块 A] 选题与方向确认 ← 创作入口
    │
    ├── 存在 MEMORY.md / MEMORY/ ？──→ [模块 B] 记忆适配（隐式融入创作）
    │
    ▼
[模块 C] 风格确认 ← 选题确认后、正文创作前
    │   检查 MEMORY.md 是否有风格偏好
    │   ├── 有 → 读取风格报告，遵循创作
    │   ├── 无 → 询问用户是否模仿某公众号
    │   │       ├── 用户提供名称/链接 → 拆解风格 → 保存到 MEMORY.md
    │   │       └── 用户不需要 → 使用公众号爆文默认风格
    │
    ▼
[模块 D] 正文创作与迭代 ← 核心环节（在风格框架确定后开始）
    │   D2 撰写时在配图位置插入 \x3C!-- IMG: 描述 --> 占位
    │
    ├── 用户确认文案 ──→ 可选：进入配图
    │
    ├── 用户要求公众号样式？──→ [模块 F] 公众号样式应用（render.py，占位图自动填充）
    │
    ▼
[模块 E] 配图策略（read .md → 扫描占位 → search/generate → 替换为真实图片）
    │   ⚠️ 消耗算力，仅在用户明确要求时执行
    │
    ├── 配图完成后可重新执行模块 F 渲染最终版
    │
    └── 创作完成

模块执行说明

• 模块 A 和模块 C 是正文创作前的两个关键环节，因为选题方向和风格框架直接决定了正文质量
• 模块 C 的三种结果（已有风格 / 拆解新风格 / 爆文默认风格）都会产出一套明确的写作框架，模块 D 在此框架下创作
• 模块 B 不产出独立交付物，隐式融入创作过程
• 模块 C 的配图习惯会传递给模块 D（占位描述）和模块 E（图片风格选择）
• 模块 D 专注文案质量，配图以占位标记形式预留位置；模块 E 在用户明确要求时执行配图替换（消耗算力，不擅自执行）
• 模块 F 不要求配图完成——.md 中的 \x3C!-- IMG: --> 占位标记会被渲染为占位图片并保留描述文字，后续可随时配图后重新渲染
• 整个流程中，用户随时可以要求回到任意模块进行调整