EPUB 文档测试助手
用于测试 EPUB 黄金构建并检索示例文档中的概念、API 与故障排查信息。
该技能仅提供EPUB文档索引、代码片段、表格和引用文件,没有明显恶意、凭据窃取或破坏性操作;但未说明数据流、敏感数据处理、用户确认、隔离或回滚机制,且作者与出版者信息(Jane Doe、Acme Press)无法由材料验证,因此扣分。
SKILL.md与references文件在章节、代码块、表格和统计信息上大体一致,并有仓库级测试与CI信号;但内容含截断的长代码示例,未给出异常输入、失败反馈或可复现测试路径,且静态审查不能证明实际可运行,因此扣分。
触发条件“testing the epub golden build”较明确,适合该特定测试场景;但未声明输入输出、非适用范围、环境要求或语义触发边界,内容仅英文,也没有中国大陆网络可达性或中文使用说明,因此扣分。
文档有前置元数据、章节概览、快速参考、示例、统计和引用导航;仓库上下文提供MIT许可证、版本和测试配置,但该技能自身缺少安装依赖、版本变更、维护责任、更新路径和故障排查说明,因此扣分。
该技能可作为一个小型EPUB黄金样本文档参考,且引用文件可直接阅读;但它不执行转换任务,示例偏玩具化,长示例被截断,API和故障排查内容不完整,实际增益与直接阅读文件相比有限,因此扣分。
材料包含提交固定的源文件、引用文件以及仓库级测试和CI配置,提供有限审计线索;但没有针对该技能关键路径的明确测试结果、第三方执行证据或跨来源 corroboration,结论仍主要依赖静态文件,因此扣分。
- 不要将该SKILL.md视为可执行的EPUB转换器;它更像黄金测试夹具和生成文档。
- 截断的长Python示例、玩具化安装命令和空泛的API说明可能导致误用;使用前应核对原始EPUB和完整引用内容。
- 未提供敏感数据、外部网络访问、失败恢复或回滚说明;处理真实文档时应先确认输入范围和输出位置。
- 仅有英文内容,未证明中文语境或中国大陆网络环境下的适用性。
它能做什么 & 适用场景
这是一个用于测试 EPUB 黄金构建的文档技能。它描述了《The Handbook》的基本信息、章节结构、主要主题、代码示例、表格和文档统计数据。内容覆盖入门指南、API 使用和常见错误。技能还提供指向 handbook 参考文件及完整导航索引的路径。
提供《The Handbook》的书目信息,包括作者、语言、出版社和日期;列出 3 个章节及其主题;汇总入门、API 使用和故障排查内容;展示 Bash 与 Python 示例;记录表格、代码块、图片和编程语言统计;指向 references/handbook.md 与 references/index.md。
- 需要测试 EPUB 文档转换或黄金构建流程的开发者,可用它检查生成文档的结构和元数据。
- 需要查找《The Handbook》入门、API 使用或故障排查内容的用户,可用它进行快速定位。
- 需要参考 Python 或 Bash 示例的工程师,可用它查看文档中提取的代码片段。
- 需要验证 EPUB 抽取结果是否包含章节、表格、图片和代码统计的测试人员,可用它核对摘要信息。
优缺点一览
- 范围明确,专门面向 EPUB 黄金构建测试。
- 提供章节、主题、代码块、表格和文档统计等结构化摘要。
- 包含 Python 与 Bash 示例,并给出示例质量评分。
- 提供参考文件和导航索引路径。
- 源材料没有说明实际 EPUB 输入、构建命令或测试断言。
- 仅覆盖一个名为《The Handbook》的示例文档。
- 较长的 Python 示例被截断,无法作为完整实现直接使用。
- 没有提供独立的安装目录或运行时依赖说明。
如何安装
将仓库中的 tests/golden/phase2/epub/SKILL.md 作为技能文件使用。源材料未说明单独的安装命令或目标目录。
如何使用
在技能可访问的环境中请求测试 EPUB 黄金构建,或查询《The Handbook》的章节、API 示例和故障排查内容。需要更完整的结构时,查看 references/index.md;需要 handbook 参考内容时,查看 references/handbook.md。