snippets

配置提示词片段

你正在使用一项技能，它将引导你在 LaunchDarkly 中创建和管理提示词片段。你的任务是找出可复用的文本、创建片段、在配置变体中引用片段，并验证所有内容都已正确关联。

前提条件

此技能要求你的环境中已配置远程托管的 LaunchDarkly MCP 服务。

必需的 MCP 工具：

• create-prompt-snippet -- 创建新的可复用文本块
• list-prompt-snippets -- 浏览项目中的现有片段
• get-prompt-snippet -- 检查特定片段的内容

可选的 MCP 工具：

• update-prompt-snippet -- 编辑片段的文本、名称或标签
• delete-prompt-snippet -- 永久移除片段
• update-ai-config-variation -- 更新变体提示词以引用片段

核心概念

什么是提示词片段？

提示词片段是存储在项目级别的命名版本化文本块。它们包含可复用的提示词内容片段，例如角色设定、安全防护规则、输出格式说明和领域知识，可在多个配置变体之间共享。

更新片段时，会创建一个新版本。引用该片段的配置变体可以获取最新版本，从而使所有配置保持同步。

何时使用片段

场景	示例
共享角色设定	“你是 Acme Corp 的一名乐于助人的客户支持 Agent……”用于 5 个不同的配置
安全防护规则	“绝不泄露内部定价。绝不生成用于访问生产数据库的代码。”
输出格式	“始终使用包含以下键的 JSON 进行回复：answer、confidence、sources。”
领域知识	公司专用术语、产品名称或流程说明
法规文本	每条回复中都必须包含的合规免责声明

何时不使用片段

• 仅适用于单个变体的文本——直接将其写入提示词即可
• 每次请求都会变化的动态内容——改用模板变量
• 完整提示词——片段是构建块，而不是完整提示词

核心原则

1. 优先考虑可复用性：只有当文本将在 2 个或更多地方使用时，才创建片段
2. 单一职责：每个片段应只涵盖一个方面（角色设定或安全防护规则，不要两者兼有）
3. 使用描述性键名：使用 safety-guardrails、json-output-format、support-persona 这样的键名
4. 添加标签以便查找：添加标签，让团队成员可以按类别查找片段
5. 验证引用：创建片段后，确认它已出现在项目中

工作流

步骤 1：找出可复用文本

创建片段之前，先了解哪些内容是共享的：

1. 使用 get-ai-config 逐一列出项目中的现有配置
2. 查找不同变体提示词中的重复文本
3. 找出需要保持一致的文本（安全防护规则、角色设定、格式）
4. 使用 list-prompt-snippets 检查现有片段，避免重复

步骤 2：创建片段

使用 create-prompt-snippet，并提供：

• key -- 唯一标识符（小写字母，使用连字符，例如 safety-guardrails）
• name -- 易于阅读的显示名称
• text -- 可复用的提示词文本内容
• description（可选）-- 说明何时或为何使用此片段
• tags（可选）-- 添加分类标签以便查找（例如 ["guardrails", "safety"]）

{
  "projectKey": "my-project",
  "key": "support-persona",
  "name": "Customer Support Persona",
  "text": "You are a friendly, knowledgeable customer support agent for Acme Corp. Always greet the customer by name when available. Be empathetic but concise. If you don't know the answer, say so honestly and offer to escalate.",
  "description": "Standard persona for all customer-facing support configs",
  "tags": ["persona", "support"]
}

步骤 3：验证

1. 使用 get-prompt-snippet 确认片段已创建且文本正确
2. 使用 list-prompt-snippets 查看项目列表中的片段
3. 检查新创建的片段版本是否为 1

报告结果：

• 已创建片段，并提供键名、名称和文本
• 已确认版本号
• 标签已正确应用

步骤 4：更新片段（需要时）

使用 update-prompt-snippet 修改现有片段。仅传入你要更改的字段：

{
  "projectKey": "my-project",
  "snippetKey": "safety-guardrails",
  "text": "Updated guardrail text with new compliance requirements..."
}

每次更新都会创建一个新版本。引用该片段的现有配置变体可以获取新版本。

边缘情况

情况	操作
片段键已存在	使用 get-prompt-snippet 进行检查，然后更新或选择其他键
文本非常长	片段可以容纳大段内容，但为了便于模块化，可考虑将其拆分为多个片段
配置引用了片段	谨慎更新，因为更改会传播到所有引用该片段的配置
删除被引用的片段	提醒用户配置将失去该引用。使用 delete-prompt-snippet 并设置 confirm: true

不要这样做

• 不要为只在一个地方使用的文本创建片段
• 不要将整个提示词放在单个片段中，而应将其拆分为重点明确的部分
• 不要在未检查哪些配置引用了片段前就删除片段
• 不要重复创建已有片段——先检查 list-prompt-snippets

更多资源

要详细了解如何在 LaunchDarkly UI 中设置提示词片段，请阅读提示词片段。