可复用 Prompt files
创建与调用 .prompt.md,并区分 VS Code Local 和 Agent Host 的当前状态。
Prompt files 保存可反复使用的任务提示。仓库指令自动参与适用请求,而 prompt file 用于用户主动选择的一次任务。GitHub 教程将其列为 VS Code、Visual Studio、JetBrains 的预览功能。
VS Code 当前范围
当前 VS Code 文档明确:Agent Host 不加载 prompt files,该方式已对 Agent Host 弃用;目前仍适用于 Local agent,官方提供向 Agent Skills 迁移的入口。GitHub 通用教程尚未体现这个区分,不能据其旧步骤保证所有会话都可使用。
Local agent 的工作区默认目录是 .github/prompts。可从命令面板运行 Chat: New Prompt File 创建文件,或通过 Chat 的自定义编辑器创建工作区 / 用户 prompt。调用时输入 / 加提示名称,或运行 Chat: Run Prompt。
GitHub 教程仍列出 chat.promptFiles: true、Chat: Create Prompt 和 Attach context → Prompt...。这些作为该教程的版本相关入口保留;新版本优先按当前 VS Code 界面操作,不把旧设置当作 Agent Host 的启用方法。
JetBrains
在 .github/prompts 中创建 NAME.prompt.md,或进入 Tools → GitHub Copilot → Edit Settings → Customizations → Prompt Files → Workspace 创建。保存后在 Chat 输入 /NAME 选择提示,再按需补充文件和具体参数后发送。
虽然教程一处写“保存后应用到工作区”,其使用步骤仍明确要求选择 /NAME 并提交;不要把 prompt file 当作每次请求自动附加的仓库指令。
Visual Studio
把 .prompt.md 文件放在仓库根目录的 .github/prompts 下,使用 Markdown 写提示。GitHub 教程提供创建方法;具体选择与运行界面按当前 Visual Studio 的 prompt file 功能操作,不直接套用 JetBrains 的菜单。
引用相关文件
相对路径从 prompt file 所在目录解析。例如正文可写 Markdown 链接 [index](../../web/index.ts)。GitHub 教程也给出 VS Code / JetBrains 的 #file:../../web/index.ts,Visual Studio 示例则使用 #file:'../../web/index.ts'。
使用真实存在的文件作为上下文,写清任务目标、输出要求和需要保留的行为;执行前补充本次任务的具体内容。持续生效的项目约定应放到仓库指令中。