Preface¶

When developing agents or tackling multi-step engineering tasks in DSH, a common issue is that steps are not sufficiently controlled: code changes begin before requirements are confirmed, implementation starts before a plan is approved, and there is no unified testing and verification path before implementation is considered complete.

DSH’s plugin ecosystem emphasizes “everything is a plugin.” The community directory is an independent site and should not be interpreted as an official DeepSeek or DeepSeek app store. dsh-engineering-workflow is a workflow plugin within this ecosystem: it adds an “Engineering Workflow” preset to DSH, breaking engineering tasks into five gated stages, and includes a set of workflow skills to support these processes.

Plugin Positioning¶

dsh-engineering-workflow is maintained by 82c86b8z86-stack and is licensed under MIT.

It is an engineering workflow layer for DSH. Once installed, it adds an Engineering Workflow agent preset to DSH. This preset includes five hard-gated phases:

1. requirements clarification
2. plan approval
3. TDD implementation
4. parallel subagent execution
5. verified finishing

The plugin also includes six workflow skills:

workflow-requirements
workflow-planning
workflow-tdd
workflow-subagents
workflow-verification
engineering-workflow

It integrates with DSH’s existing mechanisms, including plan mode and exit_plan_mode, background subagent / subagent_fork, workflow orchestration, goals, and the preset / skill system.

Core Features¶

Adds an Engineering Workflow Preset¶

After installation and synchronization, Engineering Workflow will appear in DSH’s preset picker for new sessions. Selecting this preset loads the corresponding workflow skills along with it.

Provides a Five-Phase Process¶

The plugin organizes engineering tasks into five phases:

• Requirements clarification: workflow-requirements
• Plan approval: workflow-planning
• TDD implementation: workflow-tdd
• Parallel subagent execution: workflow-subagents
• Verification and finishing: workflow-verification

engineering-workflow serves as the main skill, routing tasks to the appropriate phase in non-trivial tasks and maintaining overall process discipline.

Synchronizes Preset Files¶

The plugin synchronizes the preset to:

~/.dsh/.agent-presets/engineering-workflow

Synchronization occurs after a DSH restart and can also be performed manually via the sync script.

Provides Installation Check Scripts¶

The plugin includes the following scripts:

node scripts/verify-install.mjs
node scripts/sync-presets.mjs
node scripts/validate-preset.mjs

Where:

• verify-install.mjs compares the bundled preset with the contents of ~/.dsh/.agent-presets without writing.
• sync-presets.mjs synchronizes the preset in manual or development scenarios without restarting DSH.
• validate-preset.mjs validates the structure of the bundled preset.

Installation and Activation¶

Environment Requirements¶

The runtime must meet the Node engine requirement:

^22.19.0 || >=24.0.0

The plugin also has an optional peer dependency:

@deepseek-ai/dsh-system-prompt ^0.1.0-rc.6

Installation Command¶

Use the DSH plugin command to install into a specific profile:

dsh plugin --profile <name> add github:82c86b8z86-stack/dsh-engineering-workflow

This command adds dsh-engineering-workflow to your specified DSH profile.

Activating the Preset¶

After installation, restart DSH once to allow the host plugin to mount and synchronize the preset:

# Manually sync from within the plugin package directory
node scripts/sync-presets.mjs

Manual synchronization is suitable for scenarios where you do not want to restart DSH. After synchronization, Engineering Workflow will appear in the preset picker for new sessions, and you can select it to create a new session.

If you only want to check the installation status, run:

node scripts/verify-install.mjs

This compares the bundled preset with the contents of ~/.dsh/.agent-presets without writing files.

If you only want to validate the preset structure, run:

node scripts/validate-preset.mjs

Typical Usage¶

Below is a basic usage path.

1. Install the Plugin¶

dsh plugin --profile <name> add github:82c86b8z86-stack/dsh-engineering-workflow

This step adds the plugin to the specified profile.

2. Restart DSH or Manually Sync the Preset¶

After restarting DSH, the plugin will mount and sync the preset to:

~/.dsh/.agent-presets/engineering-workflow

If you prefer not to restart DSH, you can run the following from within the plugin package directory:

node scripts/sync-presets.mjs

3. Create a New Session and Select the Preset¶

In DSH’s preset picker for new sessions, select:

Engineering Workflow

Selecting this preset loads the corresponding engineering workflow preset and the six workflow skills into the session.

4. Advance the Task Through the Phases¶

For a specific task, proceed through the five phases:

1. Use workflow-requirements to clarify requirements.
2. Use workflow-planning to form and approve a plan.
3. Use workflow-tdd to enter TDD implementation.
4. Use workflow-subagents to organize parallel subagent execution.
5. Use workflow-verification for verification and wrapping up.

engineering-workflow ties these phases together to prevent tasks from jumping arbitrarily between stages.

Use Cases and Considerations¶

Who Should Use It¶

Suitable for developers working in DSH who need:

• A clearer requirements clarification process.
• Plan approval before implementation.
• TDD during the implementation phase.
• Parallel subagent execution for sub-tasks.
• Verification before declaring completion.

If you only need basic Q&A or single-step execution, this plugin will add extra process constraints.

Does Not Affect Existing Sessions¶

The plugin does not switch existing sessions or change the default preset. It mainly affects the Engineering Workflow preset selected for new sessions.

System Prompt Timing¶

The workflow guidance system prompt appears in new sessions created after the host plugin is mounted. In other words, the full effect is typically visible in new sessions only after the first DSH restart following installation.

Permissions and Security Considerations¶

This plugin runs as part of DSH and uses the file system, shell, network, and other permissions owned by the current DSH process. Before installation, you should review the source code, scripts, preset files, and license to confirm the behavior meets your security requirements.

License and Attribution¶

The plugin is licensed under MIT. Its preset composition is adapted from the built-in cordis preset in DeepSeek Harness, the workflow methodology is adapted from obra/superpowers, and the host-plugin sync pattern references @linxin666/dsh-liangshen.

Related Links¶

• Community directory: https://www.skillhub.cn/plugins/82c86b8z86-stack/dsh-engineering-workflow
• GitHub: https://github.com/82c86b8z86-stack/dsh-engineering-workflow

Following the steps above, you can install, sync, and enable dsh-engineering-workflow in DSH, allowing new sessions to use a more structured five-phase engineering workflow.