反幻觉验证清单 — 每次报完成前必跑的 5 步

这是什么

这是一套在 SFD Lab 团队中实际使用的验证清单，用于防止 Agent（包括人类）在报告任务完成时出现幻觉。源自真实翻车案例的教训总结。

什么时候用

• 每次报告任务完成时：无论任务大小，报"done"之前必须跑一遍
• 每次分发子任务时：确保前置条件真实存在
• 每次跨角色交接时：代码写完 → 审计 → 部署 → 验收，每步都要验证

什么时候不用

• 纯信息检索类任务：如搜索一个公开数据点，不需要验证
• 草稿/初稿阶段：写初稿不算"完成"，只有发布才算
• 内部笔记更新：如日记记录、会议纪要

验证清单（5 步）

Step 1 — ls / cat：文件真的存在吗？

ls -la /path/to/deliverable.md
cat /path/to/deliverable.md | head -5

不要凭记忆说"应该有了"。贴 ls 输出。如果文件不存在，任务就是 [ ]（未完成）。

Step 2 — curl / psql：端到端真的通吗？

curl -s -o /dev/null -w "%{http_code} %{size_download}" https://your-site.com/page
# HTTP code = 200? body > 100 bytes?

API 返回 200 ≠ 数据写入了 DB。必须实查。

Step 3 — grep title：部署的是正确的站点吗？

TITLE=$(grep -oE "<title>[^<]+</title>" dist/index.html)
echo "$TITLE" | grep "正确的项目名" || echo "ABORT: wrong site!"

跨项目部署是经典翻车场景。标题对不上就是部署错了。

Step 4 — ss -tlnp：服务真的在跑吗？

ss -tlnp | grep :8080
# "装了 nginx" ≠ "nginx 在跑"，看谁占端口

目录存在 ≠ 进程在跑。看端口占用才是真相。

Step 5 — self-check：我的回复里有敏感词吗？

扫描你的回复文本，如果出现以下任何词 → 立即降级为 [ ]：
simulated / stub / mock / placeholder / TODO / fake

这些词意味着你在编造结果，不是报告真实状态。诚实承认未完成比假装完成好一万倍。老板和 CC 监督层重视"诚实承认未完成"远多于"假装完成"。违反这条会被重置为 [ ] 并记录一次幻觉案例。详见 shared/anti-hallucination-cases.md。

TL;DR Checklist（速记版）

#	Check	Command	Pass Criteria
✅	File exists?	ls -la <path>	file listed, non-zero size
✅	End-to-end?	curl ... + psql ...	HTTP ≥200, body >100B, row in DB
✅	Right project?	grep title dist/index.html	title matches expected project name
✅	Service running?	ss -tlnp | grep :port	process listed, not just config dir exists
✅	No hallucination words?	scan response text for simulated/stub/mock/placeholder/TODO/fake	none found → OK; any found → downgrade task status immediately

补充说明

这套清单的价值不在于复杂度，而在于纪律性。每次执行可能觉得繁琐，但长期坚持能大幅降低返工率。我们团队的幻觉率从最初的 30%+ 降到了现在的 5% 以下，靠的就是这套简单的验证流程。

建议在团队内部将此清单固化为标准操作程序（SOP），新成员入职第一天就要学习并实践。老成员也要定期回顾，避免因为熟悉而松懈。