OpenClaw

subagent-isolation-guard

固化子代理物理隔离与语义路由旁路。防止跨代理上下文污染及由于语义路由导致的子代理切模/重置问题。

halfmoon820 来源安装数☆ 0 仓库 Starsv1.0.0

查看来源 ↗安装与使用 SKILL.md ↗

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。

SkillHub CLI

skillhub install halfmoon82/subagent-isolation-guard

打开来源仓库，查看说明和兼容环境后，按来源提供的命令或步骤安装。

将来源链接提供给你的 Agent，让它先读取说明、核对依赖，并向你说明将执行的安装步骤。

查看来源 ↗使用指南

技能说明

🛡️ Subagent Isolation Guard

固化子代理物理隔离与语义路由旁路。

🎯 解决的问题

上下文污染：防止不同子代理共享同一个 workspace 导致文件读写冲突和上下文干扰。
路由递归/切模：防止主代理的语义路由逻辑应用到子代理会话，导致子代理被强制切换模型或清空上下文。

🛠️ 核心机制

1. 物理隔离 (Workspace Isolation)

所有子代理必须配置独立的 agentDir：

agents/pm/workspace/
agents/architect/workspace/
...

2. 语义路由旁路 (Routing Bypass)

在 semantic-webhook-server.py 中通过 session_key 特征码检测实现自动旁路：

识别特征：:subagent:
处理动作：直接返回 continue，不注入声明，不执行模型建议。

📝 固化规则 (AGENTS.md)

在创建或修改子代理时，必须确保：

allowAgents 列表完整。
每个子代理都有明确的、不重叠的 agentDir。
子代理会话 ID 必须包含 :subagent: 标识。

来源信息

Source: github
Repository: openclaw/skills
Path: skills/halfmoon82/subagent-isolation-guard
Version: 1.0.0
Commit: bd3fa909a02dd49b64beb4ce10937482eba58aa8
分类来源: rules
状态: active
可见性: public

这些信息来自收录时的来源分析，可能滞后；使用前请核对最新来源文件。

来源内容

SKILL.md

# 🛡️ Subagent Isolation Guard

固化子代理物理隔离与语义路由旁路。

## 🎯 解决的问题

1. **上下文污染**：防止不同子代理共享同一个 workspace 导致文件读写冲突和上下文干扰。
2. **路由递归/切模**：防止主代理的语义路由逻辑应用到子代理会话，导致子代理被强制切换模型或清空上下文。

## 🛠️ 核心机制

### 1. 物理隔离 (Workspace Isolation)
所有子代理必须配置独立的 `agentDir`：
- `agents/pm/workspace/`
- `agents/architect/workspace/`
- ...

### 2. 语义路由旁路 (Routing Bypass)
在 `semantic-webhook-server.py` 中通过 `session_key` 特征码检测实现自动旁路：
- 识别特征：`:subagent:`
- 处理动作：直接返回 `continue`，不注入声明，不执行模型建议。

## 📝 固化规则 (AGENTS.md)

在创建或修改子代理时，必须确保：
- `allowAgents` 列表完整。
- 每个子代理都有明确的、不重叠的 `agentDir`。
- 子代理会话 ID 必须包含 `:subagent:` 标识。

搜索