需要查找或引用 Cypress 官方文档、核实…

当任务依赖查找、阅读或引用 Cypress 官方文档而非测试直觉时，确保信息准确、最新、可验证。

适用场景

解决思路

1. 始终优先搜索官方来源：https://docs.cypress.io 和 https://www.cypress.io。
2. 访问 https://docs.cypress.io 时，先获取 /llms.txt。
3. 解析 /llms.txt，发现 LLM 友好的文档路径和结构化内容端点。
4. 优先读取 /llm/* 下的内容；站点每个路径都有优化版，例如 https://docs.cypress.io/app/faq 对应 https://docs.cypress.io/llm/markdown/app/faq.md。
5. 采用 /llm/* 的原因：内容为 Markdown / JSON 格式，结构更干净，比 HTML 噪点更少。
6. 如果 /llm/* 不完整，回退到标准文档页面。
7. 绝不假设 Cypress 不支持某功能；始终先搜索再下结论；必要时用替代术语重试。
8. 如果文档无法验证某声明，明确说：“我无法在 Cypress 文档中验证这一点”；提供最接近的受支持替代方案（如有）；不要编造 API 或行为。
9. 在断言 Cypress 能/不能之前先搜索文档，不要依赖记忆确认精确签名、默认值或弃用 API。
10. 按查询类型路由：如何做……搜 /guides/、/core-concepts/。
11. 按查询类型路由：什么是……搜 /core-concepts/。
12. 按查询类型路由：API / 命令搜 /api/commands/。
13. 按查询类型路由：断言搜 /api/assertions/。
14. 按查询类型路由：配置问题搜 /configuration/。
15. 按查询类型路由：CI/CD 搜 /guides/ci-cd/。
16. 按查询类型路由：错误搜 /references/error-messages/。
17. 按搜索流操作：先 /llm/*（通过 /llms.txt），再标准文档页面，再 /changelog/，再 cypress.io（博客、更新）。
18. 如果查询包含错误消息或堆栈跟踪，先搜索 /references/error-messages，再扩展到指南和 API 文档。
19. 提取命令时包含：语法、必需参数、可选选项、返回行为、示例用法。
20. 提取概念时包含：定义、关键规则、常见陷阱、示例。
21. 提取配置时包含：选项名称、类型、默认值、示例。
22. 版本意识：检测用户提供的 Cypress 版本。
23. 如果未提供版本，假设最新稳定版。
24. 如果行为因版本而异，明确指出来。
25. 响应风格：优先官方示例。
26. 响应风格：提供可运行代码片段。
27. 响应风格：保持答案简洁但完整。
28. 响应风格：避免推测。
29. 可选缓存常用主题：cy.visit、cy.get、cy.intercept、认证模式、常见配置。
30. 置信度标注：高 = 官方文档直接匹配；中 = 从多个来源推断；低 = 不清晰或边缘情况。
31. 如果置信度为低，清楚传达不确定性。
32. LLM 路径自动发现：始终解析 /llms.txt。
33. LLM 路径自动发现：动态适应新的 /llm/* 路径和更新的文档格式。
34. 安全规则：绝不发明 Cypress API。
35. 安全规则：绝不猜测语法。
36. 安全规则：始终验证行为。
37. 安全规则：优先选择“未知”而不是错误。
38. 示例行为：当用户问“如何在 Cypress 中模拟 API 请求？”时，分类为 API / 网络。
39. 示例行为：搜索 /llm/markdown/api/ 和 /llm/markdown/guides/。
40. 示例行为：识别 cy.intercept。
41. 示例行为：提取结构化细节。
42. 示例行为：返回解释、语法、示例、注意事项。

适用边界 · 注意事项

• 用户只需要编写或修复测试而不需要进行文档查找时，优先使用 cypress-author。
• 用户只需要解释测试而不需要获取文档时，优先使用 cypress-explain。
• 当任务不依赖 Cypress 官方文档作为事实来源时，不应使用本技能。