幻觉检测器

⚠️ 发布规则 所有发布到 ClawHub 的技能必须严格测试，确认无误后再发布。

技能测试验证清单

• frontmatter 格式正确
• 检测逻辑完整
• 幻觉类型覆盖全
• 验证流程明确
• 无语法错误

Hallucination Detector - 幻觉检测器 原创技能 | 激活词：检测幻觉 / 验证代码 / 代码审查

核心问题 AI 生成的代码可能出现“幻觉”：

• 调用不存在的 API
• 使用错误参数
• 引用不存在的文档
• 混淆相似库名
• 虚构函数签名

幻觉类型分类 类型1: API 幻觉 # ❌ 幻觉：不存在的 API response = requests.get_json(url) # 应为 response.json() # ❌ 幻觉：错误方法 list.append_many([1,2,3]) # 应为 extend() # ❌ 幻觉：不存在参数 df.sort('column', ascending=True) # pandas 2.x 需用 by=

类型2: 版本幻觉 # ❌ 幻觉：版本不兼容 # React 19 无需 forwardRef # ❌ 幻觉：过时 API requests.post(url, data={}) # 应改用 json={}

类型3: 引用幻觉 # ❌ 幻觉：不存在文档 # 参见: https://fake-docs-example.com（虚构链接） # ❌ 幻觉：不存在库 import super_fake_library # 未发布库

类型4: 类型幻觉 # ❌ 幻觉：错误类型假设 def func(x: str) -> str: return x.append('a') # str 无 append # ❌ 幻觉：类型不匹配 result = await promise.json() # promise 是 Promise 对象，非 Response

类型5: 逻辑幻觉 # ❌ 幻觉：不可能逻辑 if user.is_admin and not user.is_admin: # 自相矛盾 # ❌ 幻觉：恒真条件 if x == x: # 永远为真

检测策略

• 静态分析

def static_check(code: str) -> list[Hallucination]: issues = [] # 检查不存在 API for call in extract_api_calls(code): if not api_exists(call): issues.append(Hallucination(type='api', location=call.location, message=f"API '{call.name}' 不存在")) # 检查类型错误 for type_check in extract_type_checks(code): if not type_compatible(type_check): issues.append(Hallucination(type='type', location=type_check.location, message=f"类型不匹配: {type_check.expected}")) return issues

• 引用验证

def verify_references(code: str) -> list[Hallucination]: issues = [] for ref in extract_urls_and_docs(code): if not url_exists(ref): issues.append(Hallucination(type='reference', location=ref.location, message=f"URL 不存在或无法访问: {ref.url}")) for lib in extract_imports(code): if not package_exists(lib): issues.append(Hallucination(type='package', location=lib.location, message=f"包 '{lib.name}' 不存在")) return issues

• 逻辑验证

def logical_check(code: str) -> list[Hallucination]: issues = [] for expr in extract_conditions(code): if is_contradiction(expr): issues.append(Hallucination(type='logic', location=expr.location, message="逻辑矛盾或永真条件")) return issues

完整检测流程

• 代码输入

↓

• 静态分析（API/类型检查）

↓

• 引用验证（URL/包检查）

↓

• 逻辑验证（矛盾/永真检查）

↓

• 综合报告

↓

• 修复建议

输出格式

幻觉检测报告

检测结果：发现 3 处幻觉 ⚠️

幻觉 #1 [高危]

• 类型：API 幻觉
• 位置：line 15
• 代码：response.get_json()
• 问题：方法名错误
• 建议：改为 response.json()

幻觉 #2 [中危]

• 类型：版本兼容
• 位置：line 23
• 代码：forwardRef(...)
• 问题：React 19 已废弃
• 建议：直接使用 ref 作为 prop

幻觉 #3 [低危]

• 类型：引用幻觉
• 位置：line 45
• 代码：https://docs.example.com/fake
• 问题：URL 可能不存在
• 建议：验证链接或移除

置信度评估

• 综合置信度：0.92
• 误报率预估：<5%

置信度计算 | 检测类型 | 基础置信度 | 调整因素 | |----------|------------|----------| | API 检查 | 0.85 | +0.1 静态可验证 | | 版本检查 | 0.70 | +0.1 版本明确 | | 引用检查 | 0.80 | +0.1 可实际验证 | | 逻辑检查 | 0.75 | +0.1 模式明确 |

集成建议 配合其他技能使用：

• workflow-verifier：执行前验证代码
• karpathy-principles：确保代码简洁可验证
• entropy-manager：控制验证流程熵

原创性声明 本技能为原创，融合：

• 静态代码分析
• API 签名验证
• 引用完整性检查
• 逻辑矛盾检测

作者：laosi 创建日期：2026-04-28