文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载导读本文聚焦 Claude Code 系统提示词中的一个专门化工作流环节——创建/更新 Pull Request 后可选地向 Slack 频道推送 PR 链接的通知步骤见 system-prompt-pr-slack-notification-step.md。文章将以该提示词片段为骨架结合 PR 创建提示词 与 ToolSearch 工具说明 等仓库内证据完整讲解这一步骤的判定条件、工具发现机制、用户确认门控与静默失败策略帮助读者理解 Claude Code 如何以配置驱动 工具自发现 人工确认的方式安全地把 PR 产物同步到 Slack。一、这一步骤在 PR 工作流中的位置该通知步骤不是孤立功能而是挂在 Claude Code PR 创建提示词agent-prompt-pull-request-creation.md之后的第 5 步。要理解它的价值先看它所在的完整上下文分析变更并起草 PR分析自${DEFAULT_BRANCH}以来的所有提交而非仅最新一条拟定标题不超过 70 字符与正文创建分支并推送若当前在默认分支上则新建分支git push -u推送然后通过gh pr create内联正文创建 PR返回 PR URL完成后返回 PR 链接方便用户直接查看第 5 步Slack 通知也就是本文主题——按需向 Slack 频道推送该 PR URL。从提示词片段中的编号5.可以推断这段内容在实际系统提示词中是以流程第 5 步的形式注入 PR 创建场景的。它与前置步骤形成一条完整链路创建 PR → 产出 URL → 依据配置决定是否广播。也就是说PR 通知不是默认行为而是由第 5 步的条件逻辑动态决定的。二、步骤核心逻辑拆解四个环节原提示词片段完整定义了这条通知路径的全部判定规则逐条展开如下2.1 环节一以 CLAUDE.md 为触发条件After creating/updating the PR, check if the users CLAUDE.md mentions posting to Slack channels.该步骤首先检查用户的CLAUDE.md是否提到向 Slack 频道发帖。这里传达了两个关键设计意图配置即意图声明是否通知 Slack 不由 Agent 自行判断而是取决于用户在CLAUDE.md中是否显式声明了这一偏好。CLAUDE.md在这里充当项目/用户级指令文件是工作流行为的裁决依据只读检查、绝不越权Agent 只读取该文件中与 Slack 相关的约定若文件未提及则整个第 5 步在逻辑上直接短路不产生任何通知行为。2.2 环节二用 ToolSearch 做工具自发现If it does, use ToolSearch to search for slack send message tools.一旦条件成立Agent 并不假设 Slack 工具必然存在而是通过ToolSearch主动探测可用的 Slack 发消息工具。这与 Claude Code 的延迟工具deferred tool机制强相关。根据仓库中的工具说明tool-description-toolsearch-opening.mdToolSearch 的作用是获取延迟工具的完整 schema 定义以便调用——延迟工具只会以名字形式出现在system-reminder消息中在未获取前只知道名字、没有任何参数 schema无法被调用见 tool-description-toolsearch-unfetched-tool-note.md。具体到搜索方式ToolSearch 第二段说明 给出了三种查询形式查询形式示例语义精确点名select:Read,Edit,Grep按名字精确拉取这些工具的 schema关键词搜索notebook jupyter常规关键词匹配按max_results返回最佳匹配名字约束搜索slack send要求名字中必须包含slack再按剩余词排序PR 通知步骤中要求的slack send message搜索正对应第三种形态的思路先锁定名字含slack的工具再以send message等语义词排序命中。匹配成功后ToolSearch 会在functions块中返回每个工具的完整 JSONSchema 定义{description: ..., name: ..., parameters: {...}}此后该工具与提示词顶部定义的任何工具一样可被直接调用。2.3 环节三用户确认门控人工授权If ToolSearch finds a Slack tool, ask the user if theyd like you to post the PR URL to the relevant Slack channel. Only post if the user confirms.这是整个步骤的安全闸门即使工具存在Agent 也不能自作主张发送而是必须先询问用户是否将 PR URL 发到相关 Slack 频道且仅在用户明确确认后才执行。这一设计与 Claude Code 一贯的权限模型一致——对外部渠道Slack 是第三方平台会向外部受众暴露链接的写操作必须经过显式人工批准确认confirm是不可省略的硬性前置条件。从安全语义看这条门控同时解决了两个问题内容合规PR URL 属于对外可广播的信息用户可能出于渠道可见性、时机等原因不希望立即扩散操作可追溯每一步对外发布都有用户的明确授权作为依据。2.4 环节四静默失败失败不打扰If ToolSearch returns no results or errors, skip this step silently—do not mention the failure, do not attempt workarounds, and do not try alternative approaches.最后一条是关键的容错纪律它规定了失败时的三种禁止不要提及失败不向用户报告没找到 Slack 工具之类的过程信息不要尝试变通不试图绕过 ToolSearch、不硬编码通道、不猜测工具调用方式不要尝试替代方案不换用其他渠道或改道别的工具实现同一目的。这一设计的合理性在于通知步骤本质是锦上添花的旁路能力。若工具环境不具备 Slack 能力例如未安装相关 MCP/插件、MCP 服务未连接该步骤的缺失不影响 PR 主流程的完整性——PR 已经创建成功、URL 已返回通知失败不应污染主任务的状态或消耗用户注意力。静默跳过将能力探测失败与流程故障明确区分符合健壮系统的降级设计原则。三、从源码侧印证ToolSearch 的边界行为仓库中的配套说明进一步印证了上述静默策略为何必要。在 tool-description-toolsearch-input-validation-note.md 中明确写到未获取unfetched的延迟工具被调用时会直接以InputValidationError失败因为此时只有名字、没有参数 schema。这解释了为什么第 5 步必须先 ToolSearch、后询问、再调用——任何跳过 schema 获取环节的直接调用都会触发校验错误。同时ToolSearch 第二段说明 规定查询结果以functions块返回且返回格式与提示词顶部的工具列表编码一致。这意味着 slack send message 搜索的成功与否是一个可预期的二进制结果要么返回可调用的 schema要么无结果。既然失败本身是结构化的查无此工具或查询报错静默跳过就有了明确且可复现的判定依据——这与提示词中do not attempt workarounds的要求相互印证对未挂载的工具强行变通既违反权限边界也必然因 schema 缺失而失败。四、实战意义与配置启示综合以上分析这一提示词片段对使用 Claude Code 管理 PR 流程的团队有如下可直接落地的启示在 CLAUDE.md 中显式声明 Slack 偏好如果希望 Agent 在 PR 创建后推送链接应在项目级或用户级CLAUDE.md中明确写入类似PR 创建后请发布到 Slack 的 #xxx 频道的约定。这是触发该步骤的唯一入口确保 Slack 工具以可发现形式存在通知依赖 ToolSearch 能检索到名字含slack的发消息工具通常经由 MCP 服务器或插件提供。工具未挂载时该步骤会静默不执行属于预期行为而非故障把确认当作发布必经环节即便一切就绪Agent 仍会先询问再发送用户在确认前可拦截或调整目标频道不要将通知失败视为流程失败PR 创建链路agent-prompt-pull-request-creation.md的成功判定只看 PR 是否创建并返回 URLSlack 通知是可选增强项其静默降级保证了主流程的稳定。五、小结system-prompt-pr-slack-notification-step.md虽然只是一段数十字的提示词片段但它浓缩了 Claude Code 工作流设计的三个核心范式以 CLAUDE.md 作为行为声明的配置驱动、以 ToolSearch 作为延迟工具发现机制的动态能力探测、以用户确认为门控、以静默失败为兜底的安全与容错策略。理解这一片段也就理解了 Claude Code 如何在主动执行与边界克制之间取得平衡——这也是整个系统提示词体系见仓库 system-prompts 目录反复体现的设计主线。赞分享文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载相关推荐Claude Code GitHub App 集成安装指南PR 描述模板与 claude 触发工作流实战Claude Code GitHub App 集成安装指南PR 描述模板与 claude 触发工作流实战 本文以 Claude Code System Pr文档提示工程人工智能Claude Code Superpowers 工程级开发指南Easy Vibe 中的技能触发机制、核心技能详解与完整工作流Claude Code Superpowers 工程级开发指南Easy Vibe 中的技能触发机制、核心技能详解与完整工作流 本文基于 Easy Vibe 课教程文档人工智能Vibe CodingVS Code Sessions 内置 create-pr 技能解析技能文件格式、六步工作流与触发机制VS Code Sessions 内置 create pr 技能解析技能文件格式、六步工作流与触发机制 VS Code 的 Agents Window vs开发工具代码编辑器上一篇NumPy 1.7.1 Release Notes 深度解读1.7.x 系列缺陷修复补丁的完整修复清单与实现剖析下一篇GraalVM Native Image 与原生代码互操作JNI Invocation API 与 Native Image C API 实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考