| name | wechat-super-power |
| description | 内容全流程助手：topic → 相关文章列表 → 知识库 → 爆点分析 → 框架 → 写作 → 配图/图文。
适用于围绕公众号/微信文章场景，从选题出发完成资料抓取、知识沉淀、观点提炼、
框架组织、写作推进与图文成稿。
触发关键词：公众号、微信文章、推文、选题、知识库、爆点分析、文章框架、写作、配图、图文、首图、封面图。
不应被纯 blog、邮件、PPT、短视频脚本等泛内容任务触发，除非用户明确要走本文档定义的内容工作流。
|
Wechat Super Power
行为声明
角色：用户的内容研究与写作流程 Agent。
默认模式：
- 默认按 6 步主流程推进，不把任务拆成零散回答。
- 当用户要求“图文”“配图”“首图”“封面图”或“能直接发”的成稿时，扩展执行 Step 7。
- 能用脚本完成的步骤直接执行，不停在“建议”层。
- 不能用脚本完成的步骤，由 agent 基于已有知识库内容继续分析与产出。
范围边界：
- 当前仓库已经实现的“可执行能力”主要覆盖 Step 1-3。
- Step 4-7 主要依赖 prompt、知识库内容、agent 推理和 Codex 可用的图像生成能力，不依赖额外脚本。
降级原则：
- 搜索失败：明确报错，不伪造文章列表。
- 单篇抓取失败：保留失败原因，继续处理其他文章。
- 爆点分析阶段如果知识库内容不足：明确指出证据不足，再给出保守分析。
- 框架、写作与配图阶段如果上游素材质量不足：先说明不足，再基于已有内容继续推进。
- 配图阶段如果当前 Codex 环境没有可用图像生成工具：输出可直接复制使用的配图方案与图像提示词，不伪装已经生成图片。
完成协议：
DONE：已经完成当前请求要求的步骤，且输出可直接进入下一步。DONE_WITH_CONCERNS：已完成，但存在资料不足、抓取失败、反爬限制等问题。BLOCKED：关键输入缺失或知识库为空，无法继续。
路径约定：
{skill_dir} 指当前 SKILL.md 所在目录。- topic 对应的知识库目录默认位于
./knowledge-base/<topic-slug>/。
主管道（Step 1-7）
Step 1: 用户输入 topic
目标：
执行原则：
- 如果用户已经提供 topic，直接进入 Step 2。
- 如果用户没有提供 topic，但语义中存在明确主题，就把该主题作为 topic。
- 如果完全没有 topic，先向用户确认 topic，再继续。
输出：
Step 2: 抓取相关文章列表
执行方式：
node scripts/skill-entry.js search "<topic>" --limit <数量>
默认数量：
这一阶段应做什么：
- 围绕 topic 搜索相关文章列表
- 返回候选文章的标题、摘要、来源、发布时间、链接
- 为 Step 3 做输入准备
失败处理：
输出：
Step 3: 知识库沉淀
执行方式：
node scripts/skill-entry.js build-kb "<topic>" --limit <数量> --delay 3000 --output-dir <目录>
这一阶段应做什么：
- 把候选文章抓取为 Markdown
- 将成功文章写入 topic 对应知识库目录
- 保留成功/失败结果
这一阶段完成后，agent 应知道：
- 知识库目录位置
- 哪些文章抓取成功
- 哪些文章失败以及原因
输出：
Step 4: 爆点分析
这一阶段不调用脚本。
执行方式：
执行要求：
- 不要复述文章
- 结论优先
- 每个判断尽量回到具体文章内容或案例
- 如果知识库只有少量文章，要明确说明结论的置信度有限
输出结构建议：
Step 5: 输出文章框架
这一阶段不调用业务脚本，由 agent 基于 Step 4 的分析结果继续推进。
执行方式：
框架输出至少应包含：
- 开头策略
- 文章主线
- 段落安排
- 每段要写什么
- 哪些证据应放在哪一段
默认要求：
- 不只给框架类型名，要给可执行的大纲
- 如有必要，可给 2-3 套候选框架供用户选择
输出：
Step 6: 写作
这一阶段由 agent 基于 Step 4 和 Step 5 继续完成。
执行方式：
写作要求：
- 优先遵守 writing-guide.md 中的写作规范
- 不要脱离知识库证据胡乱发挥
- 保留内容策划阶段确定的冲突点和传播点
- 文章应能自然承接前面框架，而不是重新起炉灶
输出：
- 文章初稿 / 局部段落 / 标题方案 / 开头方案
Step 7: 配图与图文成稿
这一阶段由 agent 基于 Step 4-6 继续完成。用户明确要求“配图”“图文”“首图”“封面图”“能直接发”时必须执行；完整流程默认不强制生成图片，除非用户要求图文交付。
执行方式：
- 读取 image-guide.md
- 基于 topic、爆点分析、文章框架和最终文稿，设计图片清单
- 优先生成：
首图/封面图：1 张，承担点击与主题表达文内配图：2-4 张，分别服务于关键段落、冲突点、数据/案例或情绪转折社交分享图：可选，适合朋友圈/社群转发
Codex 内直接使用要求：
- 如果当前 Codex 会话可用
imagegen skill 或图像生成工具，agent 应直接调用它生成图片，而不是只给提示词。
- 生成图片前先把文稿拆成可视化场景，不要把整篇文章塞进一个提示词。
- 每张图都应有明确用途、放置位置和图像提示词。
- 如果需要真实人物、品牌、产品、地标或新闻现场图，优先使用用户提供素材或可核验的真实图片；不要编造“真实截图”。
- 默认生成 bitmap 图片，不用 SVG 当公众号配图。
图片风格原则：
- 公众号商业/知识类文章：克制、清晰、有叙事焦点，避免廉价海报感。
- 观点/评论类文章：用隐喻场景、人物关系、空间张力表达冲突，不要把标题文字硬贴满画面。
- 教程/方法类文章：优先信息图、流程图、操作场景图，图像服务理解。
- 情绪/故事类文章：优先电影感场景、细节特写、人物状态，图像服务共情。
输出结构：
图文成稿：正文中用 [配图：图片名] 标记插入位置图片清单：文件名 / 用途 / 放置位置 / 画面说明 / prompt生成结果：如已调用图像工具，展示或列出生成图片路径；如未能调用，说明原因并保留 prompt
完成标准：
- 图片与正文观点一致，不喧宾夺主
- 每张图都能解释为什么出现在对应段落
- 封面图独立看也能表达选题张力
- 文内图片不重复同一种构图或同一种情绪
辅助能力
单篇抓取
当用户已经给出具体文章链接，而不是让你先搜再沉淀时，运行：
node scripts/skill-entry.js fetch "<文章链接>"
适用场景：
- 用户给出
mp.weixin.qq.com/...
- 用户给出具体网页文章链接并要求提取正文
直接批量入库
当用户已经有一批文章链接，希望直接写入知识库时，运行：
node scripts/skill-entry.js save-articles "<topic>" "<链接1>" "<链接2>" --output-dir <目录>
Agent 执行规范
- 如果用户请求是完整内容流程，优先按 Step 1-6 顺序推进，而不是只执行局部步骤。
- 如果用户只请求其中一步，就只执行那一步以及必要前置步骤。
- Step 1-3 用脚本，Step 4-7 用 prompt、agent 推理和 Codex 可用的图像生成能力。
- 做 Step 4 时，必须优先读取知识库内容，不要脱离资料直接分析。
- 做 Step 5、Step 6 和 Step 7 时，必须继承 Step 4 的结论，不要与上一步脱节。
- 做 Step 6 时，必须先读取 writing-guide.md，再开始写作。
- 做 Step 7 时，必须先读取 image-guide.md，再设计或生成图片。
- 如果知识库为空或文章过少，应明确说明，不要假装分析充分。
- 如果用户只要“配图”或“图文”，先确认是否已有正文；有正文则直接进入 Step 7，没有正文则先完成必要的 Step 4-6。
文件地图
scripts/skill-entry.js：统一 CLI 入口scripts/search_wechat.js：相关文章搜索scripts/fetch_wechat_article.js：文章抓取与 Markdown 转换scripts/build_knowledge_base.js：围绕 topic 搜索并沉淀知识库scripts/save_web_articles.js：将文章链接直接写入知识库references/hotspot-analysis-prompt.md：Step 4 爆点分析 promptreferences/frameworks.md：Step 5 框架生成参考references/writing-guide.md：Step 6 写作规范与 promptreferences/image-guide.md：Step 7 配图策略与图像 prompt 规范
快速响应模式
用户要“做完整流程”
按顺序推进：
- 明确 topic
- 搜索文章列表
- 搭建知识库
- 做爆点分析
- 输出框架
- 写作
如果用户同时说“图文”“配图”“能直接发”，继续：
7. 设计图片清单并在 Codex 中直接生成图片
用户只要“爆点分析”
不要调用新脚本，直接：
- 找到知识库目录
- 读取 Markdown 文章
- 使用 hotspot-analysis-prompt.md
- 输出
选题价值 / 冲突点 / 传播点 / 可写角度 / 证据来源
用户只要“框架”
先确认是否已有 Step 4 的分析结果：
- 有：直接基于分析结果输出框架
- 没有：先做 Step 4，再给框架
用户只要“配图 / 图文”
先确认是否已有正文：
- 有正文：直接读取 image-guide.md，进入 Step 7。
- 没有正文但已有框架/分析：先写出必要正文或段落，再进入 Step 7。
- 没有任何上游素材：先从 Step 1 开始走必要流程。
输出时优先给用户可直接使用的图文结果：
- 正文插图位置
- 图片文件或图片路径
- 图片说明
- 备用 prompt
