文档提示工程人工智能【免费下载链接】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 的系统提示词里藏着一条非常细小、却直接影响用户体验的规则在发起工具调用之前不要写冒号。这条规则出现在 system-prompts/system-prompt-tool-call-colon-avoidance.md 中理由是工具调用本身可能不会直接显示在用户看到的输出里。读完本文你将理解这条禁令背后的 UI 现实终端、移动端、专注模式等不同界面下工具调用的可见性差异掌握正确的改写方法并看到它如何与“面向用户文本”“工具调用摘要标签”等相邻提示词规则协同工作最终能把这些原则应用到自己的 Agent 提示词设计中。规则原文一句话的提示词该文档全文仅两段一段 YAML frontmatter 元数据一段规则正文。!-- name: System Prompt: Tool call colon avoidance description: Instructs Claude not to use a colon before tool calls because tool calls may be hidden from user output ccVersion: 2.1.161 -- Do not use a colon before tool calls. Your tool calls may not be shown directly in the output, so text like Let me read the file: followed by a read tool call should just be Let me read the file. with a period.从中可以提取出三个信息层次行为约束工具调用前禁用冒号:改用句号.结尾设计动机来自 description 字段工具调用可能从用户可见输出中隐藏版本信息frontmatter 标记了ccVersion: 2.1.161说明这条规则随 Claude Code 版本演进维护。根据仓库 README.md 的说明本仓库的提示词均从 Claude Code 编译产物中直接提取与真实运行的提示词逐字一致当前仓库追踪到 v2.1.292该规则正文约 59 tokens。为什么工具调用可能“不可见”禁令成立的前提是“工具调用不一定会显示给用户”。仓库中多份相邻提示词从不同角度印证了这一前提system-prompt-communication-style.md 开头即写明“Assume users cant see most tool calls or thinking — only your text output”假设用户看不到大多数工具调用和思考过程只能看到你的文本输出system-prompt-outcome-first-communication-style.md 进一步说明“Text you write between tool calls may not be shown to the user”工具调用之间写的文本可能不会展示给用户因此答案、结论、交付物都必须放在回合的最终文本消息里system-prompt-writing-for-the-user.md 给出了最彻底的说法“The user may not see your tool calls, tool results, or the text you write between them. Only your final message reliably reaches them”用户可能看不到工具调用、工具结果以及你穿插的文本只有最终消息能可靠送达。结合这些描述可以推断 Claude Code 界面大致存在三种工具调用呈现方式界面场景工具调用可见性影响桌面终端默认工具调用以可折叠块形式渲染用户能看到但阅读重心在文本叙述移动端 App完成的工具调用压缩成一行摘要标签细节被截断见下文“摘要标签”一节专注模式Focus mode只有最终文本到达用户中间一切工具调用与过程文本都不可见仓库中的 system-prompt-focus-mode-long-form.md 和 system-prompt-focus-mode-short-form.md 都明确写着“用户只能看到最终文本”system-reminder-brief-mode-user-facing-output.md 也提醒在 brief mode 下普通助手文本会被隐藏用户可见输出必须通过 SendUserMessage 发送。工具调用不显示正是这条冒号禁令要应对的核心场景。冒号为什么是问题悬空的“引号”从可读性角度理解冒号colon在句法上的作用是引出紧随其后的内容它制造一种“话还没说完请看下文”的期待。例如Let me read the file:读到这里用户期待下一行出现文件名或内容摘要。但当随后的工具调用从输出中隐藏时这句以冒号结尾的话就变成了悬空引用——用户看到的是一个没有下文的断句语义不完整甚至会误以为模型输出被截断。而改成句号之后Let me read the file.句子结构完整、语义自洽无论后面的工具调用是否渲染用户读到的都是一句完整的陈述。这正是原文档给出的唯一改写示例把“Let me read the file:”改成“Let me read the file.”把冒号换成句号。这条规则与 system-prompt-writing-for-the-user.md 中的标点纪律高度一致——该文档要求“不用破折号、不用括号、不用箭头”“一句话胜过带冒号的标签”a sentence beats a label with a colon。可以推断冒号禁令本质上属于同一套“面向用户文本”的标点纪律任何依赖后续元素才能成立的标点都不应该出现在可能被截断的用户可见文本里。冒号禁令的适用场景与正确写法结合原文档示例与相邻提示词的上下文这条规则适用于所有“先预告、再调用工具”的叙述典型写法对照如下场景错误写法冒号正确写法句号读取文件Let me read the file:[Read]Let me read the file.[Read]搜索代码Searching for the usage ofparseConfig:[Grep]Searching for the usage ofparseConfig.[Grep]执行测试Running the test suite:[Bash]Running the test suite.[Bash]请求审批Asking for your approval:[AskUserQuestion]Asking for your approval.[AskUserQuestion]改写要领可以归纳为三条预告句必须自立把冒号改成句号后这句预告要能独立成立不依赖后续工具调用补齐信息预告内容保持简短这同时符合 system-prompt-communication-style.md 的“每次更新一句话就够”原则预告句只说明“将要做什么”不展开细节关键结果放最终消息工具执行期间发现的重要信息、最终结论必须像 system-prompt-outcome-first-communication-style.md 要求的那样在回合最后、且其后不再有工具调用的文本消息中完整重述不能只依赖中间的预告句。与“工具调用摘要标签”规则的协同冒号禁令解决的是“工具调用之前的文本”而 system-prompts/system-prompt-tool-call-summary-label.md 解决的是“工具调用之后的呈现”。两者共同构成了移动端 UI 下工具调用的完整展示协议工具调用发生前预告句以句号收尾本规则工具调用完成后系统要求模型写一行“过去式摘要标签”例如Searched in auth/、Fixed NPE in UserService、Created signup endpoint、Read config.json、Ran failing tests。摘要标签规则明确说它“以移动 App 中单行行项目出现约 30 字符处截断所以请按 git 提交主题来写而不是句子”并要求保留过去式动词与最具区分度的名词先删掉冠词、连词和冗长的位置上下文。这反过来印证了本规则的必要性在移动端工具调用被压缩成一行极短标签原本承载“下文”的冒号预告句如果出现在标签前就完全失去了它所指的内容。该规则在子 Agent 提示词中的复现值得注意的是冒号禁令并非只存在于主系统提示词中。system-prompts/system-prompt-agent-thread-notes.md子 Agent 线程行为准则几乎逐字复现了同一条规则Do not use a colon before tool calls. Text like Let me read the file: followed by a read tool call should just be Let me read the file. with a period.从源码结构看这进一步印证了规则的普适性无论是主 Agent 还是被派生的子 Agent如 Explore、Plan 等其执行的中间文本都可能不被直接展示给用户子 Agent 的最终报告通常通过 Handback 等机制回传给父 Agent再经父 Agent 转述因此同样的“悬空冒号”问题同样存在。可以推断Claude Code 团队将这条规则同时注入主提示词与子 Agent 提示词是为了保证多 Agent 协作场景下任何一层对话记录在被回放、压缩、展示时都不会出现指向空白的冒号断句。对 Agent 与提示词工程师的启示这条 59-token 的短规则浓缩了一个重要的工程原则系统提示词要为“最坏渲染环境”写作。具体可迁移的经验包括假设中间文本可能消失凡是预告动作、过程叙述都按“可能不展示”的标准写成自包含句子凡是结论、答案、交付物都放进最终消息标点是渲染契约的一部分冒号、破折号、箭头这类“指向后续内容”的符号在流式输出、截断、折叠、压缩等场景下都可能悬空句号、换行则天然抗截断在 UI 约束下反向设计提示词移动端 30 字符截断摘要标签规则、专注模式只显示最终文本focus mode 规则这类界面约束直接决定了提示词应该怎么写规则要在各层提示词中同步同一规则同时出现在主系统提示词与子 Agent 线程提示词中说明多 Agent 架构下行为准则需要按执行层级重复注入而不是只写在一处。如果想要在自己的 Claude Code 环境中观察或修改这条规则本仓库的 README.md 说明其提示词从 Claude Code npm 版本的编译产物中提取与官方运行时逐字一致对应的最新原文始终可以在 system-prompts/system-prompt-tool-call-colon-avoidance.md 中查看并与 system-prompts/system-prompt-tool-call-summary-label.md、system-prompts/system-prompt-writing-for-the-user.md 等相邻文档对照阅读即可拼出 Claude Code 完整的“用户可见文本纪律”全貌。赞分享文档提示工程人工智能【免费下载链接】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 系统提示词Bash 工具描述中的直接输出文本沟通指令解析 Claude Code 系统提示词Bash 工具描述中的直接输出文本沟通指令 本文以仓库中的 tool description bash alter文档提示工程人工智能Claude Code 系统提示词解析tool_use_meta 字段——工具调用块的展示元数据与线格式规范Claude Code 系统提示词解析tool_use_meta 字段——工具调用块的展示元数据与线格式规范 本文基于开源仓库 claude code sys文档提示工程人工智能Claude Code 系统提示词解析Enable Claude in Chrome 工具何时调用、如何启用浏览器自动化Claude Code 系统提示词解析Enable Claude in Chrome 工具何时调用、如何启用浏览器自动化 本文基于 claude code s文档提示工程人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考