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

genesis-external-client

GitHub

定义 Codex 作为 Genesis 外部客户端通过 MCP 调用工具的规范。明确禁止加入会话生命周期,限定工具白名单(如 health、memory),并详细规定 validator 配置文件下的私有跟进与验证写入权限及限制。

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

Trigger Scenarios

需要调用 Genesis MCP 工具但不参与其会话管理 执行外部客户端或 validator 角色的特定工具操作

Install

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

Non-standard path

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

Use without installing

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 ordinary Codex profile provides the approved health and recall floor. The separately qualified validator profile also admits memory_store, private follow_up_create/list/update and pr_verification_close. It has no session ledger, charter, dispatch, browser, outreach, campaign or settings authority. Do not work around either allowlist; another expansion needs its own capability review.

The standalone launcher enforces --external-client on the server as well as the client allowlist. Both the external default and explicit validator profile have separate closed tool sets: external retains5health/8memory tools; validator admits9health/9memory. Direct calls to other tools are rejected before their bodies run; the health bootstrap also skips dispatch queue and campaign initialization. These tool profiles are not authentication or isolation from an operator with full host access.

Validator follow-ups require user_input_needed, a stable request_key for creation and no schedule, pin or session provenance; updates may touch eligible private records from other clients. A public link or pending publication makes a row ineligible. Memory writes retain the existing collection/supersedes interface and its existing partial-failure limits. Use these writes only for authorized work. Verification results are derived from strict evidence and an independent PR number; the server forces preview until post-calibration operator opt-in. A preview discharges nothing. After an uncertain real response, read stored state before retrying; verification attempt counters are not idempotency keys. See docs/reference/codex-validator-writers.md. This skill does not activate the dedicated validator launcher or authorize deployment/calibration.

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.

The project also configures gitnexus through .claude/mcp/run-gitnexus, which enforces the repository's installed-version and Node compatibility pin. Its explicit 15-tool catalog excludes source-editing rename and group-metadata group_sync. The retained tools include raw Cypher and can have incidental cache/recovery effects; this is not a side-effect-free server contract. GitNexus reads a snapshot, so check freshness before relying on it for current code. Linked worktrees use live symbol tools for branch truth rather than indexing another checkout. See docs/reference/codex-gitnexus.md for setup and qualification limits.

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.

The project also wires a local Codex CLI shell action guard for review budgets. It denies actions requiring fresh approval and requests user handoff, without registering a Genesis session or persisting approval receipts. See docs/reference/codex-review-stop.md for activation, tested failures, scope and integration limits; this is not universal client enforcement.

Version History

  • e2e4af0 Current 2026-11-02 15:45

    恢复 validator 写入器功能,增加私有跟进和验证记录能力,修复 stdio 查找边界并共享合并标识。

  • aa71988 2026-10-18 23:13

    新增server-side外部客户端工具配置文件(external/validator),强制在服务端拦截未授权的工具调用;外部健康引导跳过路由和队列初始化。

  • 0b82cd0 2026-09-22 05:49

Same Skill Collection

.claude/skills/build-session/SKILL.md
.claude/skills/cc-update/SKILL.md
.claude/skills/code-intelligence/SKILL.md
.claude/skills/content-publish/SKILL.md
.claude/skills/genesis-development/SKILL.md
.claude/skills/genesis-voice/SKILL.md
.claude/skills/gitnexus/gitnexus-cli/SKILL.md
.claude/skills/gitnexus/gitnexus-debugging/SKILL.md
.claude/skills/gitnexus/gitnexus-exploring/SKILL.md
.claude/skills/gitnexus/gitnexus-guide/SKILL.md
.claude/skills/gitnexus/gitnexus-impact-analysis/SKILL.md
.claude/skills/gitnexus/gitnexus-refactoring/SKILL.md
.claude/skills/shelve/SKILL.md
.claude/skills/spec-session/SKILL.md
.claude/skills/subsystem-map/SKILL.md
.claude/skills/taste/SKILL.md
.claude/skills/unshelve/SKILL.md
.claude/skills/web-research/SKILL.md
config/gstack-patches/codex-SKILL.md
src/genesis/skills/aws-fde-delivery/SKILL.md
src/genesis/skills/browser-automation/SKILL.md
src/genesis/skills/debugging/SKILL.md
src/genesis/skills/evaluate/SKILL.md
src/genesis/skills/forecasting/SKILL.md
src/genesis/skills/integrate-module/SKILL.md
src/genesis/skills/lead-generation/SKILL.md
src/genesis/skills/linkedin-comment-strategy/SKILL.md
src/genesis/skills/linkedin-content-calendar/SKILL.md
src/genesis/skills/linkedin-dm-outreach/SKILL.md
src/genesis/skills/linkedin-hook-writer/SKILL.md
src/genesis/skills/linkedin-post-writer/SKILL.md
src/genesis/skills/linkedin-profile-optimizer/SKILL.md
src/genesis/skills/obstacle-resolution/SKILL.md
src/genesis/skills/onboarding/SKILL.md
src/genesis/skills/osint/SKILL.md
src/genesis/skills/prospect-researcher/SKILL.md
src/genesis/skills/research/SKILL.md
src/genesis/skills/retrospective/SKILL.md
src/genesis/skills/stealth-browser/SKILL.md
src/genesis/skills/triage-calibration/SKILL.md
src/genesis/skills/user_evaluate/SKILL.md
src/genesis/skills/video-processing/SKILL.md
.claude/skills/closing-session/SKILL.md
.claude/skills/deliverable-builder/SKILL.md
.claude/skills/validating-merges/SKILL.md
.claude/skills/voice-master/SKILL.md
.claude/skills/youtube-fetch/SKILL.md
src/genesis/skills/voice-master/SKILL.md

Metadata

Files
0
Version
e2e4af0
Hash
53e8f5a9
Indexed
2026-09-22 05:49

trang chủ - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-11-03 08:46
浙ICP备14020137号-1