Force Unwrap Scanner

专为iOS/macOS的Swift项目设计，核心功能包括扫描代码中的`!`强制解包与`try!`使用，按高/中/低风险分级，生成详细报告并提供修复建议，还支持交互式修复（高风险项需手动确认）。适用于开发者排查潜在运行时崩溃隐患，通过执行带scan/report/fix参数的脚本操作，输出控制台结果或HTML报告。

soponcd

热度 34.73

最近更新 2026-05-11 17:36:23

分类：开发依赖：代码执行 / 读写文件应用场景：代码审查 / 调试排错

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add force-unwrap-scanner

Metadata

name: force-unwrap-scanner
description: 扫描并报告 Swift 项目中的强制解包（!）和 try! 使用情况，识别潜在崩溃风险
domain: ios-macos
risk: low
version: 1
homepage: https://github.com/soponcd/timeflow-skills/tree/main/teams/skills/force-unwrap-scanner
metadata: {"clawdbot":{"emoji":"🔎"}}

Force Unwrap Scanner

扫描并报告项目中的强制解包使用情况，帮助识别潜在的运行时崩溃风险。

功能

扫描项目中所有的 try! 和 ! 强制解包使用
按风险等级分类（高/中/低）
生成详细报告
提供修复建议

使用方法

cd .agent/skills/force-unwrap-scanner
./RunSkill.sh [scan|report|fix]

参数说明

scan - 扫描项目并输出结果
report - 生成详细的 HTML 报告
fix - 交互式修复（高风险项需要手动确认）

风险分级

风险等级	说明	示例
🔴 高	EKEventStore、SwiftData、FileIO 等系统级操作	`try! EKEventStore()`
🟡 中	数据库查询、网络请求	`try! fetchTasks()`
🟢 低	本地数据、已知安全值	`let x = dict["key"]!`

输出示例

🔍 Force Unwrap Scanner Report
===================================

Total: 3 findings
  🔴 High: 1
  🟡 Medium: 1
  🟢 Low: 1

Files with issues:
  TimeFlow/Services/EventKitService.swift:35
  TimeFlow/ViewModels/AppState.swift:12
  TimeFlow/Helpers/ParseHelper.swift:45