课程 356 / 365
98%
作品、岗位与个人增长·练习·18 分钟
正文已完成

交付一套可复查的作品证据包

把Brief、数据说明、版本记录、决策、测试、演示与边界组织成共享档案。

L356

证据包要服务两类读者是快速浏览者先看到问题、结果和你的贡献,深入审阅者能继续查看数据、版本、测试和失败。分层结构比把全部材料堆进一份长文更有效。

这一课的结果

能为一个作品建立既方便浏览又支持深入复查的证据目录。

核心概念

先把关键判断说清楚

01

入口摘要给出证据地图

一页README链接到问题、演示、指标、代码、决策和边界,读者可按需深入。

02

原始与公开版本分离

敏感原始材料保存在受控位置,对外只发布脱敏样本与可验证统计。

03

证据清单防止断链

每项主张标明对应文件、版本和访问状态,链接失效或不可公开时提供替代说明。

案例拆解

把零散文件整理成七层作品包

作品材料散在聊天记录、截图和本地文件,演示时找不到指标来源。

  1. 01

    README用一页说明问题、结果、角色和关键链接。

  2. 02

    建立brief/data/decisions/iterations/evals/demo/limitations七个目录。

  3. 03

    公开包使用脱敏样本,私有证据索引记录原始材料负责人和可核验方式。

案例结果

快速读者五分钟理解价值,评审者也能沿链接复查每个主张。

提交前练习

现在轮到你

为一个作品设计证据包目录与公开边界。

内容会自动保存在当前设备
查看参考答案与评分标准

参考答案

README列用户问题、我的职责、召回94%与演示;目录含brief/evals/adr/changelog/demo/limits;对外只放20条脱敏样本,原始数据由主管可核验;发布前检查链接、提交哈希和秘密扫描。

评分标准

  • 入口能在五分钟说明作品
  • 每个关键主张有证据路径
  • 公开包不泄露秘密且保留核验方式

本课收口 · 学习证据

完成,不等于随手打一个勾。

确认阅读、保存练习,再用 30 秒检查和一句话总结留下真实学习证据。

0 / 3
02完成本课练习0 / 4 项必填内容已填写
03通过理解检查约 30 秒
作品证据包的README最重要的作用是什么?
你现在更接近哪一种状态?
完成上面三项后,才能把本课记为已验证。

资料来源

继续核对与延伸阅读

本课内容最近更新于