Introduction

DeepSeek Harness (DSH) adopts a plugin-based architecture. When using OpenSpec workflow skills, developers need to manually configure them in DSH’s skill registry. The dsh-openspec plugin solves this integration issue by registering the 12 core OpenSpec workflow skills in the DSH environment and providing a set of command aliases for direct user invocation.

Plugin Positioning

This is a Cordis-based plugin maintained by dragonTalon. It registers OpenSpec workflow skills using standard kebab-case naming, allowing /openspec-xxx commands to work directly through DSH’s skill tools and user invocation injection mechanism.

Core Features

The plugin provides the following capabilities:
1. 12 canonical skills: Registered as skills in the openspec-* format, supporting both model invocation and user invocation.
2. 12 command aliases: Provides /opsx-* command aliases with content identical to the corresponding canonical skills, but restricted to user invocation.
3. No runtime state: Skills are managed through DSH’s skill registry and do not depend on additional runtime state.

Installation and Activation

The plugin depends on the core DSH dependency packages: @deepseek-ai/cordis, @deepseek-ai/dsh-invariants, and @deepseek-ai/dsh-skill.

Install the plugin into a specified profile:

dsh plugin --profile <name> add github:dragonTalon/dsh-openspec

Or add it to a standard Node project:

npm install github:dragonTalon/dsh-openspec

Note: When installing via Git, the plugin is automatically built through the prepare script. If using pnpm, build scripts for Git dependencies are blocked by default. If the build fails, add the package name to the allowBuilds list in the profile’s pnpm-workspace.yaml.

Typical Usage

After installation, it can be used in the following ways:

  • Canonical invocation: /openspec-new-change, /openspec-explore, etc.
  • Alias invocation: /opsx-new, /opsx-explore, etc.

If command aliases are not needed, they can be disabled in configuration:

import * as dshOpenspec from '@dragon-talon/dsh-openspec'

ctx.plugin(dshOpenspec, { aliases: false })

Skill List

The plugin contains the following 12 skills and their corresponding aliases:

Canonical Skill Command Alias Description
openspec-explore /opsx-explore Enter exploration mode to help explore ideas and investigate issues.
openspec-new-change /opsx-new Start a new OpenSpec change using the experimental artifacts workflow.
openspec-continue-change /opsx-continue Continue processing an OpenSpec change by creating the next artifact.
openspec-apply-change /opsx-apply Execute the tasks in an OpenSpec change.
openspec-update-change /opsx-update Revise existing planning artifacts for the change and maintain consistency.
openspec-ff-change /opsx-ff Fast-forward through OpenSpec artifact creation.
openspec-propose /opsx-propose Propose a new change and generate all artifacts in one step.
openspec-sync-specs /opsx-sync Sync the incremental specs of a change to the main specs.
openspec-archive-change /opsx-archive Archive a completed change.
openspec-bulk-archive-change /opsx-bulk-archive Archive multiple completed changes in one step.
openspec-verify-change /opsx-verify Verify that the implementation matches the change artifacts.
openspec-onboard /opsx-onboard Guided onboarding for OpenSpec.

Notes

  • Skill content is generated from the skills/*/SKILL.md files in the OpenSpec repository; the current version is pinned to OpenSpec 1.10.0.
  • Skill content is under the MIT License.

Summary

This plugin provides ready-to-use OpenSpec workflow support for DeepSeek Harness. By standardizing skill registration and offering convenient command aliases, it simplifies the process of implementing OpenSpec workflows in the DSH environment.