Skip to content
FunCoding

Search

Search docs, Skills and MCP

可复用 Prompt files

创建与调用 .prompt.md,并区分 VS Code Local 和 Agent Host 的当前状态。

This page has not been translated into English yet. The original Chinese version is shown below.

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'。

使用真实存在的文件作为上下文,写清任务目标、输出要求和需要保留的行为;执行前补充本次任务的具体内容。持续生效的项目约定应放到仓库指令中。