AgentSkillsCN

wechat-tech-article

制定微信公众号技术文章的结构化写作流程。适用场景：用户需撰写公众号文章、创建文章目录、整理素材、反复迭代草稿。务必严格遵循 blogs/wechat/README.md 的命名规范与目录结构。

SKILL.md
--- frontmatter
name: wechat-tech-article
description: 撰写微信公众号技术文章的结构化工作流。使用场景：用户要写一篇公众号文章、需要创建文章目录、组织素材、迭代草稿。强制遵循 blogs/wechat/README.md 的命名规范和目录结构。

WeChat Tech Article

Overview

结构化地完成一篇微信公众号技术文章，从选题到定稿。遵循 blogs/wechat 的规范与既有文章风格。

Hard Gates (必须满足)

  1. •风格来源（强制）：写作前必须读取：
    • •blogs/wechat/README.md（目录/命名/发布节奏）
    • •skills/wechat-tech-article/references/style-guide.md（你的固定文风与结构套路）
  2. •目录命名：posts/YYYY/YYYY-MM-DD-<kebab-case-english-slug>/
  3. •文件命名：目录名与 .md 文件名完全一致
  4. •Slug 规则：只用英文（不用拼音）、用 - 分隔、尽量简短
  5. •引用路径：文章内引用本地文件使用相对路径 ./
  6. •结构硬门槛（强制）：
    • •第一行必须是 # 标题
    • •标题后 10-15 行内必须出现：入口链接（GitHub/下载/在线体验其一）+ 一句加粗 **tagline**
    • •文章正文只用 # / ## 标题（禁止使用 ### 及更深层级）
  7. •可复现优先（强制）：至少 2 个可复制代码块（bash/yaml/toml/json 任选），并配解释

Workflow (四阶段)

阶段 1: 选题与定位 (Topic & Positioning)

输入：用户给出的主题/想法

执行：

  1. •问清楚：
    • •这篇文章解决读者的什么问题？
    • •目标读者是谁？（开发者、DevOps、技术管理者？）
    • •你的独特视角是什么？（别人没写过的、你自己的经验）
  2. •根据主题生成 3 个候选 slug，让用户选择
  3. •选择文章模式（只影响内容组织，不影响你的“排版签名”）：
    • •模式 A：开源项目/工具发布（公众号型：钩子强、入口早给、可复现步骤多）
    • •模式 B：技术科普/架构深挖（技术博客型：层级清晰、定义问题、拆解机制）
  4. •创建文章目录和 .md 文件骨架
  5. •生成标题候选（见下方「标题工坊」），用户拍板后再进入大纲阶段

输出：

code
posts/YYYY/YYYY-MM-DD-<slug>/
└── YYYY-MM-DD-<slug>.md  # 含基础骨架

骨架模板：

markdown
# [标题：一句话说明价值]

> [副标题：情景化描述/问题引入]

# 前言

[为什么写这篇、谁应该读]

# [核心章节 1]

## [小节 1]

## [小节 2]

## [小节 N]

# [核心章节 2]

# [核心章节 N]

# 结语

[总结 + 行动建议]

---

标题工坊 (爆款但不虚)

目标：生成“像你写的”标题：强钩子、直击场景、可落地；避免夸大其词。

强制要求（标题 hard gate）：

  • •不能承诺无法证明的收益（例如“效率暴涨 10 倍”除非你有基准/数据）
  • •标题至少包含以下两项：对象/工具 + 场景/痛点 + 收益/结果 + 悬念（任取其二以上）

生成规则（按你常用钩子风格优先）：

  • •反问/反差：例如“不会吧？你还在……？”
  • •“我做了/我开源了……”：适合模式 A
  • •迁移/替换：例如“这个开源插件帮助我从 A 迁移到 B”
  • •顺手/工作流：例如“我把 X 做成了一个顺手的 CLI”

输出格式：

  • •生成 8 个标题候选，按类型分组（痛点/数字/结果/悬念/清单/反常识任选）
  • •每个标题附 1 行备注：适合读者 + 主打收益点
  • •给出 Top 2 推荐 + 推荐理由（具体性/可信度/读者匹配）

阶段 2: 大纲与素材 (Outline & Research)

执行：

  1. •细化大纲（每章节 3-5 个要点）
  2. •标记需要研究的内容（数据、引用、案例），并优先近期信息（当月/当季）；过期资料必须标注“可能过时”
  3. •并行收集信息来源（官方文档 / 权威博客 / 社区讨论），避免单一来源偏差
  4. •标记需要准备的素材（代码片段、截图、示意图）
  5. •如果需要生成图片，按环境能力选择：
    • •如支持生成图片工具：生成并保存到文章目录（同级或 assets/）
    • •否则：列出“需要的图清单”并说明每张图证明什么

大纲格式：

markdown
# [章节标题]
- 要点 A
- 要点 B [需要数据支撑]
- 要点 C [需要代码示例]
- [可能需要示意图]

素材清单（同目录下创建）：

code
posts/YYYY/YYYY-MM-DD-<slug>/
├── YYYY-MM-DD-<slug>.md
├── outline.md           # 详细大纲
├── research.md          # 研究素材
└── assets/              # 图片等资源（可选；也可直接同级放置）

阶段 3: 逐节写作 (Section-by-Section Writing)

原则：

  • •一次只写一个章节
  • •写完一节后暂停，等待用户反馈
  • •用户确认后再写下一节

写作检查点（每节完成后自问）：

  • • 是否有具体例子/代码/数据支撑？
  • • 是否避免了空洞的套话？
  • • 是否符合用户的写作风格？
  • • 引用本地资源是否使用了相对路径？

Hook 优化（开头段特别关注）：

  • •用数据/故事/问题开头，不要用"今天我们来聊聊 X"
  • •前三句决定读者是否继续

阶段 4: 定稿与发布准备 (Finalization)

检查清单：

  • • 标题：是否一眼明白价值？
  • • 副标题：是否引起好奇？
  • • 长度：公众号建议 2000-4000 字
  • • 配图：是否有封面图？
  • • 代码块：是否语法高亮正确？
  • • 链接：是否都可点击？
  • • 排版签名：短段落（3-4 行）、加粗关键词、代码块前后留白

发布建议（基于 README.md）：

  • •时区：北京时间（CST / Asia/Shanghai）
  • •公众号：周二 21:30；备选周三/周四 21:30；加餐（可选）周日 21:00（长文长尾）
  • •朋友圈导流：推文发布后 10–20 分钟

输出：

code
✅ 文章定稿：posts/YYYY/YYYY-MM-DD-<slug>/YYYY-MM-DD-<slug>.md
📊 字数统计：[N] 字
📅 建议发布：[日期 时间]

禁止事项

  • •禁止：一口气写完全文再给用户看
  • •禁止：使用拼音做 slug
  • •禁止：使用绝对路径引用本地文件
  • •禁止：跳过大纲阶段直接写正文
  • •禁止：使用"今天我们来聊聊"等套话开头
  • •禁止：把图片当装饰（每张图出现前后必须解释它展示/证明什么）

风格指南

默认强制遵循：skills/wechat-tech-article/references/style-guide.md。

以下为“速记版”风格指纹（帮助快速自检，不取代原文）：

  • •开门见山：前言直接说"我遇到了什么问题 → 如何解决"
  • •结构清晰：多用小标题、列表、表格
  • •代码配文字：代码块后必须有解释
  • •观点鲜明：不怕说"这样不好"、"我认为"
  • •结尾行动化：给读者 1-2-3 步可执行建议

模板与长文规范

如需可复制模板（模式 A/模式 B），优先参考：skills/wechat-tech-article/references/style-guide.md。

如需“快速开写”的精简可复制模板：skills/wechat-tech-article/references/templates.md。

如需“风格速查表”（默认强制风格的浓缩版）：skills/wechat-tech-article/references/style-cheatsheet.md。