以智能体视角访问 https://blade-hq.github.io/public-skills/ 时遇到的问题，影响智能体自主查阅文档的能力。
首页可访问，但子页面 URL 直接打开返回 404。例如：
/public-skills/dev/app-integration → 404/public-skills/dev/agent-dev → 404/public-skills/integration/react.html → 404实际可访问的路径带有额外层级，如 /public-skills/integration/frontend/react.html，但从首页目录结构看不出来。
影响：智能体无法从首页导航猜出正确的子页面 URL，需要多次试探。
首页渲染为纯文本目录（"使用指南"、"开发文档"、"部署与运维"），但 WebFetch 抓取时链接 URL 不够显眼。智能体需要额外一次请求专门提取链接才能发现实际路径。
建议：如果有 sitemap.xml 或明确的导航 JSON，智能体可以一次性获取全部页面结构。
即使能访问到的页面（如 React 接入指南），WebFetch 返回的是摘要而非完整内容。代码示例被省略或简化，智能体拿不到完整的安装命令、import 路径、组件用法。
这个不是文档站的问题，是 WebFetch 工具的限制。但如果文档站能提供一个"单页合并版"（所有内容在一个页面），智能体一次请求就能拿全。
经过多次试探，发现的可用路径规律：
/integration/concepts.html ✅/integration/frontend/react.html ✅/integration/frontend/chat-ui.html ✅/agent-dev/concepts.html ✅/api/overview.html ✅/api/rest.html ✅/api/websocket.html ✅/guide/factory.html ✅核心问题是首页目录的链接与实际页面路径不一致，导致智能体需要 5-6 次请求才能找到正确页面。如果首页的导航链接直接指向可访问的 .html 文件，一次就够了。