全部文档

实践指南:写在哪里——决策与案例

同一句话,写进 人格、操作规则、记忆、知识文档或技能 效果不同。按下面问题自测,再对照案例。

来源 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. 工作区 / 智能体知识文档 中的业务口径
  3. 长期记忆 中的个人偏好(勿与 1、2 矛盾;若矛盾,以知识文档与技能为准,并应 更新或删除 过时记忆)

相关模板