Web 手册文档技能
从结构化的 Web 手册中快速查找概念、API、示例与故障排查信息。
该技能仅提供HTML文档摘要、代码片段、表格和参考文件,没有明显恶意行为、凭据窃取或破坏性操作;但未说明数据来源、网络访问、隐私处理、用户确认、隔离或回滚机制,因此扣分。
文件结构基本一致,SKILL.md链接到references/index.md和page.md,统计信息与内容大致对应;但技能没有执行说明、异常输入处理或诊断性错误反馈,且Python示例被截断为“x3 ...”,关键路径无法静态复现,因此扣分。
用途仅写明用于测试HTML golden build,触发条件和输入输出边界较模糊,也没有非适用场景;内容只有英文,未证明对中文用户或中国大陆网络环境有适配,因此扣分。
具备名称、描述、章节概览、快速参考、引用目录和统计信息,仓库上下文提供MIT许可证、版本和维护入口;但该技能自身缺少安装依赖、版本变更、维护责任、故障排查和有效FAQ,且Changelog为空,因此扣分。
它能作为一个HTML抓取结果的静态摘要和导航,但不是可直接执行或操作的完整技能;代码示例不完整,API、故障排查和变更内容几乎没有实质信息,用户仍需大量人工补充,因此扣分。
文档标注了来源文件、章节、统计数据、作者及部分外部链接,提供了一定审计线索;但没有固定源站证据、生成过程证明或针对该技能关键路径的专门测试,静态审查也无法验证结果,因此扣分。
- 这是静态文件审查,未执行技能或测试;不要将摘要、统计数字或代码质量评分视为已验证事实。
- 选定技能看起来是测试用生成物,不应依据仓库整体README的广泛功能宣称推断该技能具备这些能力。
- 使用前应补充真实来源、输入输出契约、依赖与网络行为、失败处理,以及完整且可运行的示例。
它能做什么 & 适用场景
这是 Skill Seekers 仓库中的一个 HTML 黄金构建测试技能,内容来自名为《The Web Handbook》的英文 Web 手册。它提供 4 个文档章节,涵盖入门、API 使用、故障排查和更新日志。技能包含 Bash 与 Python 代码示例、表格摘要、文档统计和参考文件导航。它适合验证 HTML 文档抓取与技能构建结果,不是完整的 Web 开发教程。
提供《The Web Handbook》的结构化摘要,包括标题、作者、语言、描述、关键词、章节数量、主要主题和参考文件。它列出入门、API 使用、故障排查与更新日志的导航信息,并展示 1 个 Bash 示例和 2 个 Python 示例,同时汇总代码块、图片、表格、HTML 文件及编程语言统计。
- 需要验证 HTML 文档抓取器是否正确生成章节、导航和统计信息的测试人员。
- 需要查找 Web 手册中入门步骤或 API 使用章节的开发者。
- 需要查看常见错误与故障排查章节的技术读者。
- 需要检查生成技能是否保留代码示例和表格摘要的技能维护者。
优缺点一览
- 结构清晰,包含章节概览、快速参考和导航信息。
- 同时提供 Bash 与 Python 示例。
- 明确列出文档统计和内容分类,适合黄金构建验证。
- MIT 许可的 Skill Seekers 仓库持续维护整个技能集合。
- 内容仅覆盖 4 个测试文档章节,范围较小。
- Python 长示例在来源中被截断,无法完整审阅。
- 技能描述强调测试 HTML 黄金构建,未证明其适用于生产级 Web 开发。
- 来源没有提供该单个技能的独立安装、测试命令或更新记录。
如何安装
仓库 README 记录了整个 Skill Seekers 集合的安装方式:pip install skill-seekers。本技能位于 tests/golden/phase2/html/SKILL.md;来源没有记录该单个测试技能的独立安装命令或发布方式。
如何使用
将该技能目录作为 Agent Skills 技能加载后,可请求:“查找 Web 手册的 API 使用章节”或“总结 Web 手册中的故障排查内容”。如需验证构建结果,请检查 references/page.md 及 references/index.md 中的文档导航;具体测试命令未在来源中说明。