实践指南:写在哪里——决策与案例
同一句话,写进 人格、操作规则、记忆、知识文档或技能 效果不同。按下面问题自测,再对照案例。
来源 help/guides/where-to-put-your-rules.md
表述:同一句话,写进 人格、操作规则、记忆、知识文档或技能 效果不同。按下面问题自测,再对照案例。
三步决策
1. 是「怎么说」还是「怎么做」?
→ 怎么说 → 人格(SOUL)
→ 怎么做 → 继续 2
2. 是否团队/角色共用、且是稳定业务口径?
→ 是 → 工作区或智能体 **知识文档**
→ 否 → 继续 3
3. 是否每次对话都必须执行的步骤/约束(含工具、技能、日期算法)?
→ 是 → **操作规则(AGENTS)**;接口细节同时在 **技能** 里写清
→ 否 → 是否只关于你个人、且跨会话仍成立?
→ 是 → **长期记忆** 或 **用户画像(USER)**
→ 仅近几天有用 → **日笔记**
→ 待办清单 → **任务(TASKS)**
案例对照表
| 你想表达的内容 | 推荐落点 | 不推荐 | 理由 |
|---|---|---|---|
| 只使用技能内的接口,不要自己编造路径 | 操作规则 + 技能正文 | 人格、长期记忆 | 这是 执行约束,须每轮高优先级生效;技能提供 唯一真相来源 |
| 「以后回答用 bullet,不要长段落」 | 长期记忆(偏好与纠正) | 人格 | 个人偏好,会随对话提炼;也可写在人格若希望 所有用户 同一助手都如此 |
| 「查询时以运行环境里的当前时间为今天」 | 操作规则 | 记忆 | 平台已注入时间;怎么用这个时间 属于操作规则 |
| 「我是后端,前端问题请简短解释」 | 用户画像 或 长期记忆·关于我 | 操作规则 | 稳定身份,不是操作步骤 |
| 「Q2 上线截止 6 月 30 日」 | 长期记忆·项目进展 | 日笔记 | 有明确节点、跨会话有效 |
| 「今天先把登录页改版做完」 | 日笔记 | 长期记忆 | 临时任务 |
| 「报销制度以 wiki 第三章为准」 | 工作区知识文档 | 个人记忆 | 团队共用口径 |
| 「本助手对外称呼客户为『伙伴』」 | 智能体知识文档 或 人格 | 个人记忆 | 角色设定,非用户个人偏好 |
| 「待办:周五前提交测试报告」 | 任务 | 长期记忆 | 清单型跟进 |
深度案例:「别编造接口,只用技能里的」
为什么 不是 人格(SOUL)?
人格管 表达方式。把技术约束只写在 SOUL 里,模型仍可能在「帮忙查数据」时 即兴编造 URL——人格优先级虽高,但 没有给出可执行的替代步骤(先读技能、再 http_request)。
为什么 不是 长期记忆?
记忆适合 你的个人纠正(「上次你就编错了,记住别这样」),且默认 不是全文每轮注入。操作约束应 稳定、完整、每轮可见,放在 操作规则;个人记忆可作为补充,但不能替代 AGENTS。
推荐写法(操作规则 + 技能分工)
操作规则(AGENTS.md)——可整段粘贴后按工作区改名:
## 联网与接口
- **禁止** 自行编造 URL、路径、请求体字段名或示例里的历史日期当作查询范围。
- 需要调业务接口时:**必须先** 找到与本工作区相关的技能说明,仅使用其中声明的
- 基础 URL / 路径
- 方法、必填参数
- 鉴权方式(如 `{{成员密钥名}}`)
- 使用 `http_request` 调用;**仅依据** 工具返回的 JSON 向用户陈述结果。
- 未找到合适技能、或调用失败:向用户说明原因,**不要** 假装已查到数据。
技能正文——写清 具体 接口(见 怎么写好工作区技能)。
可选:若这是你 个人 对 这一只助手 的反复纠正,可在对话中 「记住」 一条 偏好与纠正 类长期记忆,正文含 Why: 与 How to apply:——但仍 不能替代 操作规则。
冲突时谁优先?
- 操作规则 与 技能 中的明确步骤(执行层)
- 工作区 / 智能体知识文档 中的业务口径
- 长期记忆 中的个人偏好(勿与 1、2 矛盾;若矛盾,以知识文档与技能为准,并应 更新或删除 过时记忆)