Preface

When building agent pipelines, a common issue is that the assistant can work continuously, but humans cannot simply walk away. The root cause is the lack of a clear agreement between the orchestration side and the execution side: what should the dispatch spec contain, which model tier to use at each stage, who can submit to git, and what constitutes evidence for validation.

hermes-dsh-collab is the skill pack designed to fill this gap. It integrates DeepSeek Harness (DSH) into the Hermes pipeline, providing a dispatch-spec template, model-tier routing, quality gates, and git single-writer rules, forming an installable and reusable skill pack.

What This Is

hermes-dsh-collab is a DSH plugin, hosted at Cavan-Ou/hermes-dsh-collab, licensed under MIT.

Its one-line定位 is: integrating DSH into the Hermes pipeline, covering dispatch spec, model-tier routing, quality gates, and git single-writer rules.

The problems it addresses can be summarized as:

  1. Enabling an automated chain for dispatch, execution, and verification.
  2. Ensuring quality gates are owned by the orchestrator, not treating self-reports as evidence.
  3. Using clear rules to constrain model selection, commit permissions, and write-back methods.
  4. Compiling known pitfalls into a traceable list with receipts.

Core Capabilities

The following introduces the clearly defined capabilities of this skill pack.

Automated Dispatch, Execution, and Verification

The skill pack describes capabilities including automated dispatch, execution, and verification. In practice, it places the tasks generated by the orchestrator, the execution process of DSH, and subsequent verification into a single workflow.

Quality Gates Owned by the Orchestrator

This skill pack emphasizes Quality gates owned by the orchestrator and explicitly states Self-reports are not evidence. This means the execution side’s own completion reports cannot be directly used as pass criteria; verification remains the responsibility of the orchestrator.

Model-Tier Routing

The skill pack includes Model-tier routing for selecting the corresponding model tier at different task stages.

Spec 3 Iron Rules

The skill pack includes Spec 3 iron rules to constrain the generation quality of dispatch specs. Specs lacking necessary constraints should not be directly passed to execution.

Git Single-Writer

The skill pack includes Git single-writer rules. According to these rules, the executor should not directly execute git commits; commit actions are controlled by the orchestrator to prevent the execution side from overwriting repository state without authorization.

Write-Back via CWD

The skill pack supports Write-back via cwd. The common usage involves first entering the project directory and then running a DSH headless profile task:

cd <project> && dsh --profile headless "task"

This approach allows results to be written back directly to the current working directory, avoiding reliance on additional temporary images or patch handoffs.

Pitfalls with Receipts

The skill pack also includes Pitfalls with receipts, compiling known pitfalls into a traceable list. Verified considerations include:

  • patch config replaces entire sections rather than performing a deep merge.
  • qwen rejects reasoning: max.
  • Vision patches do not change the main model.
  • Old backend processes can invalidate green test results.

Installation and Enabling

Installation via DSH Plugin

The official installation command is:

dsh plugin --profile headless add github:Cavan-Ou/hermes-dsh-collab

This command installs the plugin using the headless profile.

Direct Copy of the Skill Pack

Alternatively, you can copy the skill pack to the DSH skills directory:

git clone https://github.com/Cavan-Ou/hermes-dsh-collab
cp -r skills/hermes-dsh-collab "$DSH_HOME/skills/"   # default: ~/.dsh/skills/

The default path for $DSH_HOME/skills/ is ~/.dsh/skills/. After copying, a new DSH session should show hermes-dsh-collab in the skills list.

How to Verify After Enabling

Below are three verification steps:

  1. Open a new DSH session and confirm that hermes-dsh-collab appears in the skills list.
  2. Submit a request like write me a dispatch spec to confirm the skill pack triggers appropriately.
  3. Ask the executor if it can git commit; the expected answer is no, with an explanation citing the single-writer rule.

Typical Usage

After installation, you can perform a headless task in a specific project:

cd <project> && dsh --profile headless "task"

This step constrains DSH to run within the current project directory, suitable for use with the Write-back via cwd method.

During the session, you can ask questions related to the dispatch spec:

write me a dispatch spec

Or questions about commit permissions:

can the executor git commit?

According to the Git single-writer rules, the executor should not be allowed to commit directly.

Applicable Scenarios and Notes

Environment Dependencies

This skill pack depends on:

  • DSH 0.1.x, headless profile.
  • Any orchestrator agent.
  • Hermes for building and testing.

Therefore, it is more suitable for scenarios already using DSH headless profile and having an orchestration-side agent.

Permissions and Licensing

This plugin runs under the current DSH process permissions. Before installation, you should review the source code, behavioral boundaries, and license. The repository declares a MIT license.

Path Portability

The sources of truth in the skill pack may point to workspace-specific paths, such as:

~/.dsh/profiles/headless/*.patch.yml

The rules themselves are portable, but paths need to be adjusted according to the actual workspace.

Quality Judgment

This skill pack explicitly does not treat self-reports as evidence. Quality gates, execution results, and verification conclusions still need to be confirmed by the orchestrator.

Links

Repository URL:

https://github.com/Cavan-Ou/hermes-dsh-collab

If you are using a standalone plugin directory, you can also search for hermes-dsh-collab. This directory is not an official DeepSeek or High-Flyer app store.