按 README 复现并检查上手说明缺项

这个场景能帮你做什么

作者电脑能运行，README 却可能漏依赖、配置或预期结果。WorkBuddy 可以在允许的测试环境中按原说明复现，或先做文本核对，找出新人上手会卡住的位置。

开始前需要准备什么

提供指定版本源码、README、依赖与配置说明、测试环境和允许执行范围。密钥由实际安全渠道配置，不写进文档；生产资源不用于随意复现。

具体怎么做

第一步：清点前置条件

检查系统、运行时、依赖版本、权限、配置和样例数据。说明哪些已具备，哪些文档未提。安装与命令执行需在实际授权范围内。

第二步：严格按文档步骤尝试

先不依赖作者脑中的隐含操作。允许执行时记录命令、实际反馈和失败位置；未执行则明确只是文档审读。

第三步：定位缺项

分开说明遗漏、环境差异、程序缺陷和外部服务问题。为每项补前置、命令、预期、错误恢复与版本限制，不能用绕过测试掩盖问题。

第四步：给最小修订

保留原结构，补必要信息和已验证例子。对无法验证的步骤保留状态，确保读者知道实际成功范围。

可以直接交给 WorkBuddy 的完整要求

按附件指定版本README检查上手流程，先列系统/依赖/配置/权限前置。
仅在允许测试环境执行授权步骤，逐步保留实际命令与结果；不能执行则标仅文本检查。
分类文档遗漏、环境差异、代码缺陷和外部问题，给局部修订与已验证预期。不暴露密钥、不绕过失败、不宣称未运行成功。

完成后会得到什么

一份复现结果或文本缺项清单，以及更清楚的 README 修订草稿。

结果应该怎么检查

确认实际环境、依赖与文档一致，成功判断包含预期产物，不只是命令退出。检查修订没有依赖本机隐含路径和秘密配置。

遇到这些情况怎么处理

依赖不可用时标阻塞。外部服务失败保留限制。命令可能改变重要数据时先停在计划，不为复现强行执行。

哪些必须人工决定

项目维护者确认支持环境和文档，执行者确认命令权限。AI 可协助复现，不保证所有平台都可用。