yanxu-dsh-plugin

Readme

# Yanxu Dev DSH Plugin

`yanxu-dsh-plugin` is an installable [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Bundle. It adds one model- and user-loadable skill, `yanxu-delivery-workflow`, for using [Yanxu Dev](https://github.com/guannan1031/yanxu-dev) as an evidence-bound AI coding delivery workflow.

The skill guides an agent through repository readiness, requirement contracts, explicit source allowlists, isolated tests, PR/CI evidence, Draft PR boundaries and measured efficiency. It deliberately uses DSH's existing `bash` or `pwsh` tools, so command execution stays inside the Harness permission and sandbox model.

## Install

Install the public GitHub release into a DSH profile:

```bash
dsh plugin --profile web add github:guannan1031/yanxu-dsh-plugin#v0.1.0
```

Restart that profile after installation. DSH adds the package to the profile's bundle list because this package declares `dsh.bundle.patch`.

For a local checkout during development:

```bash
dsh plugin --profile web add /absolute/path/to/yanxu-dsh-plugin
dsh --profile web --dump-config
```

The configuration dump must include a `yanxu-dsh-plugin` layer before use.

## Use

In DSH, load the skill named `yanxu-delivery-workflow`, then ask the agent to work on an authorized repository. The skill requires it to:

1. Run `doctor` and create a task contract before AI code generation.
2. Use an explicit source-file allowlist and test command for `implement`.
3. Keep generated changes in the isolated archive until human review.
4. Treat Draft PR, CI success, merge, and deployment as separate states.
5. Measure developer-efficiency claims with matched, quality-passing real tasks.

Yanxu Dev itself must be installed in the target project environment. Follow its [Windows guide](https://github.com/guannan1031/yanxu-dev/blob/main/docs/WINDOWS_SETUP.md) or repository README.

## What this plugin does not do

It does not bypass DSH permissions, run arbitrary host processes from the plugin process, store credentials, automatically merge a PR, or deploy an application. It supplies workflow instructions; DSH's existing sandboxed tools execute any approved commands.

## Verify

```bash
npm test
dsh --profile web --dump-config
```

The first command validates the bundle's exported contract. The second proves that DSH has composed the bundle layer. A normal `dsh` session should list `yanxu-delivery-workflow` in its skills catalog.

## Discovery

The repository is tagged with GitHub topic `dsh-plugin`, which community DSH marketplaces use for discovery. The official DSH installation mechanism is `dsh plugin --profile <profile> add <package-or-git-spec>`; no official central registry has been used for this release.

## License

MIT. DeepSeek Harness and Yanxu Dev are independent projects with their own licenses and authentication requirements.