ci-checklisted
Install: claude install-skill zeno528/Agmux
# 本地 CI 预检
执行 `package.json` 的完整检查与前端生产构建。对应 `.github/workflows/ci.yml`:Windows 跑完整链,macOS job 单独跑 Rust 测试;本机结果不能代替另一平台的远端结果。
## 环境与执行
先沿用根 `AGENTS.md` 的项目环境;不全局安装工具,不混用其他系统生成的 node_modules。依赖或 lockfile 变化时先核对一致性并安装依赖,不能为了让 frozen 安装成功而擅自重写锁文件。
当前 Mac 在仓库根目录运行:
```sh
./work/dev-env/run.sh check && ./work/dev-env/run.sh build
```
其他已配置环境执行同一项目脚本 `pnpm check && pnpm build`。检查阶段包括 TypeScript、Vitest、样式、i18n、Rust fmt、clippy 与测试;以实际脚本为准,不在技能重复维护命令展开。
## 处理失败
- 先定位失败阶段与实际错误,区分本次改动、既有问题和环境问题;修复本次引入的问题,既有失败单独报告,不无限扩展修复范围。
- 不通过削弱类型、关闭检查、跳过测试或放宽错误断言制造通过;必要例外留具体理由。
- fmt 修复使用项目 Rust 环境并审阅产生的 diff。其他失败先跑受影响检查定位;修复后完成上述完整链条,不能只凭某一阶段通过下结论。
- 长任务持续等待实际结果,未完成或未执行的阶段不能标绿。
## 交付
汇报各阶段结果、实际运行平台及未覆盖的平台差异;不宣称远端 CI 已通过。用户只要求预检时不提交、不推送;已经授权推送时,检查完成后沿用该授权,不重复索要确认。