GitHub Copilot Chat 斜杠指令使用指南

1. 说明范围

本文档基于当前环境实际可见的指令来源整理：

• 插件内置 prompt 指令：6 个
• 插件内置 skill 指令：6 个
• 当前工作区自定义 skill 指令：1 个
• 用户级自定义 prompt 目录当前不存在：c:\Users\19355\AppData\Roaming\Code\User\prompts

因此，下面列出的内容是你这台机器当前环境里最接近“实际可用”的 / 指令清单。

2. / 指令是什么

在 Copilot Chat 输入框中输入 /，会出现一组可直接调用的命令。

这些命令主要来自两类文件：

1. *.prompt.md
   作用：触发一个固定任务模板。

2. SKILL.md
   作用：触发一套按场景加载的工作流能力。

简化理解：

• prompt 更像“现成命令”
• skill 更像“专项助手”

3. 基本使用方式

3.1 最常见的使用步骤

1. 在 Copilot Chat 输入框输入 /
2. 从下拉列表中选择命令，或直接输入完整命令名
3. 在命令后补一句你的目标、范围或问题
4. 发送后，Copilot 会按该命令对应的模板或技能执行

通用格式：

/命令名 你的目标说明

例如：

/plan 帮我梳理申报流程里材料审核阶段的服务端改动步骤
/create-skill 为 ZCP_BMF 的状态流转排查创建一个技能
/bmf-macro 在申报人目录新增一个按条件批量删除的 serverjs 函数

3.2 使用时怎么把话说清楚

建议在命令后补这些信息：

• 目标是什么
• 改哪个目录或模块
• 是查询、修改、排查、创建文档，还是创建自定义能力
• 如果是 BMF 服务端，尽量带上模块名、节点名、字段名、筛选条件

3.3 prompt 和 skill 的区别

prompt

• 适合单一任务
• 例如：初始化说明文件、创建一个 prompt、创建一个 skill

skill

• 适合多步骤流程
• 例如：处理 BMF 宏命令、分析 chat agent 为什么行为异常

4. 当前环境中的 / 指令清单

4.1 插件内置 prompt 指令

/init

作用：生成或更新工作区的 AI 协作说明文件，一般是 .github/copilot-instructions.md 或 AGENTS.md。

适用场景：

• 新项目刚接入 Copilot
• 想把项目结构、规范、常见命令写成 AI 可读说明

使用方式：

/init 为 ZCP_BMF 项目生成一份面向 serverjs 开发的工作区说明

建议补充的信息：

• 项目重点模块
• 希望 AI 优先遵守的规范
• 哪些目录最关键

/plan

作用：调用 Plan agent 做“研究和规划”。

适用场景：

• 任务复杂，先不急着写代码
• 需要先分步骤、列风险、理清方案

使用方式：

/plan 规划一下公开申报流程中材料审核阶段的服务端改造步骤

建议补充的信息：

• 最终目标
• 涉及哪些模块
• 你是要方案、排期、还是技术拆解

/create-prompt

作用：创建一个可复用的 .prompt.md 文件。

适用场景：

• 你经常重复做同一种聊天任务
• 例如反复让 Copilot 解释代码、写测试、做代码审查

使用方式：

/create-prompt 创建一个“解释 ZCP_BMF serverjs 函数”的通用 prompt

结果通常是：

• 帮你整理出一个 prompt 文件
• 保存成可重复使用的 slash 命令

/create-skill

作用：创建一个可复用的 SKILL.md 文件。

适用场景：

• 某项工作不是一句话能做完，而是有稳定步骤
• 例如：宏命令排查流程、状态机问题定位流程、数据库变更检查流程

使用方式：

/create-skill 创建一个“BMF 状态流转排查”的技能

注意：

• 这个命令是“创建技能”
• 不是“执行宏命令”
• 不是“自动进入 BMF 宏命令模式”

/create-agent

作用：创建一个自定义 agent 文件 .agent.md。

适用场景：

• 你希望 Copilot 在某类任务里表现成一个固定角色
• 比如专门做代码审查、专门做 BMF 宏命令分析、专门做前端页面巡检

使用方式：

/create-agent 创建一个只负责检查 ZCP_BMF serverjs 风险点的 agent

/create-hook

作用：创建 hook 配置，用来约束或自动化 agent 行为。

适用场景：

• 希望某些命令执行前必须确认
• 希望在工具调用前后自动检查、提醒、注入上下文

使用方式：

/create-hook 创建一个在修改 serverjs 前先提醒检查 bmf_macro_list.js 的 hook

/create-instructions

作用：创建 .instructions.md 指令文件，用来固化规则或协作约定。

适用场景：

• 想要求 Copilot 始终遵守某些项目规则
• 比如“serverjs 优先沿用既有目录结构”“查询必须参数绑定”

使用方式：

/create-instructions 创建一个针对 ZCP_BMF serverjs 的项目约束说明

4.2 插件内置 skill 指令

这些 skill 也可能以 /技能名 的形式出现。它们与 prompt 不同，偏向按需加载的工作流能力。

/agent-customization

作用：处理 Copilot 自定义文件相关工作，例如 instructions、prompt、skill、agent、hook。

适用场景：

• 你要维护 .github 下的 Copilot 自定义能力
• 你怀疑某个 skill 或 instructions 没有正确生效

使用方式：

/agent-customization 帮我检查为什么 workspace skill 没有被正确触发

/get-search-view-results

作用：读取 VS Code 搜索面板里当前的搜索结果。

适用场景：

• 你已经在 VS Code 搜索面板搜过内容
• 想让 Copilot 直接基于现有搜索结果继续分析

使用方式：

/get-search-view-results 读取当前搜索结果并帮我总结哪些文件最相关

/install-vscode-extension

作用：指导或执行安装 VS Code 扩展。

适用场景：

• 需要安装新的开发扩展
• 需要补充某种语言、调试、格式化能力

使用方式：

/install-vscode-extension 安装适合 JavaScript 代码检查的 VS Code 扩展

/project-setup-info-context7

作用：基于 context7 类工具获取项目初始化信息。

适用场景：

• 从零创建新项目
• 需要依赖最新文档进行脚手架初始化

使用方式：

/project-setup-info-context7 帮我整理一个新的 Next.js 项目初始化方案

说明：

• 这是偏“项目初始化”的能力
• 对当前 ZCP_BMF 这种已有项目，通常不常用

/project-setup-info-local

作用：基于本地预设规则给出项目初始化方式。

适用场景：

• 创建 VS Code 扩展
• 创建 Next.js、Vite、MCP、Python 项目等

使用方式：

/project-setup-info-local 帮我生成一个 Vite React 项目的初始化方案

/troubleshoot

作用：排查 Copilot Chat 行为异常，依据 debug log 分析原因。

适用场景：

• 为什么某次响应很慢
• 为什么某个 skill 没加载
• 为什么工具没被调用或调用失败

使用方式：

/troubleshoot 帮我分析为什么刚才那个请求没有触发 bmf-macro skill

4.3 当前工作区自定义 skill 指令

/bmf-macro

来源：当前工作区自定义 skill。

作用：专门处理 ZCP_BMF 项目中与 BMF 宏命令体系相关的服务端脚本工作。

它适合的内容包括：

• sjs.macroCall(...)
• saverecs
• sjs_batchdelete
• sjs.query
• sjs.extQuery
• extQueryFull
• idalloc
• 导出、报表、PDF、代码字典、文件、后台任务等宏命令

使用方式：

/bmf-macro 在管理员目录新增一个根据账户名批量删除记录的 serverjs 函数

/bmf-macro 帮我判断这里应该用 saverecs 还是 sjs_batchdelete

/bmf-macro 根据 bmf_macro_list.js 查 export 相关宏命令并给出调用示例

建议补充的信息：

• 角色目录：管理员、评委、申报人、any
• 模块名 MSNAME
• 节点名 NODENAME
• 主键字段或筛选字段
• 是查询、单条修改、批量删除，还是异步任务

特别注意：

• /bmf-macro 是让 Copilot 按“宏命令技能”来帮你分析和写代码
• 它不是直接在系统里执行宏命令
• 真正的执行仍然是在代码里通过 sjs.macroCall(...)、sjs.query(...) 等完成

5. 最推荐的使用写法

下面这些写法比只输入命令名更有效。

5.1 写清楚目标

不推荐：

/bmf-macro 帮我改一下

推荐：

/bmf-macro 在申报人目录新增一个按申报批次查询列表的分页接口，使用 extQuery，并对批次号做参数绑定

5.2 写清楚边界

不推荐：

/plan 做个方案

推荐：

/plan 规划“材料审核阶段”从前端按钮到 serverjs 到数据库筛选条件的完整改造步骤，不直接改代码

5.3 创建类命令要写清楚产物

不推荐：

/create-skill 创建一个技能

推荐：

/create-skill 创建一个“ZCP_BMF 宏命令代码评审”技能，要求能检查宏命令选择、_filter 和 args 绑定、异步任务使用是否正确

6. 适合你当前项目的常用组合

组合一：先规划，再落代码

/plan 规划申报流程中某个节点的改造步骤

然后继续：

/bmf-macro 根据这个方案实现 serverjs 里的查询和批量删除

组合二：先固化规范，再长期复用

/create-instructions 创建一个 ZCP_BMF serverjs 开发约束文件

然后继续：

/create-skill 创建一个 ZCP_BMF 宏命令实现技能

组合三：排查为什么没生效

/troubleshoot 帮我分析为什么某次请求没有触发 bmf-macro

必要时再用：

/agent-customization 检查 skill 的 description、name 和目录结构是否正确

7. 当前环境结论

当前你可以重点记住这些最有价值的命令：

• /bmf-macro：处理 ZCP_BMF 宏命令相关开发
• /plan：先做任务规划
• /init：生成项目协作说明
• /create-instructions：固化项目规则
• /create-skill：沉淀可复用流程
• /troubleshoot：排查 Copilot 行为异常

如果你的目标是做 ZCP_BMF 业务开发，优先使用 /bmf-macro，而不是 /create-skill。

/create-skill 的用途是“造一个技能”；/bmf-macro 的用途是“使用宏命令技能”。