Claude Code × 文章目录设计 Skill

文章目录设计 Skill可以作为独立任务在 Claude Code 中使用。具体适配方式、资料交接和需要人工确认的环节见下方说明。

Claude Code 适合把目录规则沉淀到长期维护的内容项目。它可以读取 CLAUDE.md、内容模型、MDX 管线和共享组件，提取稳定的 ID 转写、旧链接兼容与目录层级规则，再用项目已有 Hooks、测试或构建持续检查。

多人维护的博客和文档站容易出现几套标题写法与 ID 规则。Claude Code 可以比较内容模型、生成器和共享组件，把稳定规则写进项目说明，让新增文章沿用同一套目录范围、去重方式和检查命令。

1. 01

   确认目录范围与标题层级

   读取项目说明、内容模型和代表文章，确定各页面族展示 H2 或关键 H3，并保留必要例外。

2. 02

   建立标题、ID 与锚点对照

   梳理 MDX 管线、slugify、手写 ID 与旧链接，提取可复用的转写、去重和兼容规则。

3. 03

   选择展示位置和多端交互

   把正文前、侧栏、折叠与当前章节提示分别绑定到页面族，稳定规则进入项目说明或组件文档。

4. 04

   检查跳转、访问与旧链接

   运行已有 Hooks、测试或构建，抽查代表 HTML；需要页面预览的键盘、手机和滚动状态继续单独确认。

把 Skill 放入项目技能目录，同时提供 CLAUDE.md、内容模型、MDX 管线、目录组件、旧链接和检查命令。

抽查博客、帮助文档与专题指南，确认共享规则、页面例外和最终 HTML 一致。

文章是否需要目录，应根据章节数量和读者查找任务判断，不能套用固定字数或标题长度。目录上线后，再用真实页面数据观察阅读、点击和搜索表现；语义化目录也不保证获得特定搜索结果样式。目录文字、标题层级、旧锚点与多端显示仍需对照实际页面逐项确认。

请帮我把「文章目录设计 Skill」安装到 Claude Code。
1. 下载完整 Skill ZIP：https://www.vibemarketing.work/packages/skill-table-of-contents/1.0.0/skill-table-of-contents.zip
   注意：网页 HTML 不能当作 Skill 文件安装，必须使用 ZIP 里的完整文件。
2. 解压后保留 SKILL.md 及全部配套文件，按 Claude Code 的方式安装：mkdir -p ~/.claude/skills && cp -R ./skill-table-of-contents ~/.claude/skills/
3. 安装完成后告诉我实际安装目录。
4. 用一个只读小任务验证：在项目里提一个只读任务并点名 Skill，确认它按 SKILL.md 的步骤复述计划。
5. 如果你没有联网、下载或写目录权限，请直接告诉我哪几步需要我手工完成。
参考：原始 SKILL.md https://www.vibemarketing.work/raw/skill-table-of-contents/SKILL.md；安装指南 https://www.vibemarketing.work/agent-install/skill-table-of-contents.md

mkdir -p ~/.claude/skills && cp -R ./skill-table-of-contents ~/.claude/skills/