Starter Cleaner
使用随技能提供的确定性脚本清理 wot-starter v2,保留基础页面、Wot UI、uni-echarts 和 echarts 能力。
执行流程
在项目根目录运行
git status --short,确认并告知用户未提交改动会被保留,但待清理目录中的改动会随目录一起删除。如果用户尚未明确要求执行清理,先说明这是破坏性操作并取得确认。
先预览清理计划:
node .agents/skills/starter-cleaner/scripts/clean.js --dry-run确认目标是
wot-starterv2 后执行。脚本会删除旧的src/pages.json,然后受控运行pnpm dev:h5,等新的最小src/pages.json生成后退出 dev server:node .agents/skills/starter-cleaner/scripts/clean.js执行
pnpm install --lockfile-only更新锁文件,再运行pnpm type-check和pnpm lint。如果依赖不可用,至少检查git diff --check和清理后的 diff,并将未运行的验证明确告知用户。
清理范围
脚本执行以下操作,且支持重复运行:
- 删除
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 配置,方便业务继续使用图表。
安全约束
- 不直接拼接或扩展删除路径;仅使用脚本内的固定清单。
- 不在非
wot-starterv2 项目中运行。仅在用户明确确认目标项目后使用--force跳过项目身份检查。 - 不用
--force绕过未提交改动提示;该参数只用于项目身份检查。