GitHub Copilot 指令实战禁止终端 Heredoc 写文件用文件编辑工具彻底杜绝文件损坏【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot导读在 VS Code 的 GitHub Copilot含 Agent 模式集成中通过终端 heredocEOF或cat/echo/printf/tee重定向创建、修改文件会触发一系列终端集成缺陷导致文件损坏、内容截断甚至写入垃圾数据。本文以 awesome-copilot 仓库中的 No Heredoc File Operations 指令 为核心系统拆解该问题的成因、完整的禁用命令清单、推荐的替代操作方式并结合仓库内真实 hook 脚本如 fix-broken-links/link-fix.sh说明在 Copilot 环境中正确的文件操作路径。读完本文你将掌握如何在 Copilot 会话中约束 AI 代理凡是写文件一律走文件编辑工具凡是跑命令才走终端从而从根本上避免文件损坏。指令概述它解决什么问题该指令在仓库中的定义如下instructions/no-heredoc.instructions.mdnameNo Heredoc File OperationsdescriptionPrevents terminal heredoc file corruption in VS Code Copilot by enforcing use of file editing tools instead of shell redirectionsapplyTo**作用于所有文件、所有 Agent它是一条全局强制性覆盖型指令MANDATORY: File Operation Override声明对所有 Agent、所有文件操作生效且优先级高于任何其它习得行为。换句话说它不是一份风格建议而是一条硬性技术约束——违反它将直接产生用户必须手动修复的损坏文件。问题根源VS Code 终端集成中的 Heredoc 损坏指令文档明确指出Terminal heredoc 操作在 VS Code 的 Copilot 集成中是损坏的BROKEN。它会造成四类典型故障故障类型触发机制后果文件损坏Tab 字符触发 Shell 补全内容中混入意外字符或交互输出内容错乱引号 / 反引号转义失败内容被 Shell 二次解释与预期不符文件截断退出码 130 中断CtrlC / SIGINT文件只写入一部分静默丢失尾部内容垃圾输出特殊字符被解释文件头部/中部混入命令回显或错误信息从工程原理看heredoc 是把内容当作命令输入传递的其正确性依赖 Shell 对分隔符、引号、转义、路径展开的精确处理。而在 VS Code 的 Copilot 终端集成链路中这个过程会叠加 IDE 的智能补全、按键转发、流式输入等因素导致内容在到达 Shell 之前就被改写。这正是该指令要求写文件不要经过终端的根本原因。仓库中的反面佐证heredoc 误用的真实成本仓库自身的自动化脚本也体现了避免用脆弱文本处理写文件的原则。例如 hooks/governance-audit/audit-prompt.sh 在处理 Copilot 传入的 JSON payload 时只通过jq解析、通过标准变量传递数据绝不把用户内容拼进 heredoc 再写入日志hooks/fix-broken-links/link-fix.sh 在替换文件内容时也刻意用glob_escape/re_escape做字面量转义后再经printf %s写回文件而不是把 URL 内容塞进 heredoc——这些都印证了在自动化场景中内容一旦经过 Shell 解释层就必须付出高昂的转义与校验成本。完整禁用命令清单核心红线以下模式在 Copilot 环境中全部禁止使用原文完整继承均会导致文件损坏# ALL OF THESE CORRUPT FILES - NEVER USE THEM cat file EOF cat file EOF cat file EOF cat file EOF cat file -EOF cat file EOF echo multi line file printf %s\n line1 line2 file tee file EOF tee file EOF逐条拆解其风险点cat file EOF/ EOF/EOF/EOF/-EOF五种常见 heredoc 变体覆盖分隔符加不加引号、加不加空格、是否用-去前导 Tab的排列组合结论是一律禁止cat file EOF追加式 heredoc同样禁止——损坏并不因追加而幸免echo multi\nline file多行字符串通过echo重定向行内引号与换行极易被 Shell 二次解释printf %s\n line1 line2 fileprintf的格式串中含%与转义序列配合重定向同样触发转义失败tee file EOF/ EOFtee结合 heredoc 写入是文件创建场景的常见误用。判断口诀来自指令原文在写下任何创建或修改文件的终端命令之前先自问我是否要用cat、echo、printf、tee或/向文件写内容——如果是则禁止执行。正确做法区分写文件与跑命令写文件 → 一律使用文件编辑工具场景禁止做法推荐做法新建文件cat file EOF等终端命令使用环境提供的文件创建/编辑工具修改文件sed -i、echo 、tee等使用环境提供的文件编辑工具删除文件——删除属于允许的终端操作使用文件删除工具或rm命令核心逻辑文件内容应由编辑工具直接落盘内容字符串不经过终端、不经过 Shell 解释层自然不存在 Tab 补全、转义失败、CtrlC 截断、特殊字符解释这四类风险。工具会正确地处理内容而不产生损坏。跑命令 → 终端仍然被允许指令明确列出了终端仍然允许的合法用途类别示例命令包管理npm install、pip install、cargo add构建npm run build、make、cargo build测试npm test、pytest、go test版本控制git add、git commit、git push运行已有代码node script.js、python app.py文件系统导航ls、cd、mkdir、pwd、rm下载curl、wget允许下载但禁止把下载流经内容加工后重定向写文件注意最后一条的边界curl/wget允许用于下载但下载后经内容处理管道写文件这类操作不属于其合法范围——一旦涉及内容加工再落盘就应改由文件工具或直接落盘方式完成。终端禁止清单与允许清单互补任何带内容的文件创建任何带内容的文件修改任何heredoc 语法任何多行字符串重定向。强制执行三条检查步骤指令的 Enforcement 部分给出了标准操作序列可视为 Agent 与使用者共同的肌肉记忆停在敲下任何终端命令之前停下来问这次操作是要写文件内容还是运行命令写内容 → 禁止换改用合适的文件编辑工具由工具正确落盘杜绝损坏。指令原文强调这不是建议而是硬性技术要求hard technical requirement源于 VS Code 终端集成 bug。忽略本指令将导致文件损坏且必须由用户手动修复。如何在项目里安装与应用这条指令该指令属于 GitHub Copilot 的自定义指令Custom Instructions体系。仓库的 docs/README.instructions.md 给出了标准安装方式点击指令对应的VS Code / VS Code Insiders一键安装按钮或下载*.instructions.md文件手动加入项目的指令集合将内容复制到工作区的.github/copilot-instructions.md全局生效或作为任务级指令放入.github/instructions/目录例如.github/instructions/no-heredoc.instructions.md一旦装入工作区指令会自动作用于 Copilot 行为无需额外开关。同时instructions/instructions.instructions.md 说明了一条高质量指令应具备的前置格式——description单引号包裹、1–500 字符与applyToglob 匹配目标文件。本文主题指令使用applyTo: **意味着它对全部文件生效这与其全局强制覆盖的定位一致。深入探讨heredoc 并非一无是处合理使用的边界禁止 heredoc 针对的是用 heredoc 写文件而不是用 heredoc 给命令喂 stdin。仓库内的 skills/mcp-cli/SKILL.md 就展示了 heredoc 的合法用法——把复杂 JSON 作为标准输入传给 MCP CLI 命令# Complex JSON with quotes (use heredoc or stdin) mcp-cli server/tool EOF { ... } EOF区别在于这里 heredoc 的输出目标是命令的标准输入而非文件系统。同理skills/github-actions-hardening/SKILL.md 中关于 heredoc 的提示使用随机分隔符形式且绝不写入原始用户输入针对的是 CI 脚本内的 stdin 传递场景。因此判断是否违规的唯一标准是最终落盘目标只要内容是写入文件就应切换到文件编辑工具若只是给进程喂输入heredoc 仍是可接受的语法。总结围绕 No Heredoc File Operations 指令可以提炼出三条可执行结论根因VS Code Copilot 的终端集成对 heredoc 存在已知缺陷会因 Tab 补全、转义失败、SIGINT 截断、特殊字符解释造成文件损坏红线cat/echo/printf/tee结合或/写文件的任何变体一律禁用写文件只走文件编辑工具终端只用于包管理、构建、测试、版本控制、运行与导航落地将该指令装入.github/copilot-instructions.md或.github/instructions/后即全局生效Agent 在每次文件操作前执行停—问—换三步检查即可从机制上杜绝损坏文件回流到工作区。【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 GitHub Copilot 指令实战：禁止终端 Heredoc 写文件，用文件编辑工具彻底杜绝文件损坏
GitHub Copilot 指令实战禁止终端 Heredoc 写文件用文件编辑工具彻底杜绝文件损坏【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot导读在 VS Code 的 GitHub Copilot含 Agent 模式集成中通过终端 heredocEOF或cat/echo/printf/tee重定向创建、修改文件会触发一系列终端集成缺陷导致文件损坏、内容截断甚至写入垃圾数据。本文以 awesome-copilot 仓库中的 No Heredoc File Operations 指令 为核心系统拆解该问题的成因、完整的禁用命令清单、推荐的替代操作方式并结合仓库内真实 hook 脚本如 fix-broken-links/link-fix.sh说明在 Copilot 环境中正确的文件操作路径。读完本文你将掌握如何在 Copilot 会话中约束 AI 代理凡是写文件一律走文件编辑工具凡是跑命令才走终端从而从根本上避免文件损坏。指令概述它解决什么问题该指令在仓库中的定义如下instructions/no-heredoc.instructions.mdnameNo Heredoc File OperationsdescriptionPrevents terminal heredoc file corruption in VS Code Copilot by enforcing use of file editing tools instead of shell redirectionsapplyTo**作用于所有文件、所有 Agent它是一条全局强制性覆盖型指令MANDATORY: File Operation Override声明对所有 Agent、所有文件操作生效且优先级高于任何其它习得行为。换句话说它不是一份风格建议而是一条硬性技术约束——违反它将直接产生用户必须手动修复的损坏文件。问题根源VS Code 终端集成中的 Heredoc 损坏指令文档明确指出Terminal heredoc 操作在 VS Code 的 Copilot 集成中是损坏的BROKEN。它会造成四类典型故障故障类型触发机制后果文件损坏Tab 字符触发 Shell 补全内容中混入意外字符或交互输出内容错乱引号 / 反引号转义失败内容被 Shell 二次解释与预期不符文件截断退出码 130 中断CtrlC / SIGINT文件只写入一部分静默丢失尾部内容垃圾输出特殊字符被解释文件头部/中部混入命令回显或错误信息从工程原理看heredoc 是把内容当作命令输入传递的其正确性依赖 Shell 对分隔符、引号、转义、路径展开的精确处理。而在 VS Code 的 Copilot 终端集成链路中这个过程会叠加 IDE 的智能补全、按键转发、流式输入等因素导致内容在到达 Shell 之前就被改写。这正是该指令要求写文件不要经过终端的根本原因。仓库中的反面佐证heredoc 误用的真实成本仓库自身的自动化脚本也体现了避免用脆弱文本处理写文件的原则。例如 hooks/governance-audit/audit-prompt.sh 在处理 Copilot 传入的 JSON payload 时只通过jq解析、通过标准变量传递数据绝不把用户内容拼进 heredoc 再写入日志hooks/fix-broken-links/link-fix.sh 在替换文件内容时也刻意用glob_escape/re_escape做字面量转义后再经printf %s写回文件而不是把 URL 内容塞进 heredoc——这些都印证了在自动化场景中内容一旦经过 Shell 解释层就必须付出高昂的转义与校验成本。完整禁用命令清单核心红线以下模式在 Copilot 环境中全部禁止使用原文完整继承均会导致文件损坏# ALL OF THESE CORRUPT FILES - NEVER USE THEM cat file EOF cat file EOF cat file EOF cat file EOF cat file -EOF cat file EOF echo multi line file printf %s\n line1 line2 file tee file EOF tee file EOF逐条拆解其风险点cat file EOF/ EOF/EOF/EOF/-EOF五种常见 heredoc 变体覆盖分隔符加不加引号、加不加空格、是否用-去前导 Tab的排列组合结论是一律禁止cat file EOF追加式 heredoc同样禁止——损坏并不因追加而幸免echo multi\nline file多行字符串通过echo重定向行内引号与换行极易被 Shell 二次解释printf %s\n line1 line2 fileprintf的格式串中含%与转义序列配合重定向同样触发转义失败tee file EOF/ EOFtee结合 heredoc 写入是文件创建场景的常见误用。判断口诀来自指令原文在写下任何创建或修改文件的终端命令之前先自问我是否要用cat、echo、printf、tee或/向文件写内容——如果是则禁止执行。正确做法区分写文件与跑命令写文件 → 一律使用文件编辑工具场景禁止做法推荐做法新建文件cat file EOF等终端命令使用环境提供的文件创建/编辑工具修改文件sed -i、echo 、tee等使用环境提供的文件编辑工具删除文件——删除属于允许的终端操作使用文件删除工具或rm命令核心逻辑文件内容应由编辑工具直接落盘内容字符串不经过终端、不经过 Shell 解释层自然不存在 Tab 补全、转义失败、CtrlC 截断、特殊字符解释这四类风险。工具会正确地处理内容而不产生损坏。跑命令 → 终端仍然被允许指令明确列出了终端仍然允许的合法用途类别示例命令包管理npm install、pip install、cargo add构建npm run build、make、cargo build测试npm test、pytest、go test版本控制git add、git commit、git push运行已有代码node script.js、python app.py文件系统导航ls、cd、mkdir、pwd、rm下载curl、wget允许下载但禁止把下载流经内容加工后重定向写文件注意最后一条的边界curl/wget允许用于下载但下载后经内容处理管道写文件这类操作不属于其合法范围——一旦涉及内容加工再落盘就应改由文件工具或直接落盘方式完成。终端禁止清单与允许清单互补任何带内容的文件创建任何带内容的文件修改任何heredoc 语法任何多行字符串重定向。强制执行三条检查步骤指令的 Enforcement 部分给出了标准操作序列可视为 Agent 与使用者共同的肌肉记忆停在敲下任何终端命令之前停下来问这次操作是要写文件内容还是运行命令写内容 → 禁止换改用合适的文件编辑工具由工具正确落盘杜绝损坏。指令原文强调这不是建议而是硬性技术要求hard technical requirement源于 VS Code 终端集成 bug。忽略本指令将导致文件损坏且必须由用户手动修复。如何在项目里安装与应用这条指令该指令属于 GitHub Copilot 的自定义指令Custom Instructions体系。仓库的 docs/README.instructions.md 给出了标准安装方式点击指令对应的VS Code / VS Code Insiders一键安装按钮或下载*.instructions.md文件手动加入项目的指令集合将内容复制到工作区的.github/copilot-instructions.md全局生效或作为任务级指令放入.github/instructions/目录例如.github/instructions/no-heredoc.instructions.md一旦装入工作区指令会自动作用于 Copilot 行为无需额外开关。同时instructions/instructions.instructions.md 说明了一条高质量指令应具备的前置格式——description单引号包裹、1–500 字符与applyToglob 匹配目标文件。本文主题指令使用applyTo: **意味着它对全部文件生效这与其全局强制覆盖的定位一致。深入探讨heredoc 并非一无是处合理使用的边界禁止 heredoc 针对的是用 heredoc 写文件而不是用 heredoc 给命令喂 stdin。仓库内的 skills/mcp-cli/SKILL.md 就展示了 heredoc 的合法用法——把复杂 JSON 作为标准输入传给 MCP CLI 命令# Complex JSON with quotes (use heredoc or stdin) mcp-cli server/tool EOF { ... } EOF区别在于这里 heredoc 的输出目标是命令的标准输入而非文件系统。同理skills/github-actions-hardening/SKILL.md 中关于 heredoc 的提示使用随机分隔符形式且绝不写入原始用户输入针对的是 CI 脚本内的 stdin 传递场景。因此判断是否违规的唯一标准是最终落盘目标只要内容是写入文件就应切换到文件编辑工具若只是给进程喂输入heredoc 仍是可接受的语法。总结围绕 No Heredoc File Operations 指令可以提炼出三条可执行结论根因VS Code Copilot 的终端集成对 heredoc 存在已知缺陷会因 Tab 补全、转义失败、SIGINT 截断、特殊字符解释造成文件损坏红线cat/echo/printf/tee结合或/写文件的任何变体一律禁用写文件只走文件编辑工具终端只用于包管理、构建、测试、版本控制、运行与导航落地将该指令装入.github/copilot-instructions.md或.github/instructions/后即全局生效Agent 在每次文件操作前执行停—问—换三步检查即可从机制上杜绝损坏文件回流到工作区。【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考