SuperAPI AI 工具集

clean

前端与建站

查看项目

更新于 10-16 08:39

技能介绍

用途:为 React Native 项目提供“先诊断、后清理”的环境重置流程,只清除确实过期的缓存与状态,而非无差别删除全部内容。

主要能力:加载时读取 ../../.claude-plugin/plugin.json 并显示 clean v{version}。工作流分四步:诊断、建议、清理、可选验证。诊断脚本 bash ${CLAUDE_SKILL_DIR}/scripts/diagnose.sh 输出 JSON 报告,覆盖端口 8081(lsof -i :8081)、Watchman 监视列表、node_modules 与 lockfile 时间戳一致性、Pods 与 Podfile 时间戳、DerivedData 大小、Android 构建状态、Metro 缓存等检查项。清理脚本 bash ${CLAUDE_SKILL_DIR}/scripts/clean.sh [flags] 支持按目标清理:--metro(/tmp/metro-、/tmp/haste- 等临时缓存)、--watchman(监视与内部状态)、--node-modules(删除后重装)、--pods(删除 ios/Pods 与 Podfile.lock 后 pod install)、--derived-data(~/Library/Developer/Xcode/DerivedData)、--gradle(android/.gradle、android/app/build)、--all(全部,最后手段)。

使用方式:先运行诊断并汇总结果,再仅推荐必要步骤;执行破坏性清理前必须获得用户确认,未经明确批准不得运行 --all 或 --node-modules。清理后可选用 npx react-native start 启动 Metro 验证,若可用则通过 ios-sim 技能启动应用。

适用场景:Metro 打包错误或模块解析异常、文件变更检测失效、依赖损坏或切换分支后版本不一致、原生依赖变更后的 iOS 构建错误、Xcode 或 Gradle 构建失败等。

限制:多数问题只需 1–2 项定向清理;Metro 无法启动时先查 8081 端口是否有僵尸进程;构建错误可结合 docs 技能查阅 API 与配置。具体版本号、脚本内部实现与平台支持范围暂未提供。