企业官网建设流程全解析

Xcode 自定义指令：教会 Copilot 你的编码习惯

【免费下载链接】CopilotForXcodeAI coding assistant for Xcode项目地址: https://gitcode.com/GitHub_Trending/cop/CopilotForXcode

你一定有过这种体验：刚让 Copilot 写了个网络请求函数，命名风格不对，错误处理也不是你要的样子，整段推倒重来。于是你开始往每次对话里粘贴"记得用 async/await，错误日志必须带上下文"，下一个会话又忘了。

Copilot for Xcode 的自定义指令解决的就是这个问题：把你的规范写进一个 Markdown 文件，之后每次对话，AI 都会自动带上它们。

自定义指令就是一两个 Markdown 规则文件。你在里面写下编码风格、命名约定、错误处理标准，系统会自动把它注入每一次聊天请求，你不用再重复交代背景。

一句话：规则只写一遍，AI 永远记得。

自定义指令是怎么跑起来的

先认识两种规则文件

系统支持两种文件。第一种是 .github/copilot-instructions.md，放在工作区根目录或设为全局，对当前工作区的所有聊天生效。第二种是 .instructions.md，可以建多个，在文件头部声明它该作用于哪些文件。

规则能读到"你现在在编辑什么"

规则文件不是死文本。你发消息时，CustomCommandTemplateProcessor 会先从编辑器里读出实时信息——当前选中的代码、文件语言、文件路径、剪贴板内容——再填进规则里。所以你可以在规则里写"基于选中的代码重构"，AI 确实知道你说的是哪段代码。静态规则加动态上下文，指令才真正"在场"。

一个边界：只对聊天生效

注意，自定义指令不会影响你打字时的代码补全。它改变的是你"提问"时 AI 收到的东西，不是输入法的自动补全。

实操：从整个工作区到单个文件类型

统一整个团队的代码风格

1. 打开 Settings，进入 Advanced，再点 Chat Settings
2. 在 "Copilot Instructions" 右侧，点击 "Current Workspace" 或 "Global"
3. 用 Markdown 写规范：命名规则、错误处理要求、注释风格，一条一行
4. 保存关闭，这个工作区里新的聊天就会自动带上这些规则

如果团队共用一个仓库，把这份文件放在工作区里并提交版本控制，每个人的 AI 就会说同一种"方言"。

让规则只对 Swift 文件生效

1. 在同一个 Chat Settings 页面，找到 "Custom Instructions" 右侧的 "Create" 并点击
2. 输入文件名并确认，系统会在工作区生成一个新的 .instructions.md 文件
3. 在文件头部的 YAML 里设置applyTo，写一个 glob 模式，比如只匹配 Swift 文件
4. 正文写 Swift 专属规则：优先函数式风格、用可选链、类型别名用 PascalCase
5. 之后你聊到 Swift 文件时，系统会自动把这份规则附上去

让一条规则引用另一条

规则多了就该拆文件：语言一个、框架一个、文档风格一个。在规则文件正文里用 Markdown 链接指向另一份规则文件，两者会被一起读入，同一份内容不用来回复制。

容易踩的坑和进阶搭配

容易踩的坑

• 把规则写成一大段长文：指令以短而直接的效果最好，一条一句，长内容拆成多个文件按主题组织。
• applyTo 写得太宽：设成对所有文件生效，无关规则就会塞进每次聊天，上下文被稀释，AI 反而变糊涂，能收窄范围就收窄。
• 选中代码这类变量填不进去：它们依赖源码编辑器扩展，先去 Xcode 的设置里检查扩展是否已启用。

两个进阶搭配思路

• 配合 Prompt Files 使用：把"一键可执行"的提示词写进 prompt 文件，再用 Markdown 链接引用指令文件，规则归规则、任务归任务，两边都不臃肿。
• 按"谁在用"拆文件：Swift、Objective-C、Markdown 文档各一份，每份都只写这一类文件真正需要的约束。

回到开头那个场景：以后你只需说"写个网络请求函数"，AI 已经知道你的命名和错误处理标准，不用再粘同一份规则了。想多看几种规则文件的写法，可以翻一下仓库里的 自定义指令文档。

【免费下载链接】CopilotForXcodeAI coding assistant for Xcode项目地址: https://gitcode.com/GitHub_Trending/cop/CopilotForXcode