agent-observe
GitHub提供只读能力以观察Agent家族成员(父、兄弟、子)的状态和近期消息预览,用于发现可达Agent及检查会话状态,不涉及任何会话修改操作。
Trigger Scenarios
Install
npx skills add PrimeIntellect-ai/prime-agent --skill agent-observe -g -y
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()returnscurrentandagents, the full nuclear family: parent, siblings, and direct children, active or not. Each agent carriessessionId, optionalsessionName,relationship(parent/sibling/child),status(running/idle/inactive), the liveactivityof a resident session,isSessionActive, and the counts and message previews known for it:latestMessagefor a live session,firstMessagefor an inactive child. A member with no live session has noactiveSessionIdand no live detail; address it withagent_message.sendusing itsrelationshipplus itssessionName, or itssessionIdwhen the member has no name. For direct children,await rlm.list_subagents()also exposes parent-owned lifecycle handles.await agent_observe.get_agent(target)returnsagent, whereagentcontains one live agent summary.targetis 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 tolimitrecent bounded message previews for the target session.limitmust be 1-50, andmax_charsmust 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


