mcpField
O
opsx-workspace-gate

opsx-workspace-gate

github.com/fudesign2008Agent workflows650 installsUpdated 1d ago
Repository

About opsx-workspace-gate

opsx-workspace-gate is a shared skill for OPSX workflows that locates an OpenSpec project root and checks required native skills. It runs these prerequisite gates before workflow orchestration begins.

Key features

  1. 01Locate the OpenSpec project root by priority
  2. 02Verify the openspec/ directory exists
  3. 03Check for four required OPSX skills
  4. 04Read native skill instructions before delegation

Use cases

  1. 01Identify the project root before starting an OPSX workflow
  2. 02Check skill prerequisites before delegating change creation or archiving

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/fudesign2008/open-skills --skill opsx-workspace-gate

After installing, type/opsx-workspace-gatein Claude Code to confirm it loaded.

Details

From the project README

OPSX Workspace Gate

Internal shared skill for OPSX workflows. It establishes an OpenSpec project root and verifies native-skill prerequisites before the host starts its workflow-specific orchestration.

1. Locate the project root

Use this priority order and stop at the first unique result:

  1. The current working directory contains openspec/.
  2. Walk upward from the current edit file and use the first ancestor containing openspec/.
  3. Scan direct children of the current working directory for openspec/.
    • One match: use it.
    • Multiple matches: list candidates and wait for the user to select one.
  4. No match: stop and ask the user to enter an initialized OpenSpec project or run openspec init.

Output 【工程定位结果】目标工程根：<absolute path>. Run subsequent OpenSpec paths, CLI commands, and native-skill delegation from that root; if changing the working directory is unavailable, use absolute paths.

2. Verify the OpenSpec directory

Confirm <project-root>/openspec/ exists. If it does not, stop and instruct the user to run openspec init; do not silently initialize it.

3. Verify native OPSX skills

Search installed skill directories under the project root and require these exact names:

Required skillWorkflow purpose
openspec-new-changeCreate a change
openspec-continue-changeCreate or continue artifacts
openspec-apply-changeImplement checked tasks
openspec-archive-changeArchive a completed change

openspec-verify-change is optional. Legacy or alternate names do not satisfy this gate. If a required skill is missing, stop and direct the user to run openspec init (first setup) or openspec update (refresh skills).

Delegation discipline

  • Before delegating to any native OPSX skill, read that skill's current SKILL.md.
  • CLI commands such as openspec status and openspec validate are allowed tools; they do not replace native skill delegation.
  • Hosts retain stage ordering, Jira/Git operations, retry/change binding, artifact sinks, and all workflow-specific decisions.

Integration guide

An OPSX host declares opsx-workspace-gate as a dependency, loads it for location plus gates, then continues with host-only setup. Do not copy this location algorithm, exact-name table, or delegation rules into the host.

Comments

Markdown supported