别光看不练：动手写出你的第一个 Skill 骨架（4/7）

实操课：用 md-to-wechat-format 走完”frontmatter + 正文骨架 + 第一条 Gotcha”全流程

这节课不一样

前三课讲的是原理，这节课开始动手实操。我们尝试为 md-to-wechat-format （md格式内容转微信公众号文章）这个 skill 写出第一版骨架。规则是：每一步先给框架，先自己写，写完再看参考答案。这个”先写后对”的动作就是检索练习（retrieval practice），比直接抄答案的记忆强度高得多。

任务 1：写 frontmatter

骨架的第一块是 frontmatter。要求只有两条：

• name：1-64 字符，小写+连字符，必须和目录名一致
• description：用第 2 课的三个要点公式——能力清单 + 触发场景 + 用户关键词

先自己写一条 description（写在纸上或心里），写完再点下面这道题对照：

任务 2：搭正文骨架

frontmatter 之后是正文。用第 3 课的推荐骨架，先搭空架子，内容后填：

---
name: md-to-wechat-format
description: 把 Markdown 文章转换为可直接粘贴到公众号的富文本，
  保留代码块、表格和标题样式。当用户想把文章发布到公众号、
  提到公众号排版，或要求把 Markdown 转为公众号格式时使用。
---

# Markdown 转公众号排版

## 流程
1. 读取用户的 Markdown 源文件
2. 按 references/wechat-rules.md 的规则逐段转换
3. 输出前对照"快速参考表"自检

## 不要做的事
- （留待填写）

## Gotchas
- （留待填写——这是本课的重点）

## 快速参考表
- （转换规则稳定后再沉淀到这）

注意一个细节：第 2 步里没有把转换规则直接写在正文，而是指向了 references/wechat-rules.md——虽然这个文件现在还不存在。先把指针立起来，细节后填，这就是”正文是路由器”的肌肉记忆。

任务 3：挖第一条 Gotcha（本课核心）

骨架里最值钱的不是流程，是 Gotchas。回忆第 3 课的判断标准：“这条不写，模型默认行为会错吗？”

公众号排版场景里，模型默认会犯的错至少有这些（每个都是现成的 Gotcha）：

• 公众号编辑器不支持 Markdown 代码块的语法高亮样式，直接粘贴会丢格式——模型默认以为渲染好的 HTML 粘过去就完事
• 公众号正文里不能放可点击外链（除图文消息底部”阅读原文”）——模型默认会保留 [文字](url) 的超链接形态
• 表格在公众号里会严重变形，常见解法是转图片或转段落——模型默认会原样输出 HTML 表格

任务 4（课后作业）：让它能跑

到这里骨架就完成了。下一课我们会做两件事：把 references/wechat-rules.md 真正写出来（第三层填充），以及在真实场景里跑一次、根据翻车情况补 Gotchas——skill 的 Gotchas 大多是跑出来的，而不是想出来的。

大伙如果想提前动手，现在就可以在 skills 目录下建 md-to-wechat-format/，把今天的 frontmatter 和骨架落进去。下节课直接在真骨架上继续。

检验一下