dsh-gsd-bridge
GSD Core 工作流桥接，用于 DeepSeek Harness：将 @opengsd/gsd-core 挂载为 /gsd-* 斜杠命令，并提供会话导向。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:cainiao1992/dsh-gsd-bridge#5b59ee6811b47eac3c5b20e73c9b3d26d180fc1fGsd Bridge 以 dsh-gsd-bridge 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Mount GSD Core — the spec-driven development system (Git. Ship. Done.: Discuss → Plan → Execute → Verify → Ship) — onto DeepSeek Harness as native /gsd-* slash commands.
@opengsd/gsd-core is consumed as a plain npm dependency and adapted at dispatch time; nothing is rewritten on disk.
/gsd-* slash commands: /gsd-new-project, /gsd-onboard, /gsd-plan-phase, /gsd-execute-phase, /gsd-verify-work, /gsd-ship, /gsd-next, /gsd-help ….planning/), the model is oriented with the current STATE.md head, mirroring GSD Core's SessionStart hook.@~/.claude/gsd-core/... includes inlined, tool vocabulary renamed, the gsd_run shim re-pointed). The gsd-core package itself is never modified, so an upstream upgrade is just a version bump..planning/), so a Claude Code session and a DeepSeek Harness session can drive the same project interchangeably.web (or base) profile already mounted — it must provide the fs and commands services.Direct from GitHub (no npm publish). The prepare script builds lib/ automatically on install.
dsh plugin --profile web add github:cainiao1992/dsh-gsd-bridge --config.auto-install-peers=false
dsh plugin forwards its arguments verbatim to pnpm inside the profile directory. --config.auto-install-peers=false avoids the incomplete rc-era peer graph of the @deepseek-ai/dsh-* packages — in a profile the peers are already provided by the host bundles, so they are not re-installed. Equivalent manual form:
cd ~/.dsh/profiles/web
corepack pnpm add github:cainiao1992/dsh-gsd-bridge --config.auto-install-peers=false
Then mount it by replacing the local absolute path with the bare package name (the loader resolves bare names against the config-file directory → the profile's node_modules):
# ~/.dsh/profiles/web/cordis.patch.yml
- insert:
- id: gsd-bridge
name: dsh-gsd-bridge
Type any /gsd-* command in the DeepSeek Harness Web UI.
/gsd-help # workflow catalog
/gsd-new-project # greenfield: questioning → research → requirements → roadmap
/gsd-onboard # existing codebase: map → ingest → initialize planning
/gsd-plan-phase 1 # create a detailed plan for phase 1
/gsd-execute-phase 1 # execute all plans in the phase
/gsd-next # state-aware router
Every /gsd-* dispatch adapts the gsd command in memory before it reaches the model:
| Adaptation | Details |
|---|---|
| Frontmatter strip | allowed-tools / requires / effort are dropped (the dsh tool registry owns tool governance); description and argument-hint register the command. |
| Include inlining | @~/.claude/gsd-core/... <execution_context> references (which Claude Code resolves at prompt-assembly time) are read and inlined, budget-capped, cycle-safe, and recursive. |
| Vocabulary rewrite | `Read`→`read` , Agent→subagent, AskUserQuestion→ask_user_question, /gsd:x→/gsd-x, Copilot <runtime_note> blocks dropped. |
| Shim rewrite | $(git rev-parse --show-toplevel …) → the installed package root, so gsd_run / gsd-tools.cjs resolve immediately. |
| Argument substitution | $ARGUMENTS / ${ARGUMENTS} → the text after the command name. |
Dispatch uses agent.steer() (user-message semantics); session orientation uses agent.inject() (a non-waking notice).
Of GSD Core's ~20 Claude Code hooks, only the SessionStart state orientation is ported (agent/session-start event → .planning/STATE.md injection). Tool-interception hooks (read-guard, worktree-path-guard, …) are covered by dsh's native permission/sandbox stack; update-check hooks are irrelevant against a pinned npm dependency.
| Field | Default | Meaning |
|---|---|---|
vendorRoot | installed @opengsd/gsd-core | package root to bridge (a fork or local checkout) |
includeBudgetChars | 220000 | per-command include-inlining character budget |
stateCapChars | 3500 | STATE.md orientation truncation |
orientation | true | disable session orientation |
The recommended local override for vendorRoot is ~/.dsh/gsd-core — a package-root install (with commands/, agents/, and the gsd-core/ runtime root — the DSH counterpart of ~/.claude/gsd-core):
- id: gsd-bridge
name: 'dsh-gsd-bridge'
config:
vendorRoot: /Users/<you>/.dsh/gsd-core
includeBudgetChars: 100000
npm install --legacy-peer-deps # rc-era dsh npm peer graph is incomplete for local dev
npm run build # tsc → lib/
Type contracts come from the published @deepseek-ai/dsh-* declarations (dsh-commands, dsh-fs, dsh-agent, dsh-llm).
1.12.0; an upgrade requires re-validating the command-body format.--config.auto-install-peers=false (drop it once the upstream peer graph is complete).write-guard (protection against catastrophic .planning/ overwrites) is a known gap.gsd-executor, …) map to subagent delegation with persona-file prompts, not native agent types.MIT (this repository's code). @opengsd/gsd-core is distributed as a dependency under its own MIT license.