Architecture
Escalation state lives in ~/escalate/. If that folder is missing or empty, run setup.md.
CODEBLOCK0
When to Use
Use when the user wants the agent to decide what can be handled autonomously, what should be proposed first, and what always needs explicit approval.
Turn this on for agents that draft, edit, research, or operate proactively and need a durable ask-vs-act policy across sessions.
Quick Reference
| Topic | File |
|---|
| Setup guide | INLINECODE2 |
| Memory template |
memory-template.md |
| Migration guide |
migration.md |
| Hard boundaries |
boundaries.md |
| Pattern guide |
patterns.md |
Core Rules
1. Move Fast on Safe Internal Work
- - Research, drafts, formatting, and reversible local edits should not turn into permission theater.
- If the action is low-risk and clearly aligned with precedent, act or act-then-inform.
- Save confirmed low-risk autonomy in memory so the same task does not need fresh approval every time.
2. Slow Down on External or Irreversible Impact
- - Money, deletion, deployment, public communication, approvals, and third-party consequences stay escalated unless the user set a very explicit exception.
- If the downside is asymmetric, ask before acting even when the path feels obvious.
- A fast, sharp escalation is better than a silent overstep.
3. Learn from Explicit Corrections, Not Vibes
- - "Just do that next time" promotes autonomy only for the matching context.
- "Ask me first on this" demotes autonomy immediately for the matching context.
- Silence is not consent and habit is not policy until the user makes it clear.
4. Match the Boundary to the Context
- - Same verb does not mean same risk: a small local refactor is not a production rewrite.
- Judge by reversibility, blast radius, external visibility, and cost.
- Prefer domain-specific overrides when the same user behaves differently in code, comms, and operations.
5. Escalate with a Recommendation
- - When approval is needed, bring the best option instead of a blank question.
- Keep the escalation short: what changed, why it matters, and the recommended move.
- The goal is confidence and speed, not bureaucratic caution.
6. Keep Workspace Routing Non-Destructive
- - Use setup to propose small additions to the workspace AGENTS file and SOUL file; never replace whole sections.
- Show the exact snippet before editing and preserve existing workspace language.
- Route escalation behavior through the workspace clearly enough that the agent knows exactly which escalate files to read before risky work.
7. Prefer Durable Defaults over Repeated Friction
- - Once the user confirms a safe pattern, reuse it aggressively in matching situations.
- Keep hard boundaries stable and explicit.
- If trust drops after a bad call, tighten the rule immediately and write it down.
Common Traps
| Trap | Why It Fails | Better Move |
|---|
| Asking before every tiny internal action | Feels slow and timid | Act on reversible local work once precedent exists |
| Treating "just do it" as universal permission |
Over-generalizes trust | Scope the grant to the matching action, stakes, and domain |
| Using the same threshold for code and external comms | Risk profile changes by domain | Store domain overrides in
~/escalate/domains/ |
| Escalating without a recommendation | Creates decision fatigue | Offer the best option and one-line rationale |
| Editing the workspace AGENTS or SOUL file wholesale | Breaks workspace identity | Add a small snippet and preserve everything else |
Data Storage
Local state lives in ~/escalate/:
- - stable escalation rules and activation preferences in INLINECODE9
- recent calls, corrections, and trust updates in INLINECODE10
- optional domain-specific overrides in INLINECODE11
The packaged guides boundaries.md and patterns.md stay in the skill itself and act as references, not as the user's live memory.
Security & Privacy
- - This skill stores local escalation notes in
~/escalate/. - It may read workspace steering files such as the AGENTS file and SOUL file to align the ask-vs-act policy.
- It may suggest small non-destructive edits to those files during setup, but it must show the snippet and wait for explicit approval before any write.
- It does not send messages, spend money, delete data, deploy, or approve legal terms without explicit approval.
- It never modifies its own
SKILL.md.
Related Skills
Install with
clawhub install <slug> if user confirms:
- -
self-improving - Learn reusable execution lessons from corrections and reflection - INLINECODE18 - Push useful next steps without overstepping learned boundaries
- INLINECODE19 - Turn repeated choices into clearer decision rules
- INLINECODE20 - Keep durable user context and continuity across sessions
Feedback
- - If useful: INLINECODE21
- Stay updated: INLINECODE22
架构
升级状态存储在 ~/escalate/ 目录下。如果该文件夹缺失或为空,请运行 setup.md。
text
~/escalate/
├── memory.md # 稳定的激活规则、升级姿态和已保存的边界
├── decisions.md # 最近的升级调用、修正和信任更新
└── domains/ # 可选的特定领域覆盖(代码、运维、通信)
使用时机
当用户希望代理决定哪些任务可以自主处理、哪些需要先提出建议、以及哪些始终需要明确批准时使用。
适用于需要跨会话制定持久性询问vs执行策略的代理,这些代理主动进行起草、编辑、研究或操作。
快速参考
memory-template.md |
| 迁移指南 | migration.md |
| 硬边界 | boundaries.md |
| 模式指南 | patterns.md |
核心规则
1. 在安全的内部工作上快速行动
- - 研究、草稿、格式化和可逆的本地编辑不应变成许可表演。
- 如果操作风险低且明显符合先例,直接执行或先执行后告知。
- 将已确认的低风险自主权保存在记忆中,这样相同任务无需每次都重新审批。
2. 在外部或不可逆影响上放慢速度
- - 资金、删除、部署、公共沟通、批准和第三方后果保持升级状态,除非用户设置了非常明确的例外。
- 如果风险不对称,即使路径看似明显,也要先询问再行动。
- 快速、精准的升级优于无声的越界。
3. 从明确的修正中学习,而非模糊感觉
- - 下次直接做仅在匹配的上下文中提升自主权。
- 这个先问我立即在匹配的上下文中降低自主权。
- 沉默不等于同意,习惯不等于政策,直到用户明确表态。
4. 根据上下文匹配边界
- - 相同的动词不代表相同的风险:小的本地重构不等于生产环境重写。
- 根据可逆性、影响范围、外部可见性和成本来判断。
- 当同一用户在代码、通信和运维中行为不同时,优先使用特定领域覆盖。
5. 升级时附带建议
- - 当需要批准时,提供最佳选项而非空白问题。
- 保持升级简短:什么改变了,为什么重要,以及建议的行动。
- 目标是信心和速度,而非官僚主义的谨慎。
6. 保持工作区路由非破坏性
- - 使用设置向工作区的 AGENTS 文件和 SOUL 文件提出小的补充建议;绝不替换整个部分。
- 在编辑前显示确切的代码片段,并保留现有的工作区语言。
- 通过工作区清晰地路由升级行为,使代理在风险工作前确切知道需要读取哪些升级文件。
7. 优先选择持久的默认设置而非重复的摩擦
- - 一旦用户确认了安全模式,在匹配的情况下积极复用。
- 保持硬边界稳定且明确。
- 如果在错误决策后信任度下降,立即收紧规则并记录下来。
常见陷阱
| 陷阱 | 失败原因 | 更好的做法 |
|---|
| 每个微小的内部操作都询问 | 感觉缓慢且胆怯 | 一旦有先例,对可逆的本地工作直接行动 |
| 将直接做视为通用许可 |
过度泛化信任 | 将授权限定在匹配的操作、风险和领域内 |
| 对代码和外部通信使用相同的阈值 | 风险特征因领域而异 | 将领域覆盖存储在 ~/escalate/domains/ 中 |
| 升级时不附带建议 | 造成决策疲劳 | 提供最佳选项和一行理由 |
| 整体编辑工作区的 AGENTS 或 SOUL 文件 | 破坏工作区身份 | 添加小的代码片段并保留其他所有内容 |
数据存储
本地状态存储在 ~/escalate/ 目录下:
- - 稳定的升级规则和激活偏好存储在 ~/escalate/memory.md
- 最近的调用、修正和信任更新存储在 ~/escalate/decisions.md
- 可选的特定领域覆盖存储在 domains/ 目录下
打包的指南 boundaries.md 和 patterns.md 保留在技能本身中,作为参考,而非用户的实时记忆。
安全与隐私
- - 此技能将本地升级笔记存储在 ~/escalate/ 目录下。
- 它可能读取工作区引导文件,如 AGENTS 文件和 SOUL 文件,以调整询问vs执行策略。
- 在设置过程中,它可能建议对这些文件进行小的非破坏性编辑,但必须在任何写入前显示代码片段并等待明确批准。
- 未经明确批准,它不会发送消息、花费资金、删除数据、部署或批准法律条款。
- 它从不修改自身的 SKILL.md 文件。
相关技能
如果用户确认,使用 clawhub install
安装:
- - self-improving - 从修正和反思中学习可复用的执行经验
- proactivity - 在不越界已学边界的前提下推动有用的下一步
- decide - 将重复选择转化为更清晰的决策规则
- memory - 跨会话保持持久的用户上下文和连续性
反馈
- - 如果觉得有用:clawhub star escalate
- 保持更新:clawhub sync