md2wechat 技能：Markdown 到微信公众号排版发布助手
将 Markdown 一键排版并发布到微信公众号，支持 40+ 排版样式、AI 配图、批量发布与多账号管理。
证据显示：SKILL.md 明确要求对上传、草稿、发布等副作用进行显式用户请求，并使用 inspect 的 readiness 检查作为发布门禁；config wechat-accounts 声明为本地只读且不输出 WeChat secrets；Brand Profile 的创建或编辑需用户明确要求。但是，依赖外部 API 服务（MD2WECHAT_API_KEY）和图片 provider，这些服务的可获得性、数据流向和隐私政策未在本次静态审查中披露；许可证为 Source Available（基于 BUSL-1.1），并非标准开源许可，商业使用限制较强，且发布者未经验证。由于未执行代码，无法确认是否存在隐蔽的凭据处理或数据传输；这些不确定性使信任评分较低。扣分原因：外部服务依赖和未验证的执行行为。
证据显示：SKILL.md 提供了详细的工作流、发现命令、失败处理路径（如 doctor config show、layout validate）和预期输出（如 PREVIEW_ACTION_REQUIRED）。但是，没有看到测试套件或 CI 覆盖该技能的关键路径；go.mod 和 CI 工作流仅显示构建和代码质量检查，并未展示针对命令行为的测试。因此，快乐路径可能可行，但错误处理和边缘情况的反馈不足。静态审查不能执行，可靠性上限为 10，故评分较低。扣分原因：无测试证据，错误处理覆盖有限。
证据显示：技能定位于微信公众号排版发布，目标用户为中文用户，且 README 提供了中文文档和示例，适配中国大陆环境（尽管核心可能依赖境外 API）。SKILL.md 明确规定了触发条件（如 detect markdown to WeChat formatting）和边界（如不做未请求的发布）。但，技能依赖外部 API 和图片 provider，这些服务可能在中国大陆不可达，且未提供离线替代方案。边界和触发条件虽清晰，但环境适配证据有限，因此评分中等偏低。扣分原因：核心功能依赖海外服务，环境适配证据不充分。
证据显示：SKILL.md 结构清晰，有分区（意图路由、发现、配置边界等），README 提供安装指南和文档链接，许可证和版本信息明确（package.json 版本 3.2.0，有 CHANGELOG 引用）。但是，许可证为 Source Available，商业使用受限，可能影响用户；发布者未经验证，维护责任和更新路径仅由 README 声称。已知限制在文档中提及，但 SKILL.md 自身未提供版本历史或变更日志。扣分原因：许可证非标准开源，维护责任信息不完整。
证据显示：技能声称能完成 Markdown 到微信 HTML 的转换、草稿创建、图片生成等，并提供了详细的命令行流程。但未提供验证过的输出示例或对比优势数据，核心价值（如 40+ 样式）未能在静态审查中验证。输出是否直接可用未经测试，边际价值相对于手动操作或替代方案不明确。静态审查不能执行，有效性上限为 7，故评分较低。扣分原因：无验证输出，比较优势证据不足。
证据显示：仓库有 CI 工作流和 go.mod，但质量门未包含针对该技能关键路径的测试；README 中的演示动图（readme-header.gif）是图片证据，但未执行。没有第三方测试报告或独立验证。静态审查无法独立复现，验证上限为 5，故评分较低。扣分原因：无审计证据，测试覆盖不足。
- 该技能依赖外部 API 服务和图片 provider，这些服务的可用性、数据流向和隐私政策未在本次审查中披露。在使用前，请核实其是否在中国大陆可访问，并了解其数据隐私条款。
- 许可证为 Source Available（基于 BUSL-1.1），商业使用受限。如果您的使用场景涉及商业目的，请先获得作者授权。
- 发布者未经验证，请谨慎对待其维护承诺。建议自行检查仓库的活跃度和安全记录。
- 静态审查未发现测试证据，关键路径的可靠性未经验证。建议在真实环境中先进行小范围试运行，并观察错误反馈。
这个 Skill 能做什么，适合哪些场景？
md2wechat 是一个面向 AI Agent 的微信公众号创作与发布 CLI 技能。它提供一系列可验证的命令，用于将 Markdown 文章转换为微信 HTML、检查发布就绪状态、生成封面和配图、创建草稿以及管理多个公众号账号。技能强调先发现后执行（discovery-first）的工作流，建议 Agent 依赖 CLI 提供的 JSON 输出作为事实来源，而不是猜测。它区分了免费 AI 模式与专业 API 模式，后者支持更多主题和高级排版模块。
该技能将 Markdown 文章转换为微信公众号文章 HTML（convert），并支持本地预览（preview）和可选的草稿创建（--draft）与图片上传（--upload）。它通过 inspect --json 输出结构化的元数据、就绪状态和阻塞项，并推荐在发布前检查。它支持使用 generate_cover 和 generate_infographic 生成封面和文章信息图，也支持通过 write 和 humanize 命令进行写作及 AI 痕迹去除。此外，title suggest 命令可生成标题建议提示，而 advise 命令可推荐文章改进方向。该技能还提供 themes、layout、providers、prompts 的发现命令（list/show），用于获取主题、布局模块、提供商和提示词的具体信息。
- 内容创作者需要将 Markdown 草稿快速排版为微信公众号文章，并创建草稿以便后续发布。
- 企业团队需要批量生成多篇公众号文章，并希望输出风格一致、排版专业，此时可使用专业 API 模式。
- 运行 AI Agent（如 Claude Code、Codex）的用户，希望通过 CLI 命令而非手工上传来自动化公众号发布流程。
- 需要为每篇文章生成封面图或信息图的公众号运营者，可使用 generate_cover 或 generate_infographic 配合图片提供商或宿主 Agent 的图像生成能力。
- 希望去除 AI 痕迹、让文章更自然的写作者，可对已有文章使用 humanize 命令。
- 管理多个公众号账号的运营者，可通过 config wechat-accounts 查看本地账号配置，并在发布时指定目标账号。
这个 Skill 有哪些优点和局限？
- 提供丰富的命令集，覆盖从格式检查、转换、预览到发布的所有关键步骤
- 支持多种 AI Agent 环境，通过 JSON discovery 输出实现可机读接口
- 专业 API 模式支持更多主题和高级排版模块，输出确定性高，适合团队和矩阵号
- 包含 doctor 命令用于本地配置体检，以及 config show 用于查看当前配置
- 支持多账号管理，且不会输出微信 Secret，注重安全
- 活跃维护，有明确的文档索引，且支持通过 skills read 命令读取内置 SOP
- 免费 AI 模式仅提供 3 个基础主题，且不支持高级排版模块，输出一致性依赖外部 LLM
- 草稿创建、图片上传等微信副作用操作需要配置微信凭证，可能需要额外申请 API 服务
- API 模式需要 MD2WECHAT_API_KEY，商业使用需获得授权，项目采用 Source Available License，非纯开源
- 部分功能（如 generate_image 直接调用）需要图片提供商凭证，未配置时只能使用计划模式
- 技能不包含自带测试套件，但提供了 doctor 命令用于本地检查
- 文档中标注了一些计数（如 68、53）但未明确说明来源，可能存在统计口径差异
如何安装这个 Skill？
通过 npm 全局安装：npm install -g @geekjourneyx/md2wechat。然后运行 md2wechat config init 进行初始化。该技能要求 Go 1.26.1+ 环境。完整安装指南见仓库 docs/INSTALL.md。
如何使用这个 Skill？
安装后，确保 md2wechat 在 PATH 中。对于常见任务，可运行：
- 检查文章状态：md2wechat inspect article.md --json
- 本地预览：md2wechat preview article.md
- 转换并创建草稿：md2wechat convert article.md --draft --cover cover.jpg
- 生成封面：md2wechat generate_cover --article article.md
技能提供了详细的意图路由规则：例如，对于图片优先的文章，应使用 create_image_post 而非 convert --draft；对于封面和信息图，应优先使用 generate_cover 或 generate_infographic。在执行发布操作前，建议先运行 inspect --json 并检查 data.readiness.targets 和 blockers 来确认是否就绪。
这个 Skill 与同类方案有什么区别？
该项目在 README 中未直接提及具体竞品，但与微信编辑器等手工排版工具相比，其主要优势在于通过 CLI 实现自动化，并与 AI Agent 集成。若作为备选，可考虑其他 Markdown 转换器，但本技能专注于微信平台特有需求，如封面、草稿和账号管理。