果味儿幽灵 -- Xcode 新AI助手深度解析

1

摘要：一个被「安排得明明白白」且可定制的助手

2

框架结构速览

• Prompt 模板 (.idechatprompttemplate 文件): 就是些外部文本文件，定义了 AI 的核心性格、规矩，以及在不同模式下的对话逻辑 (比如 BasicSystemPrompt, PlannerExecutorStylePlannerSystemPrompt)。
• 上下文注入器: 一堆专门用来往对话里塞各种 IDE 上下文信息的 prompt 模板 (比如 CurrentFile.idechatprompttemplate, CurrentSelection...)。
• 工具提供者与处理器 (IDEIntelligenceChat 二进制文件): 这是核心逻辑，负责告诉系统有哪些工具能用 (ChatToolProvider)，以及怎么去执行这些工具的指令 (FindTextInFileToolHandler, 等等)。
• 精选知识库 (AdditionalDocumentation 文件夹): 一个本地的 Markdown 文件库，里面全是关于苹果新技术的最新资料，通过 search_additional_documentation 这个工具就能查到。

3

核心架构：Planner-Executor 模型

text
1
"CRITICAL: ... classify as 'make changes' and do BOTH in the SAME TURN ... Then call edit_file/create_file ... Always begin by using classify_message."

4

工具集：在严格「家规」下运行的灵活工具箱

4.1

检索与发现

text
1
2
// 来源: PlannerExecutorStylePlannerSystemPrompt-gpt_5.idechatprompttemplate
Most of the time, the `query_search` tool will be available to you. This tool is a vital resource for all questions about the user's project. If you have the `query_search` tool, you should almost never attempt to explain anything about the user's own project without using it!

text
1
2
// 来源: PlannerExecutorStylePlannerSystemPrompt-gpt_5.idechatprompttemplate
If the topic is covered by a guide described in the definition for the `search_additional_documentation` tool, use the tool to retrieve that guide and learn more before proceeding with the request. It is NEVER acceptable to answer questions that explicitly mention new Apple things... without calling `search_additional_documentation`.

4.2

文件修改

text
1
2
// 来源: PlannerExecutorStylePlannerSystemPrompt-gpt_5.idechatprompttemplate
When you are making changes to the user's project, focus on making changes to the codebase with `edit_file` and `create_file`.

4.3

一个被沙箱化的 AI：「封闭生态」策略

text
1
2
// 来源: TextEditorToolSystemPrompt.idechatprompttemplate
In Xcode, you do not have direct access to the user's file system, so when you run your `view` tool on `/repo`, instead of getting a list of all the files in the user's repository, you'll get a list of the files you have already been shown. To see more files, use the `query_search` tool to find them.

5

定制之路：如何修改这个系统

1. Prompts 是外置的： AI 的核心性格、规则和策略都不是写死在代码里的，而是存在于外部的 .idechatprompttemplate 文件中。我们可以通过编辑或替换这些文件来改变 AI 的行为。
2. 工具是动态的： 工具调用系统也不是硬编码的。ChatToolProvider 会在运行时动态地组装可用的工具列表。这意味着我们可以通过扩展或替换这些 Provider，来把我们自己的定制工具塞进它的工作流里。

6

指导原则：很「苹果」的做事方式

text
1
"Whenever possible, favor Apple programming languages... Always prefer Swift, Objective-C, C, and C++ over alternatives."

text
1
2
3
"In general, prefer the use of Swift Concurrency (async/await, actors, etc.) over tools like Dispatch or Combine..."

"In most projects, you can also provide code examples using the new Swift Testing framework that uses Swift Macros."

7

上下文为王：把 AI 「焊死」在 IDE 里

text
1
2
3
4
5
6
// 来源: PlannerExecutorStylePlannerSystemPrompt-gpt_5.idechatprompttemplate
<searching_additional_documentation>
...
If the topic is covered by a guide described in the definition for the `search_additional_documentation` tool, use the tool to retrieve that guide and learn more before proceeding with the request. It is NEVER acceptable to answer questions that explicitly mention new Apple things (like iOS 26, macOS 26, or any other new Apple OS) or best practices on Apple platforms without calling `search_additional_documentation`.
...
</searching_additional_documentation>

text
1
2
3
4
5
6
// 来源: CurrentFile.idechatprompttemplate
The user is currently inside this file: {{ currentFile.fileName }}
The contents are below:
```{{ currentFile.language }}:{{ currentFile.fileName }}
{{ currentFile.code }}
```

text
1
2
3
4
5
// 来源: CurrentSelection.idechatprompttemplate
The user has selected the following code from that file:
```{{ selection.language }}
{{ selection.code }}
```

8

与其他 iOS 开发 AI 编码工具的对比

9

未来展望与开放问题

• 塑造行为 vs. 提升生产力 Xcode 的 AI 助手会仅仅是一个提升开发者效率的伴侣，还是其更深层次的角色是强制推行平台正统——无论是否有计划，都将巧妙地引导人们采用 Swift Concurrency、Swift Testing 和其他第一方技术？
• IDE 作为终点，还是更大工作流中的一个工具？ 如果其他生态系统向着 Infrastructure as Code 和 agent 驱动的工作流演进，苹果是会加倍努力将 AI 限制在 IDE GUI 中，还是最终允许跨越构建、测试、性能分析和部署流程的 orchestration？换句话说，这个「幽灵」会一直留在机器里，还是学会跨机器漫游？
• 定制化与控制 当前的架构显示出清晰的修改接口（外部 prompts，运行时工具提供者）。苹果会将这些接口作为受认可的企业扩展点来拥抱，还是会为了保持确定性和合规性而收紧它们？

10

附录 A: 工作流程图

11

附录 B: 工具调用类型层级

12

附录 C: 已知内置工具

• query_search: 在代码库中进行语义搜索，通过代码的含义而不是精确的文本来查找相关代码。
• edit_file: 对现有文件应用修改。
• create_file: 创建一个包含指定内容的新文件。
• view: 从一个因为太大而无法完全加载到上下文中的文件里，读取一个特定的行范围。
• find_text_in_file: 在一个大文件中搜索特定的字符串。
• str_replace: 一个简单的字符串替换工具。
• search_additional_documentation: 从框架自带的精选 Markdown 指南中检索内容，用来回答关于「苹果新玩意儿」的问题。

13

附录 D: 框架依赖