OPALL

OPALL-N-003 · FIELD NOTE · 已发布 PUBLISHED

AI 项目如何变成可追问证据

How AI projects become reviewable evidence

AI 项目不是越玄越好。能被追问,才像工程项目。

01核心判断CORE JUDGMENT

一个 AI 项目要变成可追问证据,至少需要三类材料:Artifact、Boundary、Review。Artifact 说明做了什么,Boundary 说明没做什么,Review 说明别人可以从哪里追问。

02常见误区COMMON MISTAKE

常见误区是只写"用了大模型、用了 Agent、自动生成"。这些词无法说明工程复杂度,也无法证明项目可运行。

03更好的第一版BETTER V1

更好的第一版是补齐 README、运行截图、测试结果、架构图、关键接口、失败样例和下一步计划。哪怕项目只是原型,也要诚实标注状态。

04边界BOUNDARY

不要把 planned 写成 implemented,不要把 mock 写成 production,不要公开密钥、私有数据或非公开材料。

05下一步NEXT

下一步可以给每个项目做一页 evidence file,统一写 What it is、Architecture、Evidence、Boundary 和 Next。