starter-cleaner

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Starter Cleaner

Starter Cleaner

使用随技能提供的确定性脚本清理
wot-starter
v2,保留基础页面、Wot UI、
uni-echarts
echarts
能力。
Use the deterministic script provided with the skill to clean up
wot-starter
v2, retaining basic pages, Wot UI,
uni-echarts
and
echarts
capabilities.

执行流程

Execution Process

  1. 在项目根目录运行
    git status --short
    ,确认并告知用户未提交改动会被保留,但待清理目录中的改动会随目录一起删除。
  2. 如果用户尚未明确要求执行清理,先说明这是破坏性操作并取得确认。
  3. 先预览清理计划:
    sh
    node .agents/skills/starter-cleaner/scripts/clean.js --dry-run
  4. 确认目标是
    wot-starter
    v2 后执行。脚本会删除旧的
    src/pages.json
    ,然后受控运行
    pnpm dev:h5
    ,等新的最小
    src/pages.json
    生成后退出 dev server:
    sh
    node .agents/skills/starter-cleaner/scripts/clean.js
  5. 执行
    pnpm install --lockfile-only
    更新锁文件,再运行
    pnpm type-check
    pnpm lint
    。如果依赖不可用,至少检查
    git diff --check
    和清理后的 diff,并将未运行的验证明确告知用户。
  1. Run
    git status --short
    in the project root directory, confirm and inform the user that uncommitted changes will be retained, but changes in directories to be cleaned will be deleted along with the directories.
  2. If the user has not explicitly requested to perform the cleanup, first explain that this is a destructive operation and obtain confirmation.
  3. Preview the cleanup plan first:
    sh
    node .agents/skills/starter-cleaner/scripts/clean.js --dry-run
  4. Execute after confirming the target is
    wot-starter
    v2. The script will delete the old
    src/pages.json
    , then run
    pnpm dev:h5
    in a controlled manner, and exit the dev server after the new minimal
    src/pages.json
    is generated:
    sh
    node .agents/skills/starter-cleaner/scripts/clean.js
  5. Execute
    pnpm install --lockfile-only
    to update the lock file, then run
    pnpm type-check
    and
    pnpm lint
    . If dependencies are unavailable, at least check
    git diff --check
    and the diff after cleanup, and clearly inform the user of the unexecuted verifications.

清理范围

Cleanup Scope

脚本执行以下操作,且支持重复运行:
  • 删除
    docs/
    src/subPages/
    src/subEcharts/
    src/subAsyncEcharts/
  • 删除旧的
    src/pages.json
    ,再通过
    pnpm dev:h5
    触发
    vite-plugin-uni-pages
    重新生成最小页面配置。
  • 删除
    pnpm-workspace.yaml
    ,将项目从文档 workspace 恢复为单包项目。
  • vite.config.ts
    UniHelperPages
    配置中移除上述三个示例分包入口。
  • package.json
    中移除
    docs:*
    lint:docs
    脚本。
  • 保留
    uni-echarts
    echarts
    依赖和相关 Vite 配置,方便业务继续使用图表。
The script performs the following operations and supports repeated runs:
  • Delete
    docs/
    ,
    src/subPages/
    ,
    src/subEcharts/
    ,
    src/subAsyncEcharts/
    .
  • Delete the old
    src/pages.json
    , then trigger
    vite-plugin-uni-pages
    to regenerate the minimal page configuration via
    pnpm dev:h5
    .
  • Delete
    pnpm-workspace.yaml
    to restore the project from a document workspace to a single-package project.
  • Remove the three example sub-package entries from the
    UniHelperPages
    configuration in
    vite.config.ts
    .
  • Remove
    docs:*
    and
    lint:docs
    scripts from
    package.json
    .
  • Retain
    uni-echarts
    ,
    echarts
    dependencies and related Vite configurations to facilitate continued use of charts in business.

安全约束

Security Constraints

  • 不直接拼接或扩展删除路径;仅使用脚本内的固定清单。
  • 不在非
    wot-starter
    v2 项目中运行。仅在用户明确确认目标项目后使用
    --force
    跳过项目身份检查。
  • 不用
    --force
    绕过未提交改动提示;该参数只用于项目身份检查。
  • Do not directly concatenate or extend deletion paths; only use fixed lists within the script.
  • Do not run in non-
    wot-starter
    v2 projects. Only use
    --force
    to skip project identity check after the user explicitly confirms the target project.
  • Do not use
    --force
    to bypass the uncommitted changes prompt; this parameter is only used for project identity check.