Back to Details

finding

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

finding

发现

Create and query curated findings in Crawlio's observation log. Findings are agent-created insights backed by observation evidence.
在Crawlio的观测日志中创建和查询精选发现。发现是由Agent生成的、有观测证据支持的洞察。

When to Use

使用场景

Use this skill when the user wants to:
  • Record an insight or issue discovered during analysis
  • Create an evidence-backed finding that persists across sessions
  • Review previously created findings for a site
当用户有以下需求时使用此Skill：
  • 记录分析过程中发现的洞察或问题
  • 创建跨会话持久保存的、有证据支持的发现
  • 查看某个站点之前创建的发现

Creating Findings

创建发现

Findings are the agent's judgment layer on top of raw observations. A good finding:
  1. Has a clear, descriptive title
  2. References specific observation IDs as evidence
  3. Includes a synthesis explaining the pattern or issue
发现是Agent在原始观测结果之上的判断层。优质的发现需满足：
  1. 拥有清晰、描述性的标题
  2. 引用特定的observation ID作为证据
  3. 包含对模式或问题的综合分析

Workflow

工作流程

  1. Query observations to identify patterns:
get_observations({ host: "example.com", source: "extension", limit: 50 })
  1. Identify the pattern — look for recurring issues, framework signals, error patterns, or notable behaviors.
  2. Create the finding with evidence:
create_finding({
  title: "Mixed content: HTTP images on HTTPS page",
  url: "https://example.com",
  evidence: ["obs_a3f7b2c1", "obs_b4e8c3d2"],
  synthesis: "Homepage loads 3 images over HTTP despite serving over HTTPS. Network observations show requests to http://cdn.example.com/img/ which should use HTTPS. This triggers mixed content warnings in Chrome and may cause images to be blocked in strict mode."
})
  1. 查询观测结果以识别模式：
get_observations({ host: "example.com", source: "extension", limit: 50 })
  1. 识别模式——寻找重复出现的问题、框架信号、错误模式或值得注意的行为。
  2. 创建带证据的发现：
create_finding({
  title: "Mixed content: HTTP images on HTTPS page",
  url: "https://example.com",
  evidence: ["obs_a3f7b2c1", "obs_b4e8c3d2"],
  synthesis: "Homepage loads 3 images over HTTP despite serving over HTTPS. Network observations show requests to http://cdn.example.com/img/ which should use HTTPS. This triggers mixed content warnings in Chrome and may cause images to be blocked in strict mode."
})

Parameters

参数

ParameterTypeRequiredDescription
title
stringYesShort, descriptive title
url
stringNoURL this finding relates to
evidence
[string]NoArray of observation IDs (
obs_xxx
)
synthesis
stringNoDetailed explanation
参数类型是否必填说明
title
string是简短、描述性的标题
url
string否此发现关联的URL
evidence
[string]否observation ID数组（格式为
obs_xxx
）
synthesis
string否详细说明

Finding Quality Checklist

发现质量检查清单

  • Title: Is it specific? "Mixed content on homepage" > "Issue found"
  • Evidence: Do the observation IDs actually support the claim?
  • Synthesis: Does it explain why this matters, not just what was observed?
  • URL: Is it scoped to the right page or left empty for site-wide findings?
  • 标题：是否具体？“首页存在混合内容”优于“发现问题”
  • 证据：observation ID是否真正支持所提出的结论？
  • 综合分析：是否解释了为什么这很重要，而不仅仅是观察到了什么？
  • URL：是否限定在正确的页面，或者对于站点级发现是否留空？

Querying Findings

查询发现

All Findings

所有发现

get_findings({})
get_findings({})

Findings for a Specific Host

特定主机的发现

get_findings({ host: "example.com" })
get_findings({ host: "example.com" })

Recent Findings

近期发现

get_findings({ limit: 10 })
get_findings({ limit: 10 })

Finding Categories

发现分类

When creating findings, consider these common categories:
CategoryExample Title
Performance"Render-blocking scripts delay FCP by 2.3s"
Security"Mixed content: HTTP resources on HTTPS page"
SEO"Missing meta descriptions on 12 pages"
Framework"Next.js App Router with ISR detected"
Errors"3 JavaScript errors on product pages"
Structure"Orphaned pages not linked from navigation"
Accessibility"Missing alt attributes on hero images"
创建发现时，请考虑以下常见分类：
分类示例标题
性能"阻塞渲染的脚本使FCP延迟2.3秒"
安全"混合内容：HTTPS页面加载HTTP资源"
SEO"12个页面缺少元描述"
框架"检测到使用ISR的Next.js App Router"
错误"产品页面存在3个JavaScript错误"
结构"存在未从导航栏链接的孤立页面"
可访问性"主图缺少alt属性"

Tips

提示

  • Create findings as you analyze, not all at the end — they persist across sessions
  • Reference multiple observation IDs when a finding draws from several data points
  • Use synthesis to explain the impact, not just restate the observation
  • Findings with evidence chains are much more useful than findings without
  • 在分析过程中逐步创建发现，而不是全部留到最后——这些发现会跨会话持久保存
  • 当发现基于多个数据点时，请引用多个observation ID
  • 在综合分析中解释影响，而不仅仅是重述观测结果
  • 带有证据链的发现比没有证据链的发现有用得多