前言¶

在 DSH 中做智能体开发或多步工程任务时，常见的问题是步骤不够受控：需求还没确认就开始改代码，计划没有批准就进入实现，实现完成前也没有统一的测试与验证路径。

DSH 的插件生态强调「一切皆插件」，社区目录是独立站点，不应理解为 DeepSeek 或幻方官方应用商店。dsh-engineering-workflow 是这个生态里的一个工作流插件：它为 DSH 增加一个「工程工作流」预设，把工程任务拆成五个有门槛的阶段，并附带一组 workflow skills 来承载这些流程。

插件定位¶

dsh-engineering-workflow 由 82c86b8z86-stack 维护，许可证为 MIT。

它是一个面向 DSH 的工程工作流层，安装后会为 DSH 增加一个 工程工作流 (Engineering Workflow) agent preset。该预设包含五个 hard-gated phases：

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

插件还包含六个 workflow skills：

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

它会与 DSH 的既有机制配合，包括 plan mode 与 exit_plan_mode、background subagent / subagent_fork、workflow orchestration、goals，以及 preset / skill 系统。

核心功能¶

增加工程工作流预设¶

安装并同步后，DSH 的新建会话预设选择器中会出现 工程工作流。选择该预设后，对应的 workflow skills 会随预设一起加载。

提供五阶段流程¶

插件把工程任务组织为五个阶段：

• 需求澄清：workflow-requirements
• 计划批准：workflow-planning
• TDD 实现：workflow-tdd
• 并行子代理执行：workflow-subagents
• 验证收尾：workflow-verification

engineering-workflow 作为主 skill，用于在 non-trivial 任务中把任务路由到对应阶段，并维持整套流程纪律。

同步预设文件¶

插件会把预设同步到：

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

同步发生在 DSH 重启后，也可以通过同步脚本手动执行。

提供安装检查脚本¶

插件提供以下脚本：

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

其中：

• verify-install.mjs 用于比较 bundled preset 与 ~/.dsh/.agent-presets 中的内容，不进行写入。
• sync-presets.mjs 用于在不重启 DSH 的手动或开发场景中同步预设。
• validate-preset.mjs 用于校验 bundled preset 的结构。

安装与启用¶

环境要求¶

运行时需要满足 Node engine 要求：

^22.19.0 || >=24.0.0

插件还有一个可选 peer dependency：

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

安装命令¶

使用 DSH 插件命令安装到指定 profile：

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

这条命令会把 dsh-engineering-workflow 加入你指定的 DSH profile。

启用预设¶

安装后，重启一次 DSH，让 host plugin 挂载并同步预设：

# 在插件包目录中手动同步
node scripts/sync-presets.mjs

手动同步适用于不重启 DSH 的场景。同步后，新建会话的 preset picker 中会出现 工程工作流，可以选择它创建新会话。

如果只想检查安装状态，可以运行：

node scripts/verify-install.mjs

它会将 bundled preset 与 ~/.dsh/.agent-presets 中的内容进行比较，不写入文件。

如果只想校验预设结构，可以运行：

node scripts/validate-preset.mjs

典型用法¶

下面是一个基础使用路径。

1、安装插件¶

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

这一步把插件加入指定 profile。

2、重启 DSH 或手动同步预设¶

重启 DSH 后，插件会挂载并同步预设到：

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

如果不想重启 DSH，也可以在插件包目录中运行：

node scripts/sync-presets.mjs

3、创建新会话并选择预设¶

在 DSH 的新建会话 preset picker 中选择：

工程工作流

选择该预设后，会话会加载对应的工程工作流预设和六个 workflow skills。

4、按阶段推进任务¶

在具体任务中，可以按照五个阶段推进：

1. 使用 workflow-requirements 澄清需求。
2. 使用 workflow-planning 形成并批准计划。
3. 使用 workflow-tdd 进入 TDD 实现。
4. 使用 workflow-subagents 组织并行子代理执行。
5. 使用 workflow-verification 做验证和收尾。

engineering-workflow 负责把这些阶段串起来，避免任务在阶段之间随意跳转。

适用场景与注意¶

适合谁用¶

适合在 DSH 中做以下工作的开发者：

• 需要更明确的需求澄清流程。
• 希望先批准计划，再进入实现。
• 希望在实现阶段使用 TDD。
• 需要在任务中拆分子代理并行执行。
• 希望在完成声明前先做验证。

如果你只是希望普通问答或单步执行，这个插件会增加额外的流程约束。

不影响现有会话¶

插件不会切换已有会话，也不会改变默认预设。它主要影响新建会话中选择的 工程工作流 预设。

系统提示出现时机¶

workflow guidance 的系统提示会在 host plugin 挂载后创建的新会话中出现。也就是说，通常要在安装后第一次 DSH 重启之后，新建会话才会看到完整效果。

权限与安全注意¶

该插件会作为 DSH 的一部分运行，使用当前 DSH 进程拥有的文件系统、shell、网络等权限。安装前应检查源码、脚本、预设文件和许可证，确认其行为符合你的安全要求。

许可证与来源¶

插件许可证为 MIT。它的预设组合改编自 DeepSeek Harness 内置 cordis preset，工作流方法改编自 obra/superpowers，host-plugin 同步模式参考 @linxin666/dsh-liangshen。

相关链接¶

• 社区目录：https://www.skillhub.cn/plugins/82c86b8z86-stack/dsh-engineering-workflow
• GitHub：https://github.com/82c86b8z86-stack/dsh-engineering-workflow

经过上面的步骤，你可以在 DSH 中安装、同步并启用 dsh-engineering-workflow，让新建会话使用一套更明确的五阶段工程工作流。