context-scope-tags

使用场合：您跨主题聊天并希望有明确的界限以防止主题流失。 标签：[ISO]、[范围]、[全球]、[NOMEM]、[REM]。 （内存标签是信号；持久性取决于代理的内存后端。） 不要使用when：您更喜欢自由形式的对话，其中先前的上下文会自动延续。 输出：复制/粘贴标签备忘单+如何处理当前消息的路由规则。

# Context Scope Tags (Chat Protocol)

A lightweight, portable convention for **explicit context boundaries** in chat.

## Copy/paste cheat sheet (one screen)

- `[ISO: <topic>]` fresh slate for this message (no prior project/topic context)
- `[SCOPE: <topic>]` restrict to one named scope
- `[GLOBAL]` cross-topic reuse allowed (call out what was reused)
- `[NOMEM]` do not store long-term memory from this exchange
- `[REM]` persist preferences/decisions (requires a memory backend; otherwise advisory)

Examples:
- `[ISO: marketing][NOMEM] Draft 5 ad angles for OpenClaw; don't store memory.`
- `[SCOPE: openclaw-mem] Explain why lane A is failing; keep it scoped.`
- `[GLOBAL][REM] Remember: display times in Asia/Taipei unless I say otherwise.`

## Quick start

1) Put one or more tags at the **very start** of your message.
2) Prefer this order: **scope tag(s)** then **memory tag(s)**.
3) Write normally.

Optional: if your assistant supports command-style shortcuts, `/ctx` or `/context_def` can print this cheat sheet.

## Tag parsing rules

- Tags must appear **at the start** of the user's message.
- Multiple tags are allowed.
- Tags do **not** override safety policies, tool access controls, approvals, or platform rules.

### Conflicting tags

Some combinations conflict (for example `[ISO]` + `[GLOBAL]`, or `[REM]` + `[NOMEM]`).

Recommended policy:
- **Last tag wins** for the conflicting dimension.
- If the combination is ambiguous, **ask a clarifying question** rather than guessing.

## Supported tags

### Isolation / scope

- `[ISO: <topic>]` / `[Isolated Context: <topic>]`
  - Treat as a **fresh topic**.
  - Do **not** pull in other conversation/project context unless the user explicitly re-provides it.
  - Allowed implicit carry-over: universal safety rules + a few stable user prefs (timezone, "don't apply changes without approval", etc.).

- `[SCOPE: <topic>]` / `[Scoped Context: <topic>]`
  - Restrict reasoning to the named scope.
  - If missing details inside the scope, ask clarifying questions.

- `[GLOBAL]` / `[Global Context OK]`
  - Cross-topic reuse is allowed.
  - When reusing prior context, call out what was reused.

### Memory intent

- `[NOMEM]` / `[No Memory]`
  - Do not store durable/long-term memories from this exchange.

- `[REM]` / `[Remember]`
  - Signal that preferences/decisions in the message should be persisted.
  - **Dependency note:** actual persistence requires the host agent to have a memory subsystem enabled.

## Default behavior (no tags)

- Be conservative about cross-topic mixing.
- If the user complains about topic bleed, suggest using the tags above.

## Cross-platform / chat-surface notes

- Telegram slash commands cannot contain dashes.
  - Use `/context_def` (underscore), not `/context-def`.
- Slash commands may collide with other bots/skills.
  - If `/ctx` is already taken, use the tag syntax directly (it works everywhere).
- The tags themselves are just text; they work the same on Telegram/Discord/Slack/WhatsApp.
- If a surface auto-formats brackets, it's fine - just keep the tags at the very beginning.

---

## 中文说明

# Context Scope Tags (Chat Protocol)（上下文范围标签 · 聊天协议）

一种轻量、可移植的约定，用于在聊天中**显式划定上下文边界**。

## Copy/paste cheat sheet (one screen)（复制/粘贴速查表 · 一屏）

- `[ISO: <topic>]` 为本条消息开启全新状态（不带任何先前的项目/主题上下文）
- `[SCOPE: <topic>]` 限制在某个命名范围内
- `[GLOBAL]` 允许跨主题复用（需指出复用了什么）
- `[NOMEM]` 不要存储本次交流的长期记忆
- `[REM]` 持久化偏好/决策（需要记忆后端；否则仅为建议性）

示例：
- `[ISO: marketing][NOMEM] Draft 5 ad angles for OpenClaw; don't store memory.`
- `[SCOPE: openclaw-mem] Explain why lane A is failing; keep it scoped.`
- `[GLOBAL][REM] Remember: display times in Asia/Taipei unless I say otherwise.`

## Quick start（快速开始）

1) 将一个或多个标签放在消息的**最开头**。
2) 推荐此顺序：先**范围标签**，再**记忆标签**。
3) 正常书写。

可选：如果你的助手支持命令式快捷方式，`/ctx` 或 `/context_def` 可以打印此速查表。

## Tag parsing rules（标签解析规则）

- 标签必须出现在用户消息的**开头**。
- 允许使用多个标签。
- 标签**不会**覆盖安全策略、工具访问控制、审批或平台规则。

### Conflicting tags（冲突标签）

某些组合会冲突（例如 `[ISO]` + `[GLOBAL]`，或 `[REM]` + `[NOMEM]`）。

推荐策略：
- 对于冲突的维度，**最后一个标签优先**。
- 如果组合含义不明，**先提出澄清问题**而非猜测。

## Supported tags（支持的标签）

### Isolation / scope（隔离 / 范围）

- `[ISO: <topic>]` / `[Isolated Context: <topic>]`
  - 视为一个**全新主题**。
  - **不要**引入其他对话/项目上下文，除非用户明确重新提供。
  - 允许隐式延续：通用安全规则 + 少量稳定的用户偏好（时区、“未经批准不应用更改”等）。

- `[SCOPE: <topic>]` / `[Scoped Context: <topic>]`
  - 将推理限制在命名范围内。
  - 若范围内缺少细节，提出澄清问题。

- `[GLOBAL]` / `[Global Context OK]`
  - 允许跨主题复用。
  - 复用先前上下文时，指出复用了什么。

### Memory intent（记忆意图）

- `[NOMEM]` / `[No Memory]`
  - 不要存储本次交流的持久/长期记忆。

- `[REM]` / `[Remember]`
  - 表示消息中的偏好/决策应被持久化。
  - **依赖说明：** 实际的持久化需要宿主代理启用记忆子系统。

## Default behavior (no tags)（默认行为 · 无标签）

- 对跨主题混用保持保守。
- 如果用户抱怨主题串扰，建议使用上述标签。

## Cross-platform / chat-surface notes（跨平台 / 聊天界面说明）

- Telegram 斜杠命令不能包含连字符。
  - 使用 `/context_def`（下划线），而非 `/context-def`。
- 斜杠命令可能与其他机器人/技能冲突。
  - 如果 `/ctx` 已被占用，直接使用标签语法（它在任何地方都有效）。
- 标签本身只是文本；在 Telegram/Discord/Slack/WhatsApp 上行为一致。
- 如果某个界面会自动格式化方括号，没关系——只要把标签保持在最开头即可。