管理提示 - Amazon Q 开发者版
关于提示类型命令使用提示向 MCP 提示传递参数存储位置优先系统增强功能MCP 集成示例

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

管理提示

Amazon Q Developer CLI 为本地提示和模型上下文协议 (MCP) 提示提供了全面的提示管理功能。该系统允许您在整个开发工作流程中创建、编辑、组织和使用可重复使用的提示。

关于提示类型

提示系统支持三种类型的提示：

  • 本地提示：存储在工作区中的项目特定提示

  • 全局提示：所有项目均提供用户范围的提示

  • MCP 提示：由 MCP 服务器提供的具有增强功能的提示

命令

所有提示符管理均可通过带有各种子/prompts命令的命令进行访问。

列出提示

/prompts list

以三栏布局显示所有可用的提示，显示名称、描述和来源。显示提示数并指出哪些提示来自本地存储、全局存储或 MCP 服务器。

创建提示

/prompts create --name name [--content content]

在当前工作空间中创建新的本地提示。

参数
name（必需）

提示名称（最多 50 个字符）

--content content（可选）

直接内容规范

行为：

  • 如果--content已提供，则创建包含指定内容的提示

  • 如果未提供任何内容，则打开默认编辑器进行内容创建

  • 提示将保存到当前工作区.amazonq/prompts/中

编辑提示

/prompts edit name

在默认编辑器中打开现有提示进行修改。

支持的提示：

  • 本地工作区提示

  • 全局用户提示

  • MCP 提示（如果服务器支持）

查看提示详情

/prompts details name

显示有关提示的全面信息，包括：

  • 元数据和参数详情

  • 在 AI 处理之前完成提示内容

  • 参数要求和示例

  • 源信息（本地、全球或 MCP 服务器）

使用提示

创建提示后，在聊天中使用 @ 前缀调用它们：

@prompt-name

示例

@code-review
# Uses your local code-review prompt
@team-standup
# Uses your team-standup prompt

向 MCP 提示传递参数

MCP 服务器提示可以接受参数以自定义其行为。基于文件的提示（本地和全局）不支持参数。

MCP 提示参数语法

@server-name/prompt-name <required-arg> [optional-arg]

/prompts details prompt-name用于发现 MCP 提示符接受哪些参数。

# Example: Using MCP prompt with arguments
@dev-tools/analyze "performance issue" "detailed"
@security-tools/scan "web-app" "high-severity"

存储位置

本地提示（特定于工作空间）

  • 地点:project/.amazonq/prompts/

  • 范围：仅在当前项目中可用

  • 优先级：最高（覆盖同名的全局和 MCP 提示）

全局提示（用户范围）

  • 地点:~/.aws/amazonq/prompts/

  • 范围：适用于所有项目

  • 优先级：中（覆盖同名的 MCP 提示）

MCP 提示

  • 来源：由配置的 MCP 服务器提供

  • 范围：取决于服务器配置

  • 优先级：最低（由本地和全局提示覆盖）

优先系统

当多个提示具有相同名称时，系统将使用以下优先顺序：

  1. 本地提示（最高优先级）

  2. 全局提示

  3. MCP 提示（最低优先级）

这允许您在需要时使用特定于项目的版本覆盖 MCP 或全局提示。

增强功能

内容预览

在将提示内容发送到 AI 模型之前，系统会显示完整的提示内容，从而消除了对实际处理了哪些信息的困惑。

改进了错误处理

  • MCP 服务器错误将转换为用户友好的消息

  • 有用的用法示例是根据提示元数据生成的

  • 针对无效参数或缺少要求的明确指导

视觉格式

  • 在所有提示操作中保持一致的终端样式

  • 所有提示消息类型都能正确显示内容

  • 三栏布局可提高列表的可读性

MCP 集成

提示系统与 MCP 服务器无缝集成：

  • 自动发现：从已配置的服务器中自动发现 MCP 提示

  • 增强的用户体验：改善了 MCP 提示管理的用户体验

  • 错误转换：原始 JSON 错误将转换为可操作的消息

  • 内容预览：执行前 MCP 提示的完整内容预览

示例

这些示例演示了基于文件的提示创建和 MCP 提示的使用。

基于文件的基本提示创建和使用

# Create a simple prompt without arguments
/prompts create --name code-review --content "Please review this code for best practices, security issues, and potential improvements:"

# Use the prompt (no arguments supported for file-based prompts)
@code-review

带参数的 MCP 提示用法

# Using MCP prompts with arguments
@dev-tools/analyze "performance bottleneck" "cpu usage"
@security-tools/scan "web-app" "high-severity"
@aws-tools/deploy "my-service" "production" "us-west-2"