2.4 全局提示词
💡 一句话总结：创建一个规则文件，AI 每次发消息都会读取，不用重复说"用中文回复"。
学完你能做什么
- 让 AI 永久记住"用中文回复"
- 设置你的编码规范（缩进、命名风格等）
- 定义项目特定的规则
- 跨项目复用你的偏好设置
什么是"规则文件"？
规则文件就是一个 Markdown 文件，里面写着你希望 AI 遵守的规则。OpenCode 会自动读取这个文件，把内容加到系统提示词里。
好处：
- 不用每次对话都重复规则
- 规则可以很长、很详细
- 可以用 Markdown 格式，方便组织
⚡ 重要知识点：规则是热加载的！
规则文件修改后立即生效，不需要重启 OpenCode，也不需要新建会话！
OpenCode 在每次发送消息时都会重新读取规则文件。
三种作用域
OpenCode 支持三种作用域的规则：
| 作用域 | 位置 | 适用场景 |
|---|---|---|
| 全局规则 | ~/.config/opencode/AGENTS.md | 所有项目通用的偏好 |
| 项目规则 | 项目根目录 AGENTS.md | 项目特定的规范 |
| 配置文件 | opencode.json 的 instructions 字段 | 引用多个规则文件 |
规则加载顺序
- 全局
~/.config/opencode/AGENTS.md - 全局
~/.claude/CLAUDE.md（兼容模式） - 项目目录向上查找
AGENTS.md/CLAUDE.md - 配置文件
instructions指定的文件
结果：所有规则都会生效，合并在一起。
跟我做
第 1 步：让 AI 帮你创建全局规则
在 OpenCode 输入框里输入：
帮我创建全局规则文件 ~/.config/opencode/AGENTS.md，内容是：
始终使用简体中文回复你应该看到：AI 会帮你创建目录和文件，并写入规则。
第 2 步：验证规则生效
直接在当前会话输入 hello。你应该看到：AI 用中文回复你。
💡 规则立即生效：因为规则是热加载的，AI 帮你创建文件后，下一条消息就会遵守新规则。
第 3 步：完善你的规则
继续说：
帮我更新全局规则文件 ~/.config/opencode/AGENTS.md，改成：
## 语言和风格
- 始终使用简体中文回复
- 直接回答问题，不要客套话
- 代码注释也用中文
## 代码规范
- 使用 2 空格缩进
- 变量名用驼峰命名（camelCase）
- 函数名用动词开头（如 getUserById）第 4 步：（可选）创建项目规则
在项目目录里启动 OpenCode，然后说：
帮我在项目根目录创建 AGENTS.md，内容是：
# 项目规则
## 技术栈
- 前端：React + TypeScript
- 后端：NestJS
- 数据库：PostgreSQL第 5 步：（可选）用 /init 自动生成项目规则
在 OpenCode 输入：
/init你应该看到：AI 会分析你的项目结构、技术栈、代码风格，自动生成一份 AGENTS.md。
实用规则示例
通用开发规则
markdown
## 工作态度
- 每次工作都要用严谨的工作态度，保证完美的质量标准
## 沟通风格
- 直接输出代码或方案，禁止客套话（"抱歉"、"我明白了"等）
- 除非明确要求，否则不提供代码摘要
## 求真原则（禁止瞎猜）
- 不确定/信息不足时先查证或提问澄清
- 对环境/配置/源码/行为的结论必须有证据
- 回答里把"事实"和"推测/假设"分开写代码质量规则
markdown
## 代码质量原则
- 优先代码可读性，做最简单的修改
- 禁止使用 `eslint-disable` 或 `@ts-ignore` 绕过问题
- 禁止使用 `any` 类型，必须定义明确的类型
- 不要为了向后兼容而保留废弃代码
- 删除未使用的代码，不要注释掉检查点
✅ 全部通过才能继续：
- [ ] 让 AI 创建了
~/.config/opencode/AGENTS.md文件 - [ ] 文件中至少有一条规则
- [ ] 发送消息后，AI 遵守了规则（如用中文回复）
踩坑提醒
| 现象 | 原因 | 解决 |
|---|---|---|
| 规则没生效 | 文件路径错误 | 确认是 ~/.config/opencode/AGENTS.md |
| 部分规则被忽略 | 规则太长，被截断 | 精简规则，只保留重要的 |
| 冲突 | 全局和项目规则矛盾 | 项目规则写得更具体，会覆盖全局 |
下一课预告
下一课我们学习 2.5 环境管理。你会学到：
- 如何查看可用模型列表
- 统计你的 Token 消耗和账单
- 管理你的身份凭证（登录/登出）