triggering-examples

# 智能体触发示例：最佳实践 在智能体描述中编写有效 `` 块以实现可靠触发的完整指南。 ## 示例块格式 触发示例的标准格式： markdown 上下文：[描述情况 - 是什么导致了这次交互] 用户："[确切的用户消息或请求]" 助手："[Claude 在触发前应如何响应]" [解释为什么在此场景中应触发此智能体] 助手："[Claude 如何触发智能体 - 通常是 '我将使用 [智能体名称] 智能体...']" ## 优秀示例的剖析 ### 上下文 **目的：** 设置场景 - 用户消息之前发生了什么 **好的上下文：** 上下文：用户刚刚实现了一个新的身份验证功能 上下文：用户创建了一个 PR 并希望进行审查 上下文：用户正在调试测试失败 上下文：在编写了多个函数但没有文档之后 **糟糕的上下文：** 上下文：用户需要帮助（太模糊） 上下文：正常使用（不具体） ### 用户消息 **目的：** 展示应触发智能体的确切措辞 **好的用户消息：** 用户："我添加了 OAuth 流程，你能检查一下吗？" 用户："审查 PR #123" 用户："为什么这个测试失败了？" 用户："为这些函数添加文档" **变换措辞：** 包含针对同一意图的不同措辞的多个示例： 示例 1：用户："审查我的代码" 示例 2：用户："你能检查一下这个实现吗？" 示例 3：用户："看看我的修改" ### 助手响应（触发前） **目的：** 展示 Claude 在启动智能体之前说了什么 **好的响应：** 助手："我将分析你的 OAuth 实现。" 助手："让我为你审查那个 PR。" 助手："我将调查测试失败的原因。" **主动示例：** 助手："太棒了！现在让我审查一下代码质量。" 代码刚刚写完，主动触发审查智能体。 ### 注释 (Commentary) **目的：** 解释推理 - 为什么应该触发此智能体 **好的注释：** 用户明确要求进行代码审查，触发代码审查智能体。 代码实现后，主动使用审查智能体来检查质量。 PR 分析请求符合 pr-analyzer 智能体的专业领域。 **包含决策逻辑：** 用户编写了测试（使用了测试工具）