Agent Skills › voidzero-dev/vite-plus › sync-upstream-cli-help

sync-upstream-cli-help

GitHub

同步Vite+项目上游工具（如Vite、Vitest等）的CLI帮助文档，确保与上游一致且保留特定配置。

.claude/skills/sync-upstream-cli-help/SKILL.md voidzero-dev/vite-plus

Trigger Scenarios

上游依赖升级导致CLI帮助输出变更需要更新commandHelpDocs以反映上游工具的新功能或移除旧功能

Install

npx skills add voidzero-dev/vite-plus --skill sync-upstream-cli-help -g -y

More Options

Non-standard path

npx skills add https://github.com/voidzero-dev/vite-plus/tree/main/.claude/skills/sync-upstream-cli-help -g -y

Use without installing

npx skills use voidzero-dev/vite-plus@sync-upstream-cli-help

指定 Agent (Claude Code)

npx skills add voidzero-dev/vite-plus --skill sync-upstream-cli-help -a claude-code -g -y

安装 repo 全部 skill

npx skills add voidzero-dev/vite-plus --all -g -y

预览 repo 内 skill

npx skills add voidzero-dev/vite-plus --list

SKILL.md

Frontmatter

{
    "name": "sync-upstream-cli-help",
    "description": "Sync Vite+'s static CLI help with Vite, Vitest, Oxlint, Oxfmt, and tsdown while preserving intentional omissions. Use when an upstream dependency upgrade changes CLI help.",
    "allowed-tools": "Read, Grep, Glob, Edit, Bash"
}

Sync upstream CLI help

Input and target

Read the diff from $CLI_HELP_DIFF_REPORT; first run test -r "$CLI_HELP_DIFF_REPORT". Act only when $CLI_HELP_DIFF_CHANGED is true.
Treat the upgraded tool's --help output as the source of truth. The report locates changes and versions; rerun the exact version when its diff is truncated.
Edit commandHelpDocs in packages/cli/src/help.ts.
Do not edit packages/cli/src/utils/help.ts for content drift. It owns terminal wrapping, alignment, and the right margin.

Upstream help	Document entry
`vite --help`	`dev`
`vite build --help`	`build`
`vite preview --help`	`preview`
`vitest --help`	`test`
`oxlint --help`	`lint`
`oxfmt --help`	`fmt`
`tsdown --help`	`pack`

Change

For items Vite+ exposes, copy upstream labels, descriptions, section titles, and section guidance exactly. Preserve intentional lines and lists, but not terminal padding, automatic wrapping, ANSI color, or version banners.
Remove an upstream item only after confirming Vite+ no longer supports or deliberately retains it.

Do not change

Keep Vite+-owned usage, summaries, examples, and documentation URLs.
Keep config selectors/loaders hidden, including --config, --configLoader, and --disable-nested-config.
Do not add standalone modes such as --init, --migrate, or --lsp, top-level --version, or options Vite+ does not forward.
Do not change runtime forwarding or rewrite upstream wording for a Vite+-specific runtime default. Use sync-tsdown-cli for tsdown runtime changes.

Re-record the affected CLI help snapshots and inspect their diffs. Do not modify help documents when the report contains no actionable exposed change.