必须将readme生成流程固化为可复用模板:提取build_script、requires、env_vars为可变锚点,其余指令保持固定;严格用英文双引号包裹锚点值;组合成带校验的模板并绑定runway_schema_version=3.0.0,通过powershell脚本在ci中强制版本匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要把Runway项目里的README文档提示词固化为可复用流程,必须让每次生成的文档都严格对齐代码库真实结构、暴露关键接口变更、标注已知限制,而不是靠人工反复校验或重写提示词——因为手动拼凑的提示词在v2.4.1和v3.0.0两个版本间会漏掉新引入的CLI参数校验逻辑,导致生成的安装说明仍指向已废弃的npm install命令。
提取可变锚点与稳定指令
打开你当前项目根目录下的runway.yml或config.json→定位其中明确声明的构建入口、依赖项、环境变量三类字段→将它们逐条复制到文本编辑器中。例如:build_script: "make build"、requires: ["node@20.15", "python@3.11"]、env_vars: ["RUNWAY_ENV", "API_TIMEOUT_MS"]。这三项就是每次换项目必改的【可变锚点】。
把其余所有描述性内容(如“生成简洁专业的技术文档”“使用Markdown语法”“避免使用第一人称”)全部保留为固定指令段,不替换、不删减。这些是Runway模型理解“README体裁”的底层信号,删掉会导致输出混入口语化表达或表格错位。
【必须用英文双引号包裹每个锚点值,且引号内不加空格】。例如写"node@20.15",不能写" node@20.15 "或node@20.15。Runway解析器会把带空格的字符串识别为两个独立token,从而跳过整个依赖项校验。
封装为带校验的模板指令
将固定指令段与锚点组合成完整提示词,格式为:
"Generate a GitHub-ready README.md for a Runway-powered project. Use exact dependency versions: 【REQUIRES】. Build entry point is 【BUILD_SCRIPT】. Required environment variables: 【ENV_VARS】. Do not list deprecated flags. Show CLI usage with --help output snippet. End with 'Troubleshooting' section listing known timeout issues under RUNWAY_ENV=staging. Output only raw Markdown, no explanation."
把上面整段复制进VS Code→用Ctrl+H批量替换【REQUIRES】→"node@20.15, python@3.11"、【BUILD_SCRIPT】→"make build"、【ENV_VARS】→"RUNWAY_ENV, API_TIMEOUT_MS"。替换后立刻保存为template-readme-v3.txt。
这一步操作起来很简单,直接把文件拖进去就行。但注意:替换完必须用Runway Web UI的Preview功能验证一次,确认生成结果里CLI示例是否含--dry-run参数——若不含,说明【BUILD_SCRIPT】锚点没被正确识别,要检查yml中是否用了缩进空格而非tab。
绑定版本锚点并注入校验钩子
第一步:在模板末尾追加一行硬编码版本标识→"// RUNWAY_SCHEMA_VERSION=3.0.0"。
第二步:在PowerShell中执行校验脚本,确保每次调用前自动比对本地runway.yml中的version字段:
```powershell
$cfg = Get-Content ./runway.yml | ConvertFrom-Yaml
if ($cfg.version -ne "3.0.0") { Write-Error "Template version mismatch: expected 3.0.0, got $($cfg.version)" }```
第三步:将校验脚本与模板文件打包为.zip→上传至Azure DevOps的Secure Files库→在CI Pipeline的pre-build阶段插入“Run PowerShell Script”任务,路径指向该脚本。
这一步漏掉会导致旧版模板被误用于新版Runway CLI,生成的“快速开始”章节仍包含已被移除的runway deploy --legacy命令,上线后引发客户报障。











