关于 opsx-workspace-gate
opsx-workspace-gate 是供 OPSX 工作流使用的共享技能，用于定位 OpenSpec 项目根目录并检查所需原生技能。它在工作流编排开始前执行这些前置门槛。
主要功能
- 01按优先级定位 OpenSpec 项目根目录
- 02验证 openspec/ 目录存在
- 03检查四项必需 OPSX 技能
- 04委派前读取原生技能说明
适用场景
- 01在 OPSX 工作流启动前确定项目根目录
- 02在委派变更创建或归档前检查技能依赖
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/opsx-workspace-gate确认已加载。
详细介绍
OPSX 工作区门禁
OPSX 工作流的内部共享技能。它用于确定 OpenSpec 项目根目录，并在宿主启动特定工作流的编排之前验证原生技能的前置条件。
1. 定位项目根目录
按以下优先级顺序查找，并在找到第一个唯一结果后停止：
- 当前工作目录包含
openspec/。 - 从当前编辑文件向上遍历，使用第一个包含
openspec/的祖先目录。 - 扫描当前工作目录的直接子目录，查找
openspec/。- 一个匹配项：使用该目录。
- 多个匹配项：列出候选项并等待用户选择一个。
- 没有匹配项：停止，并要求用户进入已初始化的 OpenSpec 项目，或运行
openspec init。
输出 【工程定位结果】目标工程根：<absolute path>。后续的 OpenSpec 路径、CLI 命令和原生技能委派均从该根目录执行；如果无法更改工作目录，请使用绝对路径。
2. 验证 OpenSpec 目录
确认 <project-root>/openspec/ 存在。如果不存在，请停止并指示用户运行 openspec init；不要在未告知用户的情况下初始化。
3. 验证原生 OPSX 技能
在项目根目录下搜索已安装的技能目录，并要求以下确切名称：
| 必需技能 | 工作流用途 |
|---|---|
openspec-new-change | 创建变更 |
openspec-continue-change | 创建或继续创建产物 |
openspec-apply-change | 实施已勾选的任务 |
openspec-archive-change | 归档已完成的变更 |
openspec-verify-change 为可选项。旧版或其他名称无法满足此门禁。如果缺少必需技能，请停止并指示用户运行 openspec init（首次设置）或 openspec update（刷新技能）。
委派规范
- 委派给任何原生 OPSX 技能之前，先阅读该技能当前的
SKILL.md。 openspec status和openspec validate等 CLI 命令可作为工具使用；它们不能替代原生技能委派。- 宿主负责保留阶段顺序、Jira/Git 操作、重试／变更绑定、产物存储目标以及所有特定工作流的决策。
集成指南
OPSX 宿主将 opsx-workspace-gate 声明为依赖项，加载它以完成定位和门禁检查，然后继续执行仅限宿主的设置。不要将此定位算法、确切名称表或委派规则复制到宿主中。
评论
支持 Markdown