# 网站可抓取性优化 Skill 安装指南

> 面向 AI Agent 的机器可读安装说明。HTML 页面不能直接当作 Skill 文件安装。

- 技能包：https://www.vibemarketing.work/packages/skill-crawlability/1.0.0/skill-crawlability.zip
- 原始 SKILL.md：https://www.vibemarketing.work/raw/skill-crawlability/SKILL.md
- 校验：https://www.vibemarketing.work/packages/skill-crawlability/1.0.0/SHA256SUMS
- 版本：1.0.0｜许可证：MIT｜上游：https://github.com/kostja94/marketing-skills/blob/ac823a127782355339f21aef6c87f1ccff751c84/skills/seo/technical/crawlability/SKILL.md

## 通用步骤

1. 下载完整 ZIP 并解压，保留 SKILL.md 及全部配套文件。
2. 按下面对应 Agent 的方式放入其技能目录。
3. 安装完成后报告实际安装目录。
4. 用一个只读小任务验证 Skill 已被识别。
5. 若缺少联网、下载或写目录权限，直接告知用户需要手工完成的步骤。

## 各 Agent 安装方式

### WorkBuddy

```text
技能 → 添加技能 → 上传技能 → 选择本地技能包
```

验证：在“已安装”中搜索 Skill 名称，启用后用一个只读样本任务检查是否被正确调用。

### OpenClaw

```text
openclaw skills install ./skill-crawlability --as site-crawlability
```

验证：运行 openclaw skills list 确认技能已注册，再用一条只读样本命令检查调用。

### Hermes Agent

```text
mkdir -p ~/.hermes/skills && cp -R ./skill-crawlability ~/.hermes/skills/
```

验证：在消息入口里发一条只读任务，确认 Hermes 报出 Skill 名称与将要执行的步骤。

### Codex

```text
mkdir -p ~/.agents/skills && cp -R ./skill-crawlability ~/.agents/skills/
```

验证：让 Codex 列出可用 Skill 并复述本次要执行的步骤，再跑一个只读小任务。

### Claude Code

```text
mkdir -p ~/.claude/skills && cp -R ./skill-crawlability ~/.claude/skills/
```

验证：在项目里提一个只读任务并点名 Skill，确认它按 SKILL.md 的步骤复述计划。

### TRAE

```text
在 Skills 设置中导入包含 SKILL.md 的 skill-crawlability 目录；项目级 Skill 可放入 .agents/skills/skill-crawlability
```

验证：在 Skills 设置里确认已启用，再让它对一个页面或一份材料做只读检查。

### ZCode

```text
mkdir -p ~/.zcode/skills && cp -R ./skill-crawlability ~/.zcode/skills/
```

验证：在设置页确认技能已启用，对话中输入 $ 选择技能，再跑一个只读小任务。

## 这个 Skill 做什么

检查重定向链、失效链接、孤儿页、点击深度、分页和初始 HTML，交付抓取问题表、页面关系表、修复顺序与复查记录。

需要准备：全量 URL、XML Sitemap、内部链接导出，以及重点栏目和页面类型；代表 URL 的 HTTP 状态、重定向链、robots、X-Robots-Tag 与 canonical 信息；网站框架、路由、服务器或 CDN 配置，以及页面模板和栏目层级；分页、无限滚动、点击加载、瀑布流与懒加载的实现说明和代表页面；页面源 HTML、渲染后 HTML，以及 Search Console 中的抓取或索引问题记录

最终交付：抓取问题表：URL、页面类型、状态码、重定向链、入口、点击深度与主要问题；重定向与失效链接清单：来源页、中间地址、最终地址、4xx 与建议处理方式；孤儿页和过深页面清单，以及可补充入口的栏目、导航或相关页面；分页与无限滚动改造说明：组件页、稳定 URL、普通链接、越界响应和历史记录行为；初始 HTML 与 AI 抓取检查表，以及按问题类型、涉及页面和维护位置整理的修复任务
