← 返回首页深度篇
深度篇 · Enterprise · 企业版后台使用说明

把团队规范做成 / 指令:自定义指令配置指南

Enterprise | 更新于 2026-10-18

本篇涵盖的知识重点

配置上手路径

1 进入自定义指令面板并创建 2 填写三项必填配置 3 按需关联知识库增强回答 4 开启引用文件注入工程上下文 5 保存并确认指令已启用 6 在对话框用 / 调用并排查不可见
共 6 步,按编号顺序阅读

指令配置要点解读

1进入自定义指令面板并创建

作用把高频的团队规范固化成指令,成员就能一键复用而不必每次重写提示词。

操作登录企业管理后台,在左侧导航栏中选择自定义指令,进入指令面板后单击创建指令。

注意需要使用企业管理员身份操作;指令在企业组织内共享,创建前先想清楚它是否适合全员使用。

企业管理后台中的自定义指令面板
图:在左侧导航栏选择自定义指令,进入指令面板后单击创建指令
2填写三项必填配置

作用名称决定能不能被找到,描述决定会不会被选对,提示词决定输出质量。

操作在创建页面填写指令名称、指令描述与提示词描述三项必填内容,上下文部分留到下一步按需开启。

注意指令名称避免过长或含义模糊,也要避免与系统内置指令或客户端规则冲突;提示词描述中请勿硬编码敏感凭据如 API Key、Token、密码,因为客户端会将此内容注入模型上下文。

一条指令的配置结构
  • 指令名称:必需,开发者通过 / 看到的标识符,建议使用简洁英文或中文短词
  • 指令描述:必需,展示在指令选择器中的简短说明,帮助团队成员理解指令用途
  • 提示词描述:必需,指令的核心 Prompt 内容,定义 AI 响应时的行为、输出格式与约束
  • 上下文配置:可选,包含知识库关联与引用文件两个子选项
创建指令时填写名称描述与提示词
图:填写指令名称、指令描述与提示词描述三项必填配置
3按需关联知识库增强回答

作用关联内部规范文档后,指令的输出会更贴合企业实际,而不是通用答案。

操作在上下文中勾选「添加知识库」以启用功能,单击「+ 选择添加知识库」,从官方知识库和自定义知识库中选取。如需创建自定义知识库,可参考知识库管理相关说明。

注意关联知识库后,指令调用的检索范围受知识库自身的可见范围限制;成员看不到知识库时,指令也不会从中取到内容。

上下文配置中的添加知识库选项
图:开启添加知识库后,可从官方与自定义知识库中选取关联库
4开启引用文件注入工程上下文

作用引用当前工程文件能让指令针对真实代码给出建议,而不是泛泛而谈。

操作在上下文中开启「引用文件」选项,调用该指令时会自动关联当前工程文件作为上下文。

注意开启后调用指令会将当前工程文件内容作为上下文发送,请注意工程文件的敏感信息暴露风险。

上下文中开启引用文件选项
图:开启引用文件后,调用指令时会自动关联当前工程文件作为上下文
5保存并确认指令已启用

作用只有处于启用状态的指令才会出现在成员的 / 列表中。

操作单击保存,返回指令面板确认该指令已启用(默认开启)。若后续不再使用,建议及时关闭或删除,减少指令选择器中的干扰项。

注意停用会立即影响全员,操作前建议先通知团队;可参照官方的代码审查示例来规划自己的第一条指令。

代码审查指令的示例配置
  • 指令名称:review,用短词便于在 / 列表中快速定位
  • 指令描述:审查当前代码,输出改进建议与潜在缺陷
  • 提示词描述:你是一名资深代码审查员。请审查当前文件的代码,按以下维度输出:1.逻辑缺陷 2.性能问题 3.安全风险 4.可读性改进,每条建议附带修改方案
  • 知识库:未关联,这类通用审查可先不挂企业文档
  • 引用文件:已开启,让建议直接落到当前文件上
6在对话框用 / 调用并排查不可见

作用调用是闭环的最后一环,不可见通常不是配置丢了,而是客户端未刷新。

操作在对话框输入 /,从指令列表中选择目标指令,按提示输入补充信息后发送,客户端根据指令配置生成响应。如果 / 列表中未出现已创建的指令,请重启 IDE 或确认当前处于企业组织下。

注意调用指令时按指令绑定的上下文量(知识库检索、文件引用)和任务复杂度消耗相应积分;创建和管理指令本身不消耗积分。

功能涉及的信息收集项
  • 企业账号信息(登录凭据):必要,用于登录企业管理后台创建和管理自定义指令
  • 提示词描述(Prompt 内容):必要,定义客户端响应时的行为规则、输出格式和约束条件
  • 指令描述(简述文字):必要,展示在指令选择器中,帮助成员理解指令用途和匹配目标
  • 关联知识库内容:非必要,仅在管理员主动为指令配置知识库上下文时,增强客户端回答的领域准确性
  • 引用文件上下文(当前工程文件):非必要,仅在对指令开启「引用文件」选项后,调用时将当前工程文件作为上下文注入
对话框中输入斜杠触发指令选择器
图:在对话框输入 / 选择目标指令,补充信息后发送即可调用

权限与合规提示

指令规划练习

练习1:创建一条代码审查自定义指令
提示词(点右上角「复制」,可直接发给 WorkBuddy)
```markdown
我要在企业管理后台创建一条代码审查用的自定义指令,请帮我写出可直接填写的配置内容。
配置字段(请严格按这四个字段输出,不要新增):
- 指令名称:在对话中以 / 触发的标识符,建议简洁英文或中文短词;
- 指令描述:展示在指令选择器中的简述;
- 提示词描述:客户端响应的核心行为定义;
- 上下文:知识库和引用文件两个子选项。
参考示例:指令名称 review;指令描述为审查当前代码,输出改进建议与潜在缺陷;提示词描述为「你是一名资深代码审查员。请审查当前文件的代码,按以下维度输出:1.逻辑缺陷 2.性能问题 3.安全风险 4.可读性改进,每条建议附带修改方案」;知识库未关联;引用文件已开启。
请输出:
1. 一条完整的代码审查指令配置(可在我给的示例基础上增强,但要保持维度清晰、每条建议附修改方案);
2. 再补一条「发版前检查」指令配置,维度覆盖变更清单、回滚方案、配置项、监控项;
3. 一段命名与描述撰写建议(不超过 150 字),说明为什么名称要短、描述要写清用途。
```
预期结果

得到两条可直接粘贴到创建页面的指令配置,字段完整且提示词维度清晰,每条建议都要求附修改方案。

练习2:为团队规划一套自定义指令体系
提示词(点右上角「复制」,可直接发给 WorkBuddy)
```markdown
我要为企业团队规划一套自定义指令体系,请帮我设计方案。
必须依据的真实事实(不要增删功能):
- 自定义指令允许管理员为团队定义可复用的标准化提示词模板,在对话中通过 / 快捷调用;
- 必填项为指令名称、指令描述、提示词描述,上下文(知识库关联与引用文件)为可选;
- 自定义指令在企业组织内共享,同一企业下所有成员均可通过 / 调用已启用的指令;
- 指令不绑定成员权限策略,管理员通过启用/关闭控制指令的可用性;
- 关联知识库后,指令调用的检索范围受知识库自身的可见范围限制;
- 开启引用文件后,调用指令时会把当前工程文件内容作为上下文发送,存在敏感信息暴露风险;
- 提示词描述中请勿硬编码敏感凭据(API Key、Token、密码);
- 创建和管理不消耗积分,调用时按上下文量与任务复杂度消耗积分。
我的场景:一个 60 人的研发团队,日常高频动作包括代码审查、单元测试生成、接口文档生成、发版检查、故障复盘。
请输出:1)一张指令规划表(指令名称 / 指令描述要点 / 是否关联知识库 / 是否开启引用文件 / 预期收益);2)一段权限与合规提示(不超过 150 字),说明哪些指令不适合开引用文件;3)一份推广落地步骤(不超过 150 字)。
```
预期结果

得到一张指令规划表、权限合规提示和推广步骤,指令不绑定成员权限策略这一点被正确体现。

练习3:排查成员看不到自定义指令的问题
提示词(点右上角「复制」,可直接发给 WorkBuddy)
```markdown
有同事反馈在对话框输入 / 后看不到我创建好的自定义指令,请帮我设计排查方案。
已知事实(请严格按此组织,不要新增不存在的操作):
- 自定义指令在企业管理后台创建,保存后默认开启,需要回到指令面板确认该指令已启用;
- 指令在企业组织内共享,同一企业下所有成员均可通过 / 调用已启用的指令;
- 指令不绑定成员权限策略,管理员通过启用/关闭控制可用性;
- 如果 / 列表中未出现已创建的指令,请重启 IDE 或确认当前处于企业组织下;
- 关联知识库后,指令调用的检索范围受知识库自身的可见范围限制;
- 指令名称应避免与系统内置指令或客户端规则冲突。
请输出:1)一棵排查决策树(缩进列表),每步写清判断什么、是与否分别做什么;2)一张「排查项 / 谁来处理 / 需要什么信息」的表;3)一段发给同事的自助排查话术(不超过 150 字),包含重启 IDE 与确认企业组织两个动作。
```
预期结果

得到一棵排查决策树、一张职责分工表和一段自助排查话术,处理路径严格基于给定的排查提示。

参考文档:自定义指令(WorkBuddy 官方文档)
本文基于官方文档再创作,具体以官方文档站实际展示为准。