菜单
Fix SwiftLint errors and SwiftFormat violations in NetMonitor-2.0. Use when the pre-commit hook blocks a commit, the CI lint job fails, or before opening a PR. Errors block commits; warnings do not.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Run the iOS functional smoke test suite on the remote Mac mini. Verifies all tools, dashboard, network map, settings, and timeline produce correct outcomes with screenshot capture at each verification point.
Scaffold a new SwiftData @Model class for NetMonitor-2.0. Creates the model file in NetMonitorCore, registers it in SchemaV1, regenerates the Xcode project, and verifies the build.
Run the NetMonitor-2.0 test suite. CRITICAL — tests must run on the mac-mini via SSH, never locally on this machine (no display session for UI tests, and the PreToolUse hook blocks local xcodebuild test calls). Use this skill any time you need to verify tests pass before committing or completing work.
Builds iOS SwiftUI views, ViewModels, platform services, and AR features for the heatmap feature in NetMonitor-iOS.
Builds macOS SwiftUI views, ViewModels, and platform services for the heatmap feature in NetMonitor-macOS.
Builds shared Swift core logic in NetMonitorCore — models, services, renderers, serialization, and unit tests.
| name | fix-lint |
| description | Fix SwiftLint errors and SwiftFormat violations in NetMonitor-2.0. Use when the pre-commit hook blocks a commit, the CI lint job fails, or before opening a PR. Errors block commits; warnings do not. |
swiftlint lint --quiet # All violations (errors + warnings)
swiftlint lint --quiet --reporter xcode # Xcode-style paths (click to jump in editor)
swiftformat --lint . # Format violations
swiftlint --fix --quiet # Fixes: trailing whitespace, comma spacing, colon spacing, etc.
swiftformat . # Fixes: semicolons, empty braces, guard-else, etc.
Always re-run after auto-fixing to confirm no errors remain:
swiftlint lint --quiet | grep ": error:" | wc -l # Must be 0 before committing
swiftformat --lint . # Must show 0 files
todo_needs_ticket — TODO without beads ID// Bad:
// TODO: fix this later
// Good:
// TODO: (NetMonitor-2.0-xyz) fix this later
File the beads issue first (bd create), then reference it.
force_unwrapping — force unwrap (!)// Bad:
let value = someOptional!
// Good:
guard let value = someOptional else { return }
// or:
let value = someOptional ?? defaultValue
cyclomatic_complexity — function too complexBreak the function into smaller private helper functions. Threshold: warning at 12, error at 20.
type_body_length — struct/class too largeExtract logical groupings into extensions or separate types.
identifier_name — variable name too short// Bad (1 char not in allowed list):
let n = items.count
// Good:
let itemCount = items.count
Allowed single-char names: i, j, k, x, y, z, id, ip.
line_length — line too longBreak long lines. Warning at 150 chars, error at 250. Comments and URLs are exempt.
| File | Purpose |
|---|---|
.swiftlint.yml | All SwiftLint rules and thresholds |
.swiftformat | SwiftFormat rules (correctness-only baseline) |
.githooks/pre-commit | Runs both tools on staged files before each commit |
.github/workflows/lint.yml | CI jobs: swiftlint + swiftformat + bare-TODO check |
// swiftlint:disable:next force_unwrapping
let image = UIImage(named: "logo")! // guaranteed to exist in bundle
// For a whole scope:
// swiftlint:disable force_unwrapping
...
// swiftlint:enable force_unwrapping
Always add a comment explaining why suppression is justified.