菜单
How to invoke OpenSpec skills for a Codex-based Houmao managed agent using the $openspec-* command syntax via gateway prompt.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when the user wants to search, fetch, or bulk-collect academic papers, authors, citations, references, recommendations, or Semantic Scholar datasets through direct curl calls to the Semantic Scholar APIs.
Manual invocation only; Imsight-authored command skill for analyzing, deep-inspecting, designing, creating, refactor-migrating, testing, hardening, or formatting agent skills. Use only when the user explicitly invokes imsight-agent-skill-handling or asks to use this exact skill. Its subcommands are help, analyze, deep-inspect, design, create, refactor-migrate, test, harden, and format. Do not invoke implicitly for generic skill creation, skill audits, skill updates, skill-format work, routing from another skill, generic coding tasks, or ordinary use of a domain skill.
Use when building or maintaining a Karpathy-style LLM knowledge base inside the current project, or when deploying the bundled local web viewer for that wiki. Triggers on requests to scaffold, compile, ingest, research, collect, inventory, project, query, lint, audit, or launch an LLM Wiki.
Use when explicitly invoking imsight-reporting, routing from another Imsight skill, or using Imsight context to produce a daily work log from Git commits, staged or unstaged diffs, nested repositories, research-topic artifacts, build records, specifications, or other project evidence.
Use when explicitly invoking imsight-dev-box-network, routing from another Imsight skill, or using Imsight context to configure, audit, repair, or document dev-box networking, SSH tunnels, proxy access, relay access, exposed ports, remote Playwright browser control, systemd user tunnel services, or host-to-host access. Do not use for generic networking tasks without Imsight context.
Use when explicitly asked to use Imsight project design, Imsight SOP, this exact skill, or an Imsight-authored process to scaffold or revise feature planning, define a feature, design use cases, design interfaces or agent skills, manually refine recorded design decisions, or write an implementation handoff.
| name | call-codex-with-openspec-cmd |
| description | How to invoke OpenSpec skills for a Codex-based Houmao managed agent using the $openspec-* command syntax via gateway prompt. |
| license | MIT |
Use this skill when you need to instruct a Codex-based Houmao managed agent to use OpenSpec skills. The correct invocation is via gateway prompt with the $openspec-<skill-name> command prefix.
| Command | Skill | Purpose |
|---|---|---|
$openspec-explore | openspec-explore | Explore openspec/ directory and understand change artifacts |
$openspec-propose | openspec-propose | Create a new OpenSpec change proposal |
$openspec-apply-change | openspec-apply-change | Implement an OpenSpec change |
$openspec-ext-explain | openspec-ext-explain | Create/update Q&A docs under explain/ directory |
$openspec-ext-hack-through-test | openspec-ext-hack-through-test | Propose, revise, or run hack-through-test mode |
$openspec-ext-respond-to-review | openspec-ext-respond-to-review | Read review report and decide open questions |
$openspec-ext-review-plan | openspec-ext-review-plan | Review current OpenSpec change and write report |
$openspec-ext-revise-by-decision | openspec-ext-revise-by-decision | Push review decisions into change artifacts |
houmao-mgr agents gateway prompt \
--agent-name <agent-name> \
--prompt "$openspec-<command> <arguments>"
houmao-mgr agents gateway prompt \
--agent-name hm-worker \
--prompt "$openspec-explore igamenovoer/houmao#60: env vars from launch profiles not propagated to Codex TUI processes"
houmao-mgr agents gateway prompt \
--agent-name hm-worker \
--prompt "$openspec-propose implement-foo-bar"
houmao-mgr agents gateway prompt \
--agent-name hm-worker \
--prompt "$openspec-apply-change openspec/changes/2026-04-30-implement-foo-bar"
houmao-mgr agents gateway prompt \
--agent-name hm-worker \
--prompt "$openspec-ext-respond-to-review openspec/changes/2026-04-30-implement-foo-bar/review/review-20260430-120000.md"
houmao-mgr agents gateway prompt \
--agent-name hm-worker \
--prompt "$openspec-ext-revise-by-decision openspec/changes/2026-04-30-implement-foo-bar"
gateway_health: healthy)openspec/ directoryCheck gateway status before sending:
houmao-mgr agents gateway status --agent-name <agent-name>
Expected:
gateway_health: healthymanaged_agent_connectivity: connectedrequest_admission: opengateway prompt, not agents prompt — the latter bypasses TUI skill loading$ prefix — $openspec-* is the magic trigger--prompt flag, not --messagenot_ready, the TUI may be in modal state — wait or interrupt firsthoumao-agent-messaging — general agent communication patternshoumao-agent-inspect — checking agent liveness and gateway status