AGENT SKILL

dsh-doc-site-sync

Use when publishing, updating, moving, or removing DeepSeek Harness documentation website pages; editing website/docs.ts mappings or navigation; diagnosing a page missing from the VitePress site; fixing projected documentation links; or running the docs:dev, docs:check, and doc-sync workflow after website-content changes.

License 许可
MIT
最近更新
2026-10-11
Stars
★ 74
Forks
1

01 前言 Front Matter

name
dsh-doc-site-sync
description
Use when publishing, updating, moving, or removing DeepSeek Harness documentation website pages; editing website/docs.ts mappings or navigation; diagnosing a page missing from the VitePress site; fixing projected documentation links; or running the docs:dev, docs:check, and doc-sync workflow after website-content changes.

02 资源文件 1

03 SKILL.md 正文

Synchronizing the DeepSeek Harness Documentation Site

Keep repository Markdown as the only editable content source. Treat the website as a tested projection: website/docs.ts selects public pages, scripts/project-doc-site.ts rewrites them into the disposable website/.generated/ tree, and VitePress builds that tree. The build additionally emits a raw-Markdown twin of every route (page URL minus any trailing slash, plus .md; index routes also get a parent-level alias) and a root llms.txt index; both derive from the same manifest and projector, so publishing, moving, or removing a page updates them automatically and docs:build fails when one is missing.

Repository translations follow the sibling pairing contract: English foo.md, Chinese foo.zh.md, and foo.i18n.yaml live together. Never create zh-CN/ or other locale directories for website content. The site route trees are independent of that source layout: foo.zh.md projects to the root route and foo.md projects to the matching /en/ route.

Read the owning contracts

  • Read docs/AGENTS.md and use dsh-doc-standards when deciding where content belongs or changing product documentation prose.
  • For an edited bilingual source, follow the lightweight routine path in docs/AGENTS.md and the pairing contract; never invoke the extended translation skill automatically.
  • Read the current DocsPage type and entries in website/docs.ts before changing the manifest; do not rely on a remembered field set.
  • Read website/.vitepress/config.ts before adding a new section, sidebar collection, locale, or top-level navigation item.

Classify the change

  • Edit an already published page: change only its canonical Markdown source. Do not touch the manifest unless its route or navigation metadata changes.
  • Publish a new page: create it in its owning docs/ tier, then add one manifest entry.
  • Rename, move, or remove a page: update the canonical file, manifest entry, and inbound repository links atomically. Remove stale manifest entries; docs:check rejects missing sources.
  • Publish a generated catalog: map the generated docs/ file, but change its generator or source metadata rather than editing the catalog by hand.
  • Change site structure: update the manifest for ordinary pages; update VitePress configuration only when the existing sidebar, section, or locale model cannot express the change.

Never edit or commit website/.generated/, website/.cache/, or website/.dist/. Except for website/AGENTS.md, never add Markdown under website/; locale and route directories such as website/zh-CN/, website/en/, and website/api/ are invalid source layouts. Keep generated catalogs under docs/, freshness-gate them there, and publish them through the manifest.

Add or update a manifest entry

Set every DocsPage field deliberately:

  • source: repository-relative canonical Markdown path. For a complete bilingual pair, add the English .md path through pairedPages(); it derives the sibling .zh.md, the content locales, and counterpart aliases.
  • route: public VitePress path including the .md suffix.
  • label: sidebar label, not necessarily the document H1.
  • sidebar: reuse zh-guide, zh-develop, or en-docs unless the information architecture genuinely needs another collection.
  • section: reuse an existing section when possible. If adding one, also place it in sectionOrder in the VitePress config.
  • order: stable order within the section.
  • sourceAliases: optional additional repository paths that should resolve to this page when links are projected. It does not create another public route.

Use mirroredPages() only for a source that intentionally falls back to the same available language in both route trees. Convert that entry to pairedPages() when its counterpart is added. Keep the manifest an explicit public allowlist. Do not publish RFCs, postmortems, testing guides, AGENTS.md, or maintainer workflows merely because they exist under docs/; add internal material only when the user explicitly expands what the site publishes.

Preserve link behavior

Write normal repository-relative Markdown links in canonical docs. The projector applies these rules:

  • A target present in the manifest becomes a site-relative route.
  • An existing target outside the manifest becomes a GitHub source link, including supported line suffixes.
  • An image is the exception: its file is copied into the generated tree and referenced from there, so the site serves it regardless of repository visibility. It must be a regular file inside the repository.
  • External URLs, site-absolute URLs, email links, and fragment-only links remain unchanged.
  • A missing repository-relative target fails projection instead of silently producing a broken link.
  • Cross-page fragments use the English GitHub heading id as their canonical id. If an authored heading emits a different VitePress id, place an explicit <a id="..."></a> immediately before it; add generated aliases in the owning generator.

Do not write website-specific routes into canonical Markdown just to satisfy VitePress. Use sourceAliases for directory-style repository links that should resolve to a mapped index page.

Preview and validate

Run local preview while editing:

pnpm docs:dev

The dev server watches mapped source files and reprojects them. Restart it after changing the manifest if the new source is not picked up automatically.

Run the focused website gate before treating the mapping as valid:

pnpm docs:check

If Markdown link checks pass but the site build reports a missing fragment, follow the verify-doc-site-fragments source and target paths. Preserve the English GitHub id with an explicit alias in authored Markdown or in the owning generator.

Before committing a documentation-site change, run:

pnpm run doc-sync
pnpm run lint
git diff --check

Use dsh-pre-push-checks before pushing. Report the canonical files changed, manifest entries added or removed, public routes affected, and the exact checks run.

Keep deployment separate

Synchronizing content into the VitePress build does not publish it to the internet. Do not add GitHub Pages permissions, deployment workflows, custom domains, or public hosting unless the user explicitly requests deployment and confirms the hosting policy.

04 同仓库更多 Skills

VideoVerses
VideoVerses/Cuti-Harness

external-shot-continuity

External continuity review method for long-form video projects.

★ 74
VideoVerses
VideoVerses/Cuti-Harness

independent-story-workflow

Create a three-part story document without paid media generation.

★ 74
VideoVerses
VideoVerses/Cuti-Harness

suno-song

Instruction helper: write a singable original Suno song from Bitwize (verbatim copy), then call suno.generate. Trigger: 原创歌曲, 写歌, Suno lyrics, $suno-song. Not a workflow.

★ 74
VideoVerses
VideoVerses/Cuti-Harness

short-drama-workflow

Workflow for producing plot-dense short dramas with character and location reference sheets, complete 15-second Seedance segments, native dialogue, parallel multi-reference T2V generation, duration validation, and final assembly. Use for 爽文短剧、都市反转短剧、对白短剧、连续多段短剧,或用户明确调用 $short-drama-workflow. Do not use for product-centered scenario advertisements.

★ 74
VideoVerses
VideoVerses/Cuti-Harness

seedance2

Workflow: 即梦 Seedance 视频创意工作台。图+文案→看图分析→文案扩写→运镜→API生成。 触发词:即梦、Seedance、seedance、视频提示词、AI视频、运镜、短剧广告、$seedance2.

★ 74
VideoVerses
VideoVerses/Cuti-Harness

product-voiceover-narration

Design concise native voiceover for commercial product-video segments and bind each spoken line to verified selling points, visible actions, and exact timeline ranges. Use when a product advertisement should introduce the product through narration, when Seedance 2.0 should generate picture and voice together, or when product shots need coordinated narration, music, and sound direction. Do not synthesize a separate voice track and never invent product claims.

★ 74