[Bug Report] prompts and skills are not exact compatible with commands like "/opsx-new" in version 1.1.1 #727

Activity

1. 21st-connector commented on Feb 19, 2026

   

   21st-connectorBot

   on Feb 19, 2026 – with 21st - Connector

   Last edited by 21st-connector

   Contributor

   More actions

   Task completed.

   Comment posted successfully on issue #727: #727 (comment)

   Here's a summary of what the analysis found:

   Root cause: Commit 697738b added a transformToHyphenCommands() utility to convert /opsx: → /opsx-, but it was only wired up for the OpenCode adapter. The 10 workflow template source files in src/core/templates/workflows/ and 3 CLI output files still contain the old colon-based /opsx: format, which means all other tool adapters (Claude, Cursor, Codex, etc.) emit stale references.

   Scope: ~441 occurrences across ~73 files, with the most impactful being the 10 workflow templates and 3 CLI output files (init.ts, update.ts, welcome-screen.ts).

   Related issues: #717 and #723 likely share the same root cause.

   Recommended fix: Directly update all /opsx: → /opsx- in the template source files (Option A), rather than adding runtime transforms everywhere.

   ---

   View full conversation

   Powered by 1Code
2. 21st-connector commented on Feb 19, 2026

   

   21st-connectorBot

   on Feb 19, 2026 – with 21st - Connector

   Contributor

   More actions

   Issue Analysis

   This is a confirmed bug. The v1.1.1 release introduced a transformToHyphenCommands() utility to convert /opsx: → /opsx- references, but it was only applied to the OpenCode adapter. The source workflow templates and CLI output still contain the old colon-based /opsx: format.

   Root Cause

   Commit 697738b (fix(opencode): transform command references from colon to hyphen format (#626)) added the transformation utility at src/utils/command-references.ts:18-19:

   export function transformToHyphenCommands(text: string): string {
     return text.replace(/\/opsx:/g, '/opsx-');
   }

   However, this transform is only called from the OpenCode adapter at src/core/command-generation/adapters/opencode.ts:25. The underlying workflow template source files still use the colon format, so all other tool adapters emit the old /opsx: references.

   Affected Files

   Workflow templates (10 files in src/core/templates/workflows/) — these are the source of truth for all generated skill/command content:

   File	Occurrences	Example Lines
   onboard.ts	~25	Lines 480-532
   explore.ts	~11	Lines 100, 206, 256, 273, 306, 400, 452
   apply-change.ts	~5	Lines 26, 172, 183, 206, 276
   continue-change.ts	~3	Lines 134, 168, 212
   new-change.ts	~3	Lines 90, 142, 148
   ff-change.ts	~3	Lines 85, 117, 187
   bulk-archive-change.ts	~2	Lines 233, 480
   archive-change.ts	~1	Line 130
   sync-specs.ts	~1	Line 156
   verify-change.ts	~1	Line 184

   CLI output (user-facing messages still show old format):

   File	Lines	Content
   src/core/init.ts	574-576	'/opsx:new', '/opsx:continue', '/opsx:apply'
   src/core/update.ts	162-164	Same three commands
   src/ui/welcome-screen.ts	25, 28-30	Welcome screen shows /opsx:* commands

   Total: ~73 files affected, ~441 occurrences of /opsx: across the codebase (including docs and specs).

   Related Issues

   • [Bug] Invoking /opsx-new in Factory Droid returns error #717 — [Bug] Invoking /opsx-new in Factory Droid returns error — likely shares the same root cause (generated files reference /opsx:new while the tool expects /opsx-new)
   • /prompt invocation broken in Codex while $skill works #723 — /prompt invocation broken in Codex while $skill works — potentially related to prompt/command format inconsistencies

   Suggested Fix Approach

   There are two possible strategies:

   Option A — Update templates at the source (recommended):
   Replace all /opsx: references with /opsx- directly in the 10 workflow template files and 3 CLI output files. This is the cleanest approach since the colon format is now deprecated.

   Option B — Apply transformation universally:
   Extend the transformToHyphenCommands() call to generateSkillContent() in src/core/shared/skill-generation.ts:106-128 and to the command generation pipeline, so all adapters receive transformed content. This would require also updating the CLI output strings separately.

   Option A is simpler and avoids the runtime overhead of regex transformations on every generated file.

   For Users — Workaround

   Until this is fixed, running openspec update after upgrading to v1.1.1 should regenerate skill files. However, since the templates themselves contain the old format, the regenerated files will still have /opsx: references unless the OpenCode adapter is being used (which applies the transform).
3. clay-good

   added

   bugSomething isn't workingSomething isn't working

   on Jun 29, 2026
4. clay-good

   added a commit that references this issue on Jul 28, 2026

   docs: make every invocation reference match what OpenSpec generates

   ...

   4e5e358
5. clay-good

   closed this as completedin #1471on Jul 28, 2026
6. Patodo

   added a commit that references this issue on Jul 28, 2026

   fix(adapters): reference slash commands by the names each tool regist…

   ...

   This issue will close once commit 9a937cb is merged into the 'main' branch.

   9a937cb