executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available
mp-article-writor微信公众号文章创作。当用户想把软件更新、产品新闻、工具测评、工作流探索、个人实践或生活感悟等素材整理成公众号文章时使用。即使用户只是说「帮我写篇文章」「整理成推文」「发公众号」,也应当触发此技能。
Independent GitHub snapshot · Automated classification · Original documentation governs
帮助作者将素材整理为一篇可直接进入微信公众号编辑和配图流程的静态图文长文。
本 Skill 只处理微信公众号。所有交给归藏 Skill 的任务都必须显式传递「微信公众号、静态图文」;禁止生成 Live Photo、MOV、PVT、GIF、MP4、视频替代品、小红书图片或其他平台封面。
开始写作前,根据用户目的和素材特征选择一个主类型:新闻和软件更新简报、产品体验和工具测评、个人实践和工作流复盘、技术解析和教程、生活叙事和观点文章。
根据作者希望文章回答的核心问题选择类型,日期、版本、发布记录等只作为辅助特征。用户已经明确类型,或创作目的足够清楚时直接选择,不重复询问。只有类型会实质改变文章结构且无法判断时,才询问一次。完整判断标准和各类型写法见 references/文章类型路由.md。选定类型后,在 Step 3、Step 4、Step 5 和 Step 8 持续应用对应规则。
严格按以下 11 个步骤顺序执行,不可跳步、不可合并。每一步完成后再进入下一步。
先读取 references/文章类型路由.md,确定并记录本次文章的主类型。新闻和软件更新简报不得套用个人故事、情绪曲线或价值升华要求。
先检查当前环境是否能够读取 guizang-social-card-skill 和 guizang-material-illustration。两个 Skill 都是完整静态视觉工作流的推荐前置条件,但不得自动安装、不得声明为强制依赖。
图片发布方式只接受 local 或 picgo,按以下优先级确定:本次请求中的明确选择、环境变量 MP_ARTICLE_IMAGE_MODE、向作者询问。当前请求已经明确选择时不重复询问;这也允许作者为单次任务覆盖环境变量中的持久默认值。
local。local 时,只生成本地图片,不探测 PicGo,不产生云端写入。picgo 时,视为作者授权本次任务通过 PicGo 上传最终图片,再检查本机 PicGo Server 是否可访问;只有环境变量提供的 picgo 才表示持久默认授权。local 或 picgo,文章写作和本地视觉生产仍可继续。如果任一 Skill 缺失,只提示一次并给出 references/视觉路由.md 中的安装命令,同时说明:文章写作仍可继续;Step 10 只能生产当前已安装 Skill 覆盖的视觉素材,缺失部分在 Step 11 标记为「待安装依赖后完成」。不要生成旧版题图或插图 prompt 作为替代,也不要在后续步骤重复提示安装。
使用 ask_user 工具向作者确认以下信息。当前请求已经明确提供的项目直接记录,不重复询问;只有仍然缺失且会影响文章结构、事实边界或交付方式的项目才需要提问:
guizang-social-card-skill 或 guizang-material-illustration。前者生成杂志或瑞士风格的完整排版卡片,后者生成 3D 瑞士编辑风格的材质插图。推荐选项应结合文章内容说明理由,但最终由作者确认。所选 Skill 缺失时,明确说明安装后才能生产对应插图。local-tests 目录作为最终交付目录。local 只生成本地图片并使用相对 Markdown 路径;picgo 上传到作者已经配置的图床并替换为 HTTPS 地址。当前请求和环境变量都未设置时只询问一次。picgo 时,才包含云端上传授权。正文解释性插图风格只询问一次。同一篇文章默认只使用一种归藏插图风格,作者明确要求混用时除外。真实截图和照片不计入风格混用。
篇幅按文章类型确定。新闻和软件更新简报推荐 1500-3000 字,其他类型通常推荐 4000-8000 字。优先保证文章结构完整、前后逻辑连贯,无需为凑字数而注水。如果素材不足,主动说明需要补充的内容,不自行编造。作者的可信度建立在真实性之上,编造细节或数据是不可接受的。
必须阅读 references/行文风格指南.md,以校准通用的行文、排版和标点规则。
然后按以下顺序查找可选的外部作者画像,只加载第一个可读取的文件:
MP_ARTICLE_AUTHOR_PROFILE 指向的文件。$HOME/.config/mp-article-writor/author-profile.md。默认路径不存在时直接使用本文档的中性写作基线,不为此打断作者。作者明确提供的路径或环境变量不可读取时,提示一次;除非作者要求必须加载画像,否则继续使用中性基线。
作者画像可以按现有文章主类型分别定义结构、分析方式和声音偏好,但不能新增文章类型,也不能覆盖本次明确要求、事实核查、类型路由和平台规则。画像文件属于本地私有资料,不得复制到公开 Skill、文章交付目录、SOURCES.md、审读记录或自检报告中,也不得在未获要求时复述其内容。
基于 Step 1 确认的意图和 Step 2 校准的语感,设计文章大纲。大纲应包含:
references/视觉路由.md使用 ask_user 工具将大纲呈现给作者,等待确认后再进入 Step 4。作者在当前请求中已经提供并明确确认大纲时,核对它覆盖本节要求后直接进入 Step 4,不重复请求确认。
根据确认后的大纲编写完整初稿。写作过程中遵守本文档中的中性写作基线、内容要求和行文规范;已加载作者画像时,只应用其中与当前主类型兼容的偏好。
初稿保存到 Step 1 已确认的输出目录中。随后在输出目录的 .mp-article-review/ 下保存一份内容完整、未经筛选的只读初稿副本,并记录其准确路径;该基线不得包含凭据,Step 7 修改工作稿时不得覆盖它。后续审读必须能够同时读取作者素材、这份初稿基线和当前工作稿。
先读取 references/去模板化审读.md,再把初稿、文章主类型、已确认素材边界和该参考文件交给 subagent 独立审读。审读不是作者身份检测,也不要求每次都找出问题;已经清楚、自然且符合文体的内容可以原样保留。每条意见应指出具体位置、可观察的问题、对阅读的影响、修改时必须保留的信息,以及建议方向。
调用 subagent 对初稿中涉及的事实性内容进行核查。核查范围:
核查标准:文中每一个事实性陈述都必须能追溯到作者提供的素材、公开可验证的信息、或作者明确声明的个人经历。无法追溯的内容必须标记为「待作者确认」或删除。
事实核查和正文链接分别处理。新闻和软件更新简报中的 commit SHA、commit 地址、PR 地址和代码证据统一记录在 SOURCES.md,默认不放在每节末尾。需要面向读者展示来源时,在文末集中列出官方公告、Release Notes 或产品文档。
主 Agent 读取 references/去模板化审读.md,再根据 Step 5 和 Step 6 返回的反馈修改初稿:
调用 subagent 对修改后的稿件和视觉脚本执行完整自检,检查范围包括本文档「自检清单」中的全部项目。向 subagent 提供作者素材、Step 4 记录的初稿基线路径、当前工作稿和 references/去模板化审读.md;缺少任一项时不得声称完成语义保真核对。subagent 对照这些材料检查有没有新增、遗漏或强化主张,独立评分,不受前序步骤影响;没有实质问题时可以明确给出「无需修改」。
终审必须同时检查 references/文章类型路由.md 中所选类型的专属规则。
根据 Step 8 的自检结果完成最终修改。只要终审后又修改了标题或正文含义,就再次调用 subagent 做一次限定范围的语义保真核对,对照作者素材、Step 4 初稿基线和候选终稿;通过后才能交付。纯排版、图片路径或 front matter 状态更新不需要重复语义核对。随后将终稿更新到文件中,附上自检报告,提供三个标题推荐,并确定用于组合封面左侧主封面区的标题和右侧方形分享区的短标题。
按 references/视觉路由.md 执行视觉生产:
guizang-social-card-skill 直接生成一张 3.35:1 公众号组合封面,固定输出 2412×720。左侧 1692×720 为主封面区,右侧 720×720 为方形分享区;两区分别设计,在同一 HTML 画布中直接渲染为一张 PNG,不先生成两张图片再拼接。PROMPTS.md。视觉生产前无需再次确认授权。完成首轮渲染后自动检查尺寸、裁切、文字、数据、文件路径和移动端可读性;发现问题后修复并重新渲染。
静态检查通过后,根据 Step 1 确定的图片发布方式处理文章引用:
local:保留全部本地成品,正文使用相对于文章文件的标准 Markdown 路径,例如 。在 SOURCES.md 记录本地路径,并把交付状态写为「需要在公众号编辑器中手动上传图片」。本地模式属于完整交付,不标记为工作流失败。picgo:运行 scripts/upload-images-to-picgo.mjs,将一张组合封面和全部最终正文图片批量上传到本机 PicGo Server。脚本保留本地可编辑源文件,只创建临时上传副本,并以「文章标题、素材角色、时间戳」生成唯一图床文件名。用 PicGo 返回的 HTTPS 地址更新文章,front matter 的 cover 指向组合封面,正文使用 。同时在 SOURCES.md 记录本地文件与远程地址的映射。PicGo 上传前执行 POST /heartbeat,旧版本返回 404 或 405 时继续尝试 /upload。上传后逐个验证远程地址返回 2xx 且内容类型为图片。不得读取、输出或写入腾讯云、GitHub、阿里云等图床凭据;上传配置完全交给作者已经配置的 PicGo。PicGo Server 默认地址为 http://127.0.0.1:36677,可用 --endpoint 或 PICGO_SERVER_URL 覆盖,基础地址和完整 /upload 地址都可使用。服务启用鉴权时只从 PICGO_SERVER_SECRET 环境变量取得 shared secret,不读取 PicGo 图床配置文件。
PicGo 连接失败、超时、鉴权失败或返回异常时,不修改文章中的本地图片引用,不删除本地成品。将交付状态写为「图片发布待完成」,记录失败信息和可重新执行的命令。
如果所需归藏 Skill 未安装,跳过该 Skill 对应的视觉生产,保留已经完成的文章和其他视觉素材,并把缺失项、安装命令和恢复入口写入交付检查。不得静默切换到另一种插图风格。
逐项确认:
2412×720。左侧主封面区为 1692×720,右侧方形分享区为 720×720,两区分别设计并位于同一张 PNG 中。.mp-article-review/ 中的初稿基线只用于审读,没有嵌入公众号正文、复制到 SOURCES.md 或上传到图床。local 时,文章使用有效的相对 Markdown 路径,交付报告明确提示手动上传到公众号。picgo 时,组合封面和正文图片均已上传,文章只引用通过可访问性检查的 HTTPS 图片地址;上传失败时已明确列出待完成项和恢复命令。段落围绕完整意思组织,并兼顾公众号移动端阅读。信息过密、关系混杂时拆分,连续碎片表达同一件事时合并;不按照固定行数切段,也不为了变化句长强行拆句或合句。一句话可以自成一段,但只在确实需要强调时使用。
谨慎使用加粗,仅用于关键观点表达或关键信息。预设读者仅通过标题和加粗的文字,也能理解全篇内容。
文档只保留一个 # 文章主标题,用于记录公众号题目。正文所有章节标题统一使用 ###,不使用 ##、#### 或更深层级,以适配公众号原生标题大小。
技术内容的深度把控:
参考 references/行文风格指南.md(少数派创作手册风格指南),作为行文排版和标点符号的权威参考。
篇幅遵循文章类型路由。新闻和软件更新简报推荐 1500-3000 字,其他类型通常推荐 4000-8000 字;结构完整、逻辑连贯优先,不硬凑字数。
避免使用以下写作方式:
markdown 格式的表格,因为不适宜在移动端展示。除非是小于三列,且每列中的文字极少。
高频套话:检查「首先...其次...最后」「综上所述」「值得注意的是」「不难发现」「让我们来看看」「接下来让我们」等表达是否承担独立信息或真实的顺序、总结、转折功能。只作空泛铺垫或重复时删除;承担明确作用且符合当前文体时保留。
工具名称精度:材料明确指向具体产品或模型时,使用其准确名称,例如 Claude Code、Codex 或 Seedance 2.0。讨论工具类别,或材料没有说明具体名称时,可以使用「AI 工具」「某个模型」等概括表达;不得为了显得具体而猜测或补造产品名。
空泛教科书开头:「在当今 AI 快速发展的时代」「随着技术的不断进步」等背景没有独立信息时直接进入主题;如果时间背景、趋势变化或因果关系本身属于事实材料,则应保留。开头方式必须遵循文章类型路由:新闻和软件更新简报直接说明日期、版本或信息范围,并紧接更新概览;技术解析和教程可以从明确问题、技术现象或待解释概念进入;其他类型根据需要从真实任务、问题、体验、事件或观察切入。
默认根据文章内容自然收束,不自动追加账号名称、产品推广、优惠信息、关注引导或固定 CTA。只有作者在本次任务中明确提供,或外部作者画像明确要求时才添加;涉及价格、优惠、上线状态和链接时仍需事实核查。
题图与插图默认交付实际静态图片;只有图片生成能力不可用或作者明确只要提示词时,才退化为 prompt 交付。
公众号封面固定使用 guizang-social-card-skill,直接生成一张 3.35:1 组合封面。左侧主封面区与右侧方形分享区分别设计,最终只交付一张封面 PNG。正文解释性插图由作者在 Step 1 选择 guizang-social-card-skill 或 guizang-material-illustration。两个 Skill 都适合解释复杂逻辑和概念,区别在视觉语言与成品形态,具体选择规则见 references/视觉路由.md。
真实截图、照片、原始图表和操作结果优先作为视觉证据。所有图片中的新增文字使用中文;同一组生成插图保持统一风格和配色。正文图片不再强制使用 4:3,按归藏 Skill 的推荐比例和素材原始比例确定。
生成的文档保存在 Step 1 已确认的输出目录中。
视觉素材保存在 <输出目录>/article-assets/<文章标识>/。目录规范见 references/视觉路由.md。
文档开头使用以下 front matter 格式(日期字段按实际创建日期填写):
---
id:
created: YYYY-MM-DD
weekId: YYYY-ww
published:
status: draft
tags:
- <作者确认的标签>
---
以下清单在 Step 8 由 subagent 独立执行,不可自评。
逐条核实以下交付规则,任何一条未通过都必须修改后再提交:
# 文章主标题;正文章节标题统一使用 ###,没有 ##、#### 或更深层级local 模式使用相对 Markdown 图片路径,并提示作者在公众号编辑器中手动上传picgo 模式的图片已上传并通过 HTTPS 可访问性检查;上传失败时保留本地引用并标记为待完成SOURCES.mdHKR 质检:
新闻和软件更新简报以 K 为主要指标。R 偏低不构成失败,不得为了提高 R 编造个人经历或强行抒情。
这一层不是作者身份检测,也不保证通过任何 AI 检测器。以读者视角通读全文,判断表达是否符合当前文章类型。叙事、体验和实践类文章回答以下问题:
「作者是否在用材料支持自己的观察、选择和判断,还是只在排列正确但空泛的信息?」
新闻和软件更新简报检查「是否像一位克制的编辑在提供准确、清楚、可快速扫读的信息」;技术解析检查「是否清楚说明现象、机制和边界」。两者都不要求个人故事和情绪共鸣。
如果答案偏向后者,重点检查:
自检结果以如下格式输出,附在文章末尾(不计入正文字数):
---自检报告---
📏 交付规则:✅ 全部通过 / ❌ 未通过项:[列出]
🎨 风格一致性:✅ 全部通过 / ⚠️ 需注意项:[列出]
📊 HKR 评分:H ★★★☆☆ / K ★★★★☆ / R ★★★☆☆
- H:[一句话说明趣味性/悬念感]
- K:[一句话说明信息增量]
- R:[一句话说明情绪共鸣点]
👤 自然表达终审:✅ 通过 / ❌ 未通过
- [一句话总评,说明表达是否符合当前文章类型,是否仍有空泛或模板化问题]
📝 字数统计:[正文字数]
🖼️ 配图清单:公众号组合封面 ×1 / 正文插图 ×[N] / 真实素材 ×[N]
图片发布方式:[local / picgo]
图片发布状态:[本地交付,需手动上传 / PicGo 已上传 ×N / PicGo 待上传 ×N]
📁 视觉输出目录:[绝对路径]
🎨 正文插图风格:[guizang-social-card-skill / guizang-material-illustration]
修改建议(如有):
1. ...
2. ...