Agent Skills › WingedGuardian/GENesis-AGI › genesis-external-client

genesis-external-client

GitHub

定义Codex作为外部客户端调用Genesis MCP服务器的规范，明确会话边界、工具白名单及状态隔离限制。

.agents/skills/genesis-external-client/SKILL.md WingedGuardian/GENesis-AGI

触发场景

需要调用Genesis服务但非其内部会话时处理MCP工具发现与调用策略时

安装

npx skills add WingedGuardian/GENesis-AGI --skill genesis-external-client -g -y

更多选项

非标准路径

npx skills add https://github.com/WingedGuardian/GENesis-AGI/tree/main/.agents/skills/genesis-external-client -g -y

不安装直接使用

npx skills use WingedGuardian/GENesis-AGI@genesis-external-client

指定 Agent (Claude Code)

npx skills add WingedGuardian/GENesis-AGI --skill genesis-external-client -a claude-code -g -y

安装 repo 全部 skill

npx skills add WingedGuardian/GENesis-AGI --all -g -y

预览 repo 内 skill

npx skills add WingedGuardian/GENesis-AGI --list

SKILL.md

Frontmatter

{
    "name": "genesis-external-client",
    "description": "Use when Codex needs Genesis capabilities through MCP without joining Genesis's session lifecycle. Covers tool selection, explicit state changes, and session-boundary limits."
}

Genesis as an external tool client

This Codex conversation is not a Genesis session. It may call the Genesis MCP servers on demand, but Genesis must not register, heartbeat, extract, summarize, or otherwise manage this conversation. The external launcher removes inherited Genesis session identity, provenance, supervision, slot, and trace context before starting either MCP server. In a Git worktree it resolves Genesis's live runtime state through the main checkout rather than creating worktree-local state.

Codex defers MCP schemas until requested. Before calling a Genesis tool that is not already visible, use MCP tool discovery for its exact server.tool name.

The initial Codex surface provides approved health and recall tools only. It does not expose persistent memory writes, task dispatch, browser control, outreach, Discord, recon, campaign management, or session controls. Do not work around this allowlist; expanding it needs a separate capability review.

Do not pass a Codex thread or session identifier to session_charter, session_ledger_*, or other session-bound tools. Those tools operate only on an explicitly identified, existing Genesis session. Never create a synthetic session or charter to make one work.

Use genesis-health for live status and genesis-memory for recall. Recall may update Genesis retrieval-use metadata; this is expected and does not make the conversation a Genesis session.

If a capability requires automatic context injection, transcript extraction, session continuity, or background delivery into this conversation, explain that it is unavailable to an external client. Do not add lifecycle hooks or work around the boundary.