菜单
TermQ code quality gate. Load when running verification checks before committing. Defines the four checks that must all pass with zero errors.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
TermQ release procedures. Load when executing any release — stable, beta, or hotfix. Covers versioning, tagging, monitoring, and verification.
TermQ development context. Load at session start and when working on TermQ. Covers project structure, module layout, toolchain rules, worktree workflow, settings architecture, and debugging (TermQLogger categories, log streaming, TERMQ_DEBUG mode).
TermQ commit, branch, and PR conventions. Load when creating commits, branches, or pull requests.
TermQ localization workflows. Load when performing any localization task — extracting strings, translating, validating, auditing, or syncing language files.
Sparkle auto-update system for TermQ. Load when working on release workflows, appcast generation, update signing, or debugging update failures. Covers the full update pipeline from signing through delivery.
TermQ Swift code style and patterns. Load when writing or reviewing Swift code. Covers Swift 6 concurrency, error handling, memory management, UI components, and testing.
| name | quality-gate |
| description | TermQ code quality gate. Load when running verification checks before committing. Defines the four checks that must all pass with zero errors. |
All four checks must pass before any code is committed:
| Check | Command | Requirement |
|---|---|---|
| Build | make build | Zero errors, zero warnings |
| Lint | make lint | Zero violations — make lint must exit 0 |
| Format | make format-check | Clean — run make format to fix |
| Tests | make test | All tests pass |
Run all four at once:
make check
The output must be clean. Any warning: or error: lines in the output are failures.
Never proceed to commit with build errors, lint errors, formatting violations, or failing tests.
Verification scope: Always run a clean build before declaring the gate passed:
swift package clean && make check
Incremental compilation caches object files — repeat make check runs will not regenerate warnings for already-compiled test files. Only a clean build guarantees the full warning picture. Never declare success from an incremental build.
If make check passes locally but CI fails, that is a bug — investigate and file an issue rather than pushing again.
Both SwiftLint (line_length: 120) and swift-format (lineLength: 120) enforce 120-character lines. These rules must stay enabled and in sync. Do not disable line_length in .swiftlint.yml.
When a line is too long, fix the code — do not suppress with // swiftlint:disable annotations or by disabling the rule. Long strings must be split manually; neither tool auto-breaks string literals.
Do not add // swiftlint:disable annotations to silence violations. Disabling rules file-wide or project-wide is also forbidden. Every violation must be fixed at the source.
Swift compiler warnings in test files (Tests/**) only appear when test targets compile (i.e., during make check / make test). A clean make build does not guarantee a clean make check. Always use make check as the authoritative gate.