本文深入探讨了开源 AI 助手 Cline 的系统提示词，该提示词旨在将 AI 塑造为一个“高度熟练的软件工程师 (highly skilled software engineer)”。我们将分析其独特的交互模型，特别是其基于 XML 的显式工具调用格式、严格的“一步一确认”工作流、区分文件编辑策略 (write_to_file vs replace_in_file)，以及明确的“行动模式 (ACT MODE)”与“规划模式 (PLAN MODE)”。通过解读这些设计，揭示 Cline 在追求精确控制、任务分解和透明交互方面的设计哲学。

引言：定义“工程师”般的 AI 助手

与许多追求流畅对话或高度自主性的 AI 助手不同，Cline 的系统提示词从一开始就为其赋予了明确的“工程师”身份。

You are Cline, a highly skilled software engineer with extensive knowledge in many programming languages, frameworks, design patterns, and best practices.

这一定位预示着其交互方式将更侧重于结构化、逻辑性和精确性。其核心目标被定义为迭代式地完成任务：

You accomplish a given task iteratively, breaking it down into clear steps and working through them methodically.

这种方法论要求 AI 像人类工程师一样，将复杂问题分解为可管理的小步骤，并按顺序执行。

核心交互：显式工具调用与步进式确认

Cline 的交互模型围绕着一套严格的工具使用规则，与其他我们分析过的提示词有显著区别：

XML 格式的工具调用： Cline 强制使用一种独特的、基于 XML 风格的标签来格式化工具调用，而非常见的 JSON 对象。
```
# Tool Use Formatting
```
Tool use is formatted using XML-style tags. The tool name is enclosed in opening and closing tags, and each parameter is similarly enclosed within its own set of tags. Here's the structure:
<tool_name> <parameter1_name>value1</parameter1_name> <parameter2_name>value2</parameter2_name> ... </tool_name>
For example:
<read_file> <path>src/main.js</path> </read_file>
Always adhere to this format for the tool use to ensure proper parsing and execution.
这种格式虽然略显冗长，但结构清晰，可能有助于简化解析或与特定后端系统集成。

单工具、步进式执行与强制等待： 这是 Cline 最核心的交互特征。AI 每轮只能使用一个工具，并且必须等待用户的响应（包含工具执行结果）后才能进行下一步。

You can use one tool per message, and will receive the result of that tool use in the user's response. You use tools step-by-step to accomplish a given task, with each tool use informed by the result of the previous tool use.

ALWAYS wait for user confirmation after each tool use before proceeding. Never assume the success of a tool use without explicit confirmation of the result from the user.

It is crucial to proceed step-by-step, waiting for the user's message after each tool use before moving forward with the task.

这种设计强制 AI 进行严格的顺序执行，并在每一步都获得反馈，最大限度地减少了因假设错误或执行失败而导致的连锁问题，确保了每一步操作的可控性和正确性。

前置思考与参数检查： 在调用任何工具之前，AI 被要求在 <thinking> 标签内进行分析，评估信息需求，选择最合适的工具，并检查所有必需参数是否可用。

Before calling a tool, do some analysis within <thinking></thinking> tags. ... think about which of the provided tools is the most relevant ... go through each of the required parameters ... determine if the user has directly provided or given enough information to infer a value. ... If all of the required parameters are present or can be reasonably inferred, close the thinking tag and proceed ... BUT, if one of the values for a required parameter is missing, DO NOT invoke the tool ... and instead, ask the user to provide the missing parameters using the ask_followup_question tool.

这强制 AI 在行动前进行显式的规划和验证，提高了工具调用的成功率。

精细的文件编辑策略：`write_to_file` vs `replace_in_file`

Cline 的提示词在文件编辑方面提供了两种不同的工具，并给出了详细的选用指南，这在其他提示词中较为少见：

write_to_file: 用于创建新文件或完全覆盖现有文件。适用于初始化、重构或大范围修改。但提示词强调，使用此工具需要提供完整的文件内容。

replace_in_file: 用于对现有文件进行目标明确的、小范围的修改。它使用一种独特的 SEARCH/REPLACE 块格式来定义精确的查找和替换内容。

Description: Request to replace sections of content in an existing file using SEARCH/REPLACE blocks that define exact changes to specific parts of the file. ...
Parameters:
- path: (required) ...
- diff: (required) One or more SEARCH/REPLACE blocks following this exact format:
      &lt;&lt;&lt;&lt;&lt;&lt;&lt; SEARCH       [exact content to find]       =======       [new content to replace with]       &gt;&gt;&gt;&gt;&gt;&gt;&gt; REPLACE      
Critical rules:
1. SEARCH content must match the associated file section to find EXACTLY...
...

提示词明确建议默认使用 replace_in_file，因为它更安全、更精确，只在必要时（如创建新文件或进行大规模重写）才使用 write_to_file。这种区分体现了对文件操作风险的细致考量。同时，提示词还特别提醒要考虑自动格式化对文件内容的影响，并以格式化后的文件状态作为后续 SEARCH 操作的基准。

丰富的工具集与特定能力

除了文件编辑工具，Cline 还配备了一系列其他工具：

execute_command: 执行命令行指令，需要指定 requires_approval，并被告知要处理固定工作目录的问题（必要时 cd && command）。
read_file: 读取文件内容。
search_files: 在指定目录进行 Regex 搜索。
list_files: 列出目录内容。
list_code_definition_names: 列出源码中的定义（类、函数等），用于理解代码结构。
browser_action: (如果支持) 提供与 Puppeteer 控制的浏览器交互的能力，用于 Web 开发测试，遵循严格的 launch -> ... -> close 序列。
ask_followup_question: 唯一允许向用户提问的方式，用于获取必要信息。
attempt_completion: 任务完成后的最终报告工具，有严格的使用前提（必须确认所有先前步骤成功）。
use_mcp_tool / access_mcp_resource: 与 MCP (Model Context Protocol) 服务器交互，扩展能力。
plan_mode_respond: 在特殊的“规划模式”下进行对话响应。

行动模式 (ACT MODE) vs 规划模式 (PLAN MODE)

Cline 引入了两种明确的操作模式：

ACT MODE (默认): 使用工具逐步执行任务，最终通过 attempt_completion 提交结果。
PLAN MODE (用户切换): AI 使用 plan_mode_respond 与用户进行讨论、规划、澄清，制定详细的行动计划，待用户确认后切换回 ACT MODE 执行。

这种模式分离使得复杂的任务可以在执行前进行充分的沟通和规划，减少了盲目执行带来的风险。

严格的沟通风格与规则

Cline 的提示词对其沟通风格有非常严格的限制：

- You are STRICTLY FORBIDDEN from starting your messages with "Great", "Certainly", "Okay", "Sure". You should NOT be conversational in your responses, but rather direct and to the point. ... It is important you be clear and technical in your messages.

NEVER end attempt_completion result with a question or request to engage in further conversation! Formulate the end of your result in a way that is final...

它被要求避免使用任何寒暄或口语化的表达，保持直接、技术性的沟通风格，并且在任务完成时明确结束，不主动寻求进一步对话。这再次强化了其“工程师”而非“聊天伙伴”的角色定位。此外，还有诸如不能 cd、不能用 ~ 等具体的技术限制。

结论：严谨、透明、可控的工程师范式

Cline 的系统提示词构建了一个与其他 AI 助手显著不同的交互模型。它通过独特的 XML 工具格式、强制的单步确认机制、精细的文件编辑策略、明确的操作模式分离以及严格的沟通规则，塑造了一个高度结构化、注重过程控制和交互透明度的 AI 工程师。这种设计牺牲了一定的对话自然性和执行速度，但换来了更高的执行精度、可预测性和可控性，特别适用于需要精确执行、分步验证的复杂软件工程任务。Cline 的提示词为构建高可靠性、高透明度的 AI Agent 提供了一种独特的、值得研究的设计思路。

剖析 Cline 提示词：一种严谨、分步、显式交互的 AI 工程师范式

评论区

需要帮助？