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:

Has a clear, descriptive title
References specific observation IDs as evidence
Includes a synthesis explaining the pattern or issue

发现是Agent在原始观测结果之上的判断层。优质的发现需满足：

拥有清晰、描述性的标题
引用特定的observation ID作为证据
包含对模式或问题的综合分析

Workflow

工作流程

Query observations to identify patterns:

get_observations({ host: "example.com", source: "extension", limit: 50 })

Identify the pattern — look for recurring issues, framework signals, error patterns, or notable behaviors.
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."
})

查询观测结果以识别模式：

get_observations({ host: "example.com", source: "extension", limit: 50 })

识别模式——寻找重复出现的问题、框架信号、错误模式或值得注意的行为。
创建带证据的发现：

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

参数

Parameter	Type	Required	Description
`title`	string	Yes	Short, descriptive title
`url`	string	No	URL this finding relates to
`evidence`	[string]	No	Array of observation IDs ( `obs_xxx` )
`synthesis`	string	No	Detailed 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:

Category	Example 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
在综合分析中解释影响，而不仅仅是重述观测结果
带有证据链的发现比没有证据链的发现有用得多