前言¶
DeepSeek Harness(DSH)采用插件化架构,旨在将通用能力以 bundle 形式分发。simple-plan 是一个工作流插件,它将“计划-执行-验证-修复”的闭环逻辑打包为一个 skill。在多智能体协作中,任务分解粗糙、交付物缺乏独立验证以及修复过程容易失控是常见问题。该插件通过强制执行 Plan-Execute-Verify-Fix 循环,将复杂任务转化为可控的子任务流。
插件介绍¶
这是一个由 bauerelizabeth07139 维护的工作流插件。它通过 Harness 技能注册表注册 skills/simple-plan/SKILL.md 文件,将其作为 bundle skill 发射。核心逻辑包含五个阶段:将请求分解为 2-7 个具体步骤、使用 worker subagent 执行、使用无状态(memoryless)subagent 验证、在最多三个循环内修复缺陷,以及最终汇总结果。
核心功能¶
-
Plan(计划)
理解用户请求,将其拆解为 2-7 个具有明确交付物的具体步骤。 -
Execute(执行)
为每个非琐碎步骤启动一个 worker subagent。Worker 获取任务、交付物目标和文件路径,但不会获得验收标准。 -
Verify(验证)
为每个交付物启动一个 memoryless subagent。验证器独立工作,报告 PASS 或 FAIL 并附带证据。 -
Fix Loop(修复循环)
若验证失败,读取证据,针对具体缺陷启动新的 worker 和验证器。此循环最多执行三次。 -
Report(报告)
汇总所有执行与验证结果,列出每个检查项的 Pass/Fail 状态,并最终声明 ALL PASS 或 FAIL。
安装与启用¶
CLI 安装¶
在当前启用的 profile 中安装:
dsh plugin --profile web add bauerelizabeth07139/simple-plan
Desktop 安装¶
在 DeepSeek Harness Desktop 中:
1. 打开侧边栏的 Plugins。
2. 选择 Add plugin。
3. 输入插件地址:
https://github.com/bauerelizabeth07139/simple-plan
- 启用新出现的 dsh-simple-plan bundle。Desktop 应用使用
desktopprofile,需在此处激活。
无 Git 环境安装¶
如果机器上没有 git,pnpm 会报错。使用 tarball URL 直接安装:
dsh plugin --profile web add https://codeload.github.com/bauerelizabeth07139/simple-plan/tar.gz/master
卸载¶
dsh plugin --profile web remove dsh-simple-plan
用法与机制¶
该插件注册的技能文件位于 skills/simple-plan/SKILL.md。在 DSH 环境中,工具名称与原 Codex 版本有所不同,主要映射如下:
multi_agent_v1__spawn_agent(message=…, fork_context=false)->subagent(description=…, prompt=…)apply_patch->edit/writeread_file->read
DSH 的一个额外优势是所有 agent 都拥有 read_image 权限,这使得验证器可以在没有内置视觉能力的会话模型中检查截图。
注意事项与适用场景¶
- 权限运行:插件以当前 DSH 进程的权限运行,安装前请检查源码与许可证。
- 版本要求:需 Node.js >= 22 以及 DSH 版本满足
>=0.1.5-rc.1 <0.2.0-0 || >=0.2.0-rc.0 <0.3.0-0。 - 适用场景:适合需要严格质量控制和可复现工作流的多步骤复杂任务。
总结¶
simple-plan 提供了一种结构化的任务处理方式,通过强制分离执行者与验证者,并在修复阶段设置硬性限制,提高了多智能体任务的可靠性。相关源码与目录信息可参考下方链接。