---
name: nexus-manager
description: 由 Nexus 主智能体查询或管理 owner scope 内的平台资源，包括 Agent、DM/Room、conversation、Session、其他 Agent workspace 与 Skill。产品配置、Goal、Execution 和 Automation 使用各自专用 Skill，不走本控制面。
scope: main
---

# Nexus Manager

本 Skill 使用 `nexusctl` 控制面，不处理产品配置。Provider、Agent runtime options、偏好、Channel、Connector 与配置化 Skill 绑定使用 `nexus-configuration`；Goal、Execution、Automation 使用各自 round-scoped `nexus` domain。

## 执行契约

- 优先执行宿主注入的 `NEXUSCTL_COMMAND_PATH`；示例中的 `nexusctl` 代表该入口。Bash 使用 `"$NEXUSCTL_COMMAND_PATH" --json ...`，PowerShell 使用 `& "${env:NEXUSCTL_COMMAND_PATH}" --json ...`。只有宿主没有注入且 PATH 已提供正式二进制时才直接写 `nexusctl`。
- 不探测、覆盖或拼接作用域环境变量，不传隐藏的 `--scope-user-id` / `--global-scope`，不搜索源码或 `go run ./cmd/nexusctl`。当前 owner 与 workspace scope 只来自宿主。
- 普通 Agent 在强隔离下不能调用控制面；自己的 workspace 直接使用文件工具。其他资源管理请用户切换到主智能体，不通过数据库、state/runtime 文件或环境变量绕过。
- 所有调用带 `--json` 并作为单独进程执行。成功必须有 `success=true`，再读取 `domain`、`action` 与 `item|items|report`；失败读取结构化 `error.kind/message` 和退出码，不从旧字段或混合 stdout 猜结果。
- 先 list/get 当前状态，再执行一个用户授权的 mutation，最后重新读取验证。删除、卸载、移除成员、覆盖 workspace 或清理历史前精确核对目标和影响范围；没有明确删除意图时不执行破坏性命令。
- 低频参数只对选定的 exact subcommand 运行 `--help`，不要为发现能力加载其他 domain 或凭旧示例补 flag。

## 按资源读取参考

- Agent 资源与账号管理分流：[references/accounts-and-agents.md](references/accounts-and-agents.md)；创建 Agent 必须读取，其中包含头像选择与默认行为模板字段补全流程。
- DM/Room、conversation、Session 与消息历史：[references/rooms-and-sessions.md](references/rooms-and-sessions.md)
- 其他 Agent workspace 文件：[references/workspaces.md](references/workspaces.md)
- Skill 目录、安装、来源更新、卸载与内容编辑分流：[references/skills.md](references/skills.md)

只读取当前资源 domain 的参考，不为一次调用加载完整 `nexusctl` 手册。

密码、token 和密钥不得出现在命令参数、日志、回复或临时文件。用户账号管理使用 `nexus-configuration` 的 `members` 域；密码只在宿主确认卡片中填写，不通过本 CLI 传递。