技能介绍

解决的问题

WorkBuddy 蓝皮书是一套结构完整的「自媒体增长闭环工具链」手册，涵盖使用手册、实战案例、进阶系统、岗位落地四大篇章及附录。当读者想从手册中查找某个具体操作步骤或案例时，逐章翻阅整个站点效率很低。这个技能把蓝皮书内容封装为自包含的知识库，让 Agent 能直接按关键词定位章节并作答，无需手动启动网站或翻页。

核心能力与工作方式

技能提供两种使用路径：

问答 / 检索模式（离线可用）：先用 Grep 在 data/INDEX.md 中按关键词搜标题，命中后获取目标 slug（如 ch-17）。再用 Read 打开 data/bluebook.json，定位到对应 slug 的 contentHtml 字段提取正文。作答时注明来源章节标题。支持通过 pager.next / pager.prev 的 slug 实现「上一章 / 下一章」连续检索。
可视化浏览模式：运行 scripts/serve.sh 自动完成 Node 环境切换、构建与服务启动，通过 present_files 打开 http://localhost:3100/bluebook 供浏览器预览整站，也可直接指定章节路由。

数据层的设计是技能的核心。data/bluebook.json 的 pages 字段按 slug 索引，每页包含 outline（页内目录）、pager（前后章导航）和 contentHtml（VitePress 渲染后的 HTML 正文），覆盖代码块、表格、图片与提示框。data/INDEX.md 作为轻量索引，让检索先在标题层完成定位，避免加载全文。

适用边界

问答模式完全自包含，不依赖服务器，离线即可工作；浏览模式依赖模板仓库已执行 npm run build，scripts/serve.sh 会在缺失构建时自动补建，但需 Node 24 且需 unset NODE_OPTIONS。
contentHtml 是原站 HTML 的克隆，与原版蓝皮书内容一致，不应再用它去抓取原站内容。
阅读 HTML 正文时需忽略标签、保留文字与代码块，这一步依赖 Agent 的文本提取能力。