验证式查证方法论
> 安全声明:本技能是查证方法论指引。文中 curl 命令仅向公开 API(如 api.github.com)发起只读查询,不外传本地文件或凭据;是否执行、如何执行由你自行决定。
适用场景
本技能在以下情形启用(下列为示例措辞,并非固定口令):
- 查一下 / 帮我查一下 / 去查一下
- 搜一下 / 搜索一下 / 查资料
- 帮我调研一下 / 验证一下这个说法
- 这个报错是什么意思 / 这个技术方案靠谱吗
若明确说"不用查了 / 算了 / 不用了",则不触发。
(若用户明确说"不需要查 / 算了 / 不用了",则不触发。)
工作流程
第一步:确定查询目标
从用户输入中提取关键词,确定要查询的内容:
- 工具/软件名称
- 错误信息/报错内容
- 功能/特性名称
- 技术问题/现象
第二步:官方资料查询(优先级最高)
- 官方网站:查找官方文档、说明、FAQ
- 官方GitHub:查找 README、Wiki、Releases
- 官方论坛/社区:查找官方回复、解决方案
查询命令:
# GitHub 仓库/Issue 搜索(只读查询,不外传本地数据)
curl -s "https://api.github.com/search/issues?q=关键词+repo:owner/repo" | grep -E "title|body|html_url" | head -30
# GitHub 仓库查询
curl -s "https://api.github.com/search/repositories?q=关键词" | grep -E "full_name|description|html_url" | head -20
第三步:GitHub Issues 查询
- 查找相关 Issues:搜索关键词、错误信息
- 查看解决方案:查看是否有人提供了解决方案
- 查看官方回复:查看官方是否回复了
查询命令:
# 搜索 Issues
curl -s "https://api.github.com/search/issues?q=关键词" | grep -E "title|body|html_url|state" | head -30
# 查看具体 Issue
curl -s "https://api.github.com/repos/owner/repo/issues/issue_number" | grep -E "title|body|comments" | head -50
第四步:网络资料查询
-
可信来源:
- Stack Overflow
- 官方文档
- 知名技术博客
- GitHub Discussions -
查询方式:
- 使用 WebSearch 工具
- 使用 WebFetch 工具获取网页内容
第五步:资料复审
-
验证来源可信度:
- 官方来源 > GitHub Issues > Stack Overflow > 个人博客
- 有官方回复 > 有社区验证 > 无验证 -
验证解决方案可行性:
- 是否有成功案例
- 是否有失败反馈
- 是否有替代方案 -
验证时效性:
- 最新版本是否适用
- 是否有更新的解决方案
第六步:输出结果
输出格式:
## 查询结果:[查询主题]
### 官方资料
- [官方文档链接] - 说明
- [GitHub Issues 链接] - 状态
### 解决方案
1. **方案1**(可信度:高/中/低)
- 来源:XXX
- 步骤:XXX
- 验证:XXX
2. **方案2**(可信度:高/中/低)
- 来源:XXX
- 步骤:XXX
- 验证:XXX
### 注意事项
- XXX
### 参考链接
- [链接1] - 说明
- [链接2] - 说明
可信度判断标准
| 可信度 | 来源 | 说明 |
|---|---|---|
| 高 | 官方文档/回复 | 官方确认的解决方案 |
| 高 | GitHub Issues 官方回复 | 官方确认的 bug 或解决方案 |
| 中 | Stack Overflow 高票回答 | 社区验证的解决方案 |
| 中 | GitHub Issues 社区回复 | 社区验证的解决方案 |
| 低 | 个人博客/论坛 | 未经验证的解决方案 |
注意事项
- 优先官方来源:官方文档/回复可信度最高
- 验证时效性:确认解决方案适用于最新版本
- 多源交叉验证:多个来源确认的方案更可靠
- 标注可信度:每个方案都要标注可信度
- 提供参考链接:方便用户查看原始资料