项目没有文档，怎样生成一份可以实测的运行说明

运行说明必须由真实命令产生

README 缺失或过期时，先从项目清单、CI、容器配置和启动脚本找候选命令，再在干净或接近目标的环境实测。不能把“应该能运行”写成已验证。

环境前提

系统、运行时、包管理器、外部服务和版本要求。

通过标准：每项来自配置或实测，不按技术栈猜

把涉及的文件、目录、版本、命令和实际输出写进记录；代码变化同时保留 diff 与测试结果。

安装与配置

依赖命令、环境变量名称、示例值来源和敏感信息处理。

通过标准：不把真实密钥写进文档

确认“安装与配置”已经有可回查结果，再进入“启动路径”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

启动路径

工作目录、命令、端口、预期日志和健康页面。

通过标准：新终端能按步骤启动

确认“启动路径”已经有可回查结果，再进入“测试与构建”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

测试与构建

仓库实际存在的命令、预期退出码和输出位置。

通过标准：命令已运行，失败项原样记录

确认“测试与构建”已经有可回查结果，再进入“停止与清理”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

停止与清理

如何停止进程、撤销临时资源和恢复配置。

通过标准：不会留下不明后台服务或数据

需要修改时先限定文件和行为范围，无法说明回滚方式或影响面的动作先不执行。 完成后把证据归入“经命令验证的本地运行手册”。

让未参与项目的人照文档重跑

记录他卡住的每一步，并把隐含前提补回说明。运行手册标明最后验证日期和环境；无法验证的部分使用“待确认”，不伪装成功。