第一篇攻略:玩一小时,写一篇能过质检

先看一个真实场景

你的网站壳子能跑了,但货架上摆的还是别人的示例商品,而且 Google 只把排名给「回答了玩家问题」的页面——空站是不会有流量的。好消息:这一课你不用自己写一个字。你负责玩一小时游戏、记笔记、复制提示词;AI 负责产出符合规范的页面,而且每一篇都会自动过质检。

先认识本课的三个新词,后面五课全在用:

frontmatter(登记卡):每篇文章开头两条 --- 之间的卡片,登记标题、简介、栏目。AI 自动写,你不用手写。
质检(Zod schema):网站自带检查员,登记卡格式不对,pnpm build 直接不通过并告诉你哪错。它不是找麻烦,是帮你挡废品。
draft(草稿开关):没核实的内容标 draft: true,只有你能看到;核实后再转正。

哪种搜词配哪种页(意图分类表,后面三课各领一类):

玩家搜	想干什么	你做什么页
`codes / redeem`	要兑换码	兑换码页(课 14)
`how to / 怎么`	学玩法	攻略页(本课)
`best / tier / 排名`	知道谁强	排行榜页(课 15)

第 1 步:让 AI 助手打开你的网站文件夹

打开你在第 9 课装的第 6 样装备:Cursor / ZCode 用「Open Folder」选中 AnvilWiki 文件夹;Claude Code / Codex(命令行)先 cd AnvilWiki 再输启动命令。打开后新建对话。

你会看到:AI 界面显示的路径末尾是 AnvilWiki。对它说「你现在在哪个文件夹?」核对一下。

打开之后它自动知道三件事:网站的格式规矩(AGENTS.md)、现成技能、登记卡格式——不用你教。

第 2 步:先去玩一小时游戏,记笔记

AI 写得好不好,八成取决于你的素材。素材不用工整,手机碎片记录就行:

这个 Boss 有什么机制?我死了几次,每次死因是什么?
我用什么配装/走位过的关?
兑换码从哪看到的?码是什么、给什么奖励、什么时候过期?

一小时记 20 条碎片,就够写三篇。想把素材做系统,仓库 requirements/ 有两张填空式模板(事实来源表+对标参考表),各自带一段能直接发给 AI 的调研提示词——现在先不管,笔记够用。

第 3 步:攻略页提示词(整段复制,`<>` 换成你的素材)

把下面的要点写成一篇攻略页(支持技能的工具可直接用 /anvil-new-article)。
【素材】
游戏/Boss:<名称>
要点:<口述笔记、机制观察、数值——有几分写几分>
【要求】
按 AGENTS.md 内容规范,先读 docs/content-format.md 和 src/content.config.ts。
frontmatter:title≤80 字符含游戏名;description 40–165 字符;summary 40–60 词直答;
category 用 navigation.ts 已有 key;tags 复用现有词;未验证内容加 draft: true。
正文:不写 H1;H2 问题式且首段直接回答;数据进表格;用 Callout/Accordion/StatBar 组件。
禁止编造数值——缺的数据写 [待补充] 并单独列清单问我。
写完运行 pnpm check-content && pnpm build,两者全绿才算完成;失败修复后重跑。

你会看到:AI 先读规范文件,然后写文件、跑质检,最后报「全部通过」。 确认做对了:pnpm dev 打开这篇文章,标题、表格、首段直答都在。

三个经典错误(提前替你踩)

对 AI 说「写篇好攻略」:素材是提示词的第一公民,空话进去,编造出来。
让 AI 补它不知道的数值:缺数据就让它标 [待补充] 并列清单问你——宁可空着,不许编。
发明新栏目新标签:栏目和标签只能用换皮那一课建好的那套,建新栏目是开发手册的事。

本课新词(就 3 个)

已在开头讲过:frontmatter、质检、draft。现在合上手册,你能各自用一句话说清吗?

✅ 验收(全部成立才算完成)

☐ 第一篇攻略页通过了 pnpm check-content && pnpm build(全绿)
☐ 你肉眼看过页面:标题对、表格在、首段直答
☐ AI 的「待补充清单」要么已补,要么这篇挂着 draft

下一课

攻略页会写了。下一课是全站流量最大的页面,也是最容易翻车的地方:兑换码页——一条全书最粗的红线等着你。去第 14 课 · 兑换码页