dsh-chip-design-closure
renshaokai/dsh-chip-design-closure
Adds the Design closure agent preset and the chip-design skill for digital chip front-end work: architecture budgets, design specs, functional and acceptance point lists, RTL, timing closure and PPA. Ships three scripts — a 38-rule spec linter, a Markdown to docx/PDF converter, and a draw.io / Mermaid / WaveDrom figure renderer.
インストール
dsh plugin --profile web add github:renshaokai/dsh-chip-design-closureREADME
dsh-chip-design-closure
Design-side closure for digital chip front-end work: a DSH agent preset that writes the spec, plus scripts that check it. 数字芯片前端设计收口——会写 spec 的 agent 预设,配一套能跑的校验脚本。
- 给谁 · For: RTL designers and verification engineers who need architecture decisions to become a reviewable document — written from a PRD, or reverse-engineered from RTL that already exists.
- 产出 · Ships: the eight-chapter spec, register and interface contracts, FP/VP handoff lists (stops at the VP list), and three scripts — a 38-rule spec linter, a Markdown to docx/PDF converter with a real Word table of contents, and a draw.io / Mermaid / WaveDrom figure renderer.
- 开始 · Start:
dsh plugin add dsh-chip-design-closure, open a new session, pick the 设计收口 preset.
This is the DeepSeek Harness edition of the CodeBuddy expert plugin chip-arch-expert v1.13.0 — same author, adapted packaging. The skill content tracks the upstream release; the persona keeps its substance but is rewritten in second person with the character name dropped, and the preset, tool composition, icon and display metadata are DSH-specific.
Install
dsh plugin forwards its arguments to pnpm inside the profile directory, so the argument is a package spec — a package name, a directory, a tarball, or a Git URL — not a file.
Install from a local checkout. This links the directory rather than copying it, so edits to the checkout take effect after a restart:
dsh plugin --profile <profile> add /path/to/dsh-chip-design-closure
dsh plugin --profile desktop add D:\path\to\dsh-chip-design-closure
Or in the Web GUI: Plugins → Add plugin → pick the package directory.
Then start a new session and choose the 设计收口 preset.
The package is published on npm as dsh-chip-design-closure, so the bare name installs from the registry:
dsh plugin --profile <profile> add dsh-chip-design-closure
Use a local checkout path instead when you want the installed bundle to follow the working tree. The engine requirement is dsh >= 0.2.2-rc.3.
What it adds
| Part | Content |
|---|---|
Agent preset chip-arch-expert | Full persona of a digital chip architect: architecture and budgets, design specs written forward or reverse-engineered from RTL, functional-point and acceptance observation point lists, RTL, lint/CDC, synthesis, timing closure, PPA, SoC integration. Hands off at the VP list. |
Skill chip-design | Workflow reference library: architecture budget, eight-chapter spec outline (document control, register/interface contracts, closure traceability), FP/VP generation, RTL checklist, synthesis and timing, PPA, review checklist (66 forward items / 45 reverse items), SoC integration, delivery formats, plus a spec template, an md2doc.py converter (docx/PDF with automatic table of contents), figrender.py (draw.io / Mermaid / WaveDrom diagrams to SVG/PNG) and spec_lint.py (38 mechanical spec checks — duplicate offsets, overlapping bitfields, lsb > msb, width overflow, out-of-segment addresses, stray TBD, missing mandatory sections — each reported with a line number and section path). |
Tools mounted with the preset: PowerShell/Bash, filesystem read/write and search, background jobs, todo, skill loading, web search, user questions, deliverable declarations, Office documents, and context compaction.
Requirements
- DeepSeek Harness
>=0.2.2-rc.3(engines.dsh)
The skill directory is resolved relative to the installed package, so the bundle works from npm, a tarball, or a linked checkout without editing the patch.
Layout
package.json bundle manifest (dsh.bundle.patch, main: ./index.js)
index.js entry module: exports preset id, patch path and skill dir
cordis.patch.yml preset declaration: persona + tool rows + skill root
locale/en.json plugin title and description for the Plugins page
locale/zh.json
docs/DETAIL.md the bundle's detail page
icon.svg 36×36 chip glyph
skills/chip-design the skill: SKILL.md, references/, templates/, scripts/
Release
Releasing runs in GitHub Actions through npm trusted publishing, so no token, OTP, or web approval is involved.
-
Bump the version and tag that commit with the same version:
npm version 1.13.2 --no-git-tag-version git commit -am "chore: 1.13.2" git tag v1.13.2 git push origin main git push origin v1.13.2Push the tag with its own
git push.git push --follow-tagsonly carries annotated tags, so a tag created with plaingit tagis silently left behind and the workflow never starts. -
.github/workflows/publish.ymlruns on thev*tag, refuses to continue when the tag andpackage.jsondisagree, prints the tarball contents, then publishes with provenance.
The repository is bound to the package once, on the package's Settings → Trusted Publisher page on npmjs.com, naming this repository and the workflow file publish.yml. A manual workflow_dispatch run publishes the current manifest version and therefore only succeeds when that version is not already on the registry.
The workflow needs npm >= 11.5.1, which the job installs into its own prefix, and package.json must declare repository.url matching the GitHub repository, otherwise the registry rejects the provenance bundle. docs/RELEASE-NOTES.md records the failure signatures and their fixes.
Differences from the CodeBuddy edition
maxTurns: 80has no DSH equivalent and is not migrated; use the session controls instead.- The original 512×512 round badge carries 芯片定制 lettering that is unreadable at row size, so the bundle icon is a plain chip glyph.
- CodeBuddy-only fields (
quickPrompts,defaultInitPrompt,categoryId,expertType) have no DSH counterpart and are dropped. - The persona body is in second person and carries no personal name, so the preset reads as a role rather than a character.
License
MIT © 流片之前. See LICENSE.