Introduction

The core philosophy of DeepSeek Harness (DSH) is “everything is a plugin.” In agent development workflows, starting directly from code can easily lead to vague requirements or implementations that deviate from expectations. The DSH plugin dsh-spec provides a set of Spec-Driven Development (SDD) skills that reverses the development order: write the specification first, then write the code, and finally perform acceptance.

Plugin Overview

This plugin is maintained by rongyishuaige7 and is a single package containing three skills. It does not provide code generation functionality; instead, it provides the ability to converge an Idea into an executable Spec, and then transform the Spec into implementation and acceptance criteria.

Core Features

The plugin includes three independent skills, triggered by natural language.

dsh-spec-new: From Idea to Spec

Use this skill when you need to start a new project or requirement change. Trigger phrases include “Help me make an X,” “Start a new project,” “Write the spec first,” or “The requirements changed.” It generates a specs/ directory and writes requirements.md (including Given/When/Then acceptance criteria), design.md (design ideas), and tasks.md (an ordered list of tasks to execute).

dsh-spec-implement: From Spec to Code

Use this skill after the specification is confirmed. Trigger phrases include “Start implementation,” “Implement according to the spec,” or “Continue implementation.” It reads tasks.md, executes the tasks in order, and writes the implementation progress back to the Spec.

dsh-spec-validate: From Spec to Acceptance

Use this skill when you need to verify whether the implementation meets expectations. Trigger phrases include “Acceptance,” “Test it,” or “Validate.” It converts acceptance criteria into runnable checks and generates specs/validation.md.

Installation and Enablement

Before installing, ensure the environment meets the dependency requirements:
* Node.js >= 22
* @deepseek-ai/cordis (^4.0.1)

The installation command is as follows:

dsh plugin --profile <name> add @rongyi7/dsh-spec

Note: If installing via Git, the repository must include a prepare build script.

Typical Usage

In DSH, follow these steps:

  1. Define requirements: Input “Help me make a file sharing website.” The plugin creates a specs/ directory and fills in requirements.md, design.md, and tasks.md.
  2. Execute implementation: Input “Start implementation.” The plugin generates code in the order specified in tasks.md.
  3. Execute acceptance: Input “Acceptance.” The plugin generates specs/validation.md for checking against the acceptance criteria.

Applicable Scenarios and Notes

This plugin is suitable for developers who need to clarify specifications before development and want to keep a single source of truth (the Spec). When using it, please note:
* The plugin runs with the permissions of the current DSH process.
* It is recommended to review the source code and license before installing.
* Community directories (such as skillhub.cn) are independent sites and have no official affiliation with DeepSeek or High-Flyer.

Conclusion

Spec-Driven Development (SDD) makes agent development more controllable. dsh-spec maintains three files under the specs/ directory, implementing a closed loop from requirements to acceptance. For more details, refer to its GitHub repository.