agent-observe

GitHub

提供只读能力以观察Agent家族成员(父、兄弟、子)的状态和近期消息预览,用于发现可达Agent及检查会话状态,不涉及任何会话修改操作。

packages/coding-agent/skills/agent-observe/SKILL.md PrimeIntellect-ai/prime-agent

Trigger Scenarios

需要查看当前Agent的子代理或兄弟代理列表 需要检查特定Agent的会话状态或最近消息内容

Install

npx skills add PrimeIntellect-ai/prime-agent --skill agent-observe -g -y
More Options

Non-standard path

npx skills add https://github.com/PrimeIntellect-ai/prime-agent/tree/main/packages/coding-agent/skills/agent-observe -g -y

Use without installing

npx skills use PrimeIntellect-ai/prime-agent@agent-observe

指定 Agent (Claude Code)

npx skills add PrimeIntellect-ai/prime-agent --skill agent-observe -a claude-code -g -y

安装 repo 全部 skill

npx skills add PrimeIntellect-ai/prime-agent --all -g -y

预览 repo 内 skill

npx skills add PrimeIntellect-ai/prime-agent --list

SKILL.md

Frontmatter
{
    "name": "agent-observe",
    "description": "Read-only roster and observation of an agent's parent, siblings, and direct children. Use to discover reachable agents and to inspect family status and bounded recent-message previews without mutating sessions."
}

Agent Observe

Observe the current agent's nuclear family through the local daemon: parent, siblings, direct children, and self. list_agents is the one family roster and covers every member agent_message.send can reach. get_agent and recent_messages hydrate an inactive child before reading it. They cannot read a root sibling that has no live session in this worker. This skill is read-only: it can list family sessions, inspect one session, and fetch bounded recent message previews. It cannot prompt, steer, clear, kill, rename, or otherwise mutate another session.

Call directly from the kernel:

children = await rlm.list_subagents()
child = next((item for item in children if item.active_session_id), None)
if child is not None:
    worker = await agent_observe.get_agent(child.session_name)
    recent = await agent_observe.recent_messages(child.session_name, limit=6)
    # Deletion is a parent-owned RLM operation, not an observe mutation:
    await rlm.delete_subagent(child)

API

  • await agent_observe.list_agents() returns current and agents, the full nuclear family: parent, siblings, and direct children, active or not. Each agent carries sessionId, optional sessionName, relationship (parent/sibling/child), status (running/idle/inactive), the live activity of a resident session, isSessionActive, and the counts and message previews known for it: latestMessage for a live session, firstMessage for an inactive child. A member with no live session has no activeSessionId and no live detail; address it with agent_message.send using its relationship plus its sessionName, or its sessionId when the member has no name. For direct children, await rlm.list_subagents() also exposes parent-owned lifecycle handles.
  • await agent_observe.get_agent(target) returns agent, where agent contains one live agent summary. target is resolved like other live-session selectors: active id, session id/name, or unambiguous suffix.
  • await agent_observe.recent_messages(target, limit=8, max_chars=800) returns up to limit recent bounded message previews for the target session. limit must be 1-50, and max_chars must be 80-2000.

Safety

  • This skill is read-only and exposes no mutation commands.
  • Targets outside the nuclear family are rejected; transcript reads follow the same family rule as messaging.
  • Message access is bounded by count and per-message character limit.
  • Prefer status and recent previews for orchestration. Ask the user before using observed context to steer or message another session.

Version History

  • cd1f215 Current 2026-09-27 11:29

    重构了agent-observe技能,将家族状态与实时活动分离;修正了类型定义、配置选择器退出键映射及相关文档错误。

  • 1eee293 2026-09-11 13:27

    将双代理名册合并为单一入口,统一家庭发现逻辑;修正观察读取范围说明,限制名册预览大小。

  • bc0fa76 2026-08-27 09:01

Same Skill Collection

packages/coding-agent/skills/agent-message/SKILL.md
packages/coding-agent/skills/attach-image/SKILL.md
packages/coding-agent/skills/compact/SKILL.md
packages/coding-agent/skills/edit/SKILL.md
packages/coding-agent/skills/goal/SKILL.md
packages/coding-agent/skills/linear/SKILL.md
packages/coding-agent/skills/mcp/SKILL.md
packages/coding-agent/skills/notion/SKILL.md
packages/coding-agent/skills/prime-intellect/SKILL.md
packages/coding-agent/skills/refine/SKILL.md
packages/coding-agent/skills/rlm-heartbeat/SKILL.md
packages/coding-agent/skills/skill-creator/SKILL.md
packages/coding-agent/skills/websearch/SKILL.md
packages/coding-agent/examples/extensions/dynamic-resources/SKILL.md

Metadata

Files
0
Version
cd1f215
Hash
6229624c
Indexed
2026-08-27 09:01

Home - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-09-27 17:09
浙ICP备14020137号-1