@@ -2,7 +2,7 @@
|
||||
|
||||
## Когда использовать
|
||||
|
||||
Используй этот skill при добавлении CI, release scripts, build fixes, test changes, dependency updates, packaging changes или перед финальным отчетом по крупной задаче.
|
||||
Используй этот skill при изменениях CI, release scripts, tests, dependencies, Tauri/NSIS packaging, offline component catalog или перед финальным отчётом по крупной задаче.
|
||||
|
||||
## Minimal local checks
|
||||
|
||||
@@ -10,109 +10,84 @@ Frontend:
|
||||
|
||||
```powershell
|
||||
npm ci
|
||||
npm run format:check
|
||||
npm run lint
|
||||
npm run typecheck
|
||||
npm test -- --run
|
||||
npm run build
|
||||
```
|
||||
|
||||
Rust:
|
||||
|
||||
```powershell
|
||||
cd src-tauri
|
||||
Push-Location src-tauri
|
||||
cargo fmt --all -- --check
|
||||
cargo clippy --all-targets --all-features -- -D warnings
|
||||
cargo test --all-targets
|
||||
Pop-Location
|
||||
```
|
||||
|
||||
Tauri:
|
||||
Tauri/build/release boundaries:
|
||||
|
||||
```powershell
|
||||
npm run tauri -- info
|
||||
npm run tauri -- build
|
||||
& .\scripts\check-runtime-powershell-boundary.ps1 -CheckOnly
|
||||
& .\scripts\update-component-bundle.ps1 -PlanOnly
|
||||
& .\scripts\update-component-bundle.ps1 -CheckOnly
|
||||
& .\scripts\audit-windows-smoke.ps1 -Mode PlanOnly
|
||||
& .\scripts\prepare-release.ps1 -PlanOnly -SkipBuild
|
||||
```
|
||||
|
||||
PowerShell plan-only:
|
||||
|
||||
```powershell
|
||||
& .\scripts\install-control-app.ps1 -PlanOnly
|
||||
& .\scripts\install-proxyfier.ps1 -PlanOnly
|
||||
& .\scripts\install-singbox.ps1 -PlanOnly
|
||||
```
|
||||
`PlanOnly`/`CheckOnly` должны возвращать structured JSON с `changed: false` и не менять repo, ProgramData, services или network state.
|
||||
|
||||
## Interaction smoke for UI motion
|
||||
|
||||
Build, lint, and unit tests do not validate motion or pointer behavior. For any hover, disclosure, stagger, or hit-target change, verify:
|
||||
Build, lint и unit tests не проверяют motion/geometry. Для hover, disclosure, stagger или hit-target изменений проверь first/repeated/rapid toggle, keyboard focus, loading/long labels, `prefers-reduced-motion`, desktop и narrow window. Если visual smoke не выполнен, так и напиши.
|
||||
|
||||
- first open and first close;
|
||||
- repeated and rapid toggle;
|
||||
- hover and click before, during, and after transition;
|
||||
- keyboard focus and hidden-control tab order;
|
||||
- loading and longest localized labels;
|
||||
- `prefers-reduced-motion`;
|
||||
- desktop and narrow window geometry.
|
||||
## CI contract
|
||||
|
||||
Use a controlled mock or preview state when backend status is difficult to reproduce. If no visual interaction smoke is possible, report that evidence as missing and do not claim the motion task is complete.
|
||||
Windows baseline должен включать:
|
||||
|
||||
## CI recommendation
|
||||
- frontend format/lint/typecheck/tests/build;
|
||||
- Rust fmt/clippy/all-target tests;
|
||||
- Tauri environment check;
|
||||
- runtime PowerShell boundary check;
|
||||
- offline bundle PlanOnly + CheckOnly;
|
||||
- Windows audit PlanOnly;
|
||||
- release preparation PlanOnly with build skipped.
|
||||
|
||||
Add GitHub Actions with at least:
|
||||
|
||||
- frontend build on Windows and Ubuntu if practical;
|
||||
- Rust fmt/clippy/test;
|
||||
- PowerShell syntax/plan-only smoke on Windows;
|
||||
- Tauri build on Windows for release branches/tags;
|
||||
- artifact upload only for trusted release workflow.
|
||||
CI не изображает реальную SCM/UAC/driver проверку. Artifact upload и tag/publish допустимы только в отдельном trusted release workflow после принятой VM evidence.
|
||||
|
||||
## Dependency updates
|
||||
|
||||
When changing dependencies:
|
||||
|
||||
- Update lockfiles.
|
||||
- Check Tauri v2 compatibility.
|
||||
- Avoid adding large UI/runtime dependencies for tiny tasks.
|
||||
- Avoid adding shell/process libraries that bypass existing backend boundaries.
|
||||
- Note why dependency is needed.
|
||||
- Обновить lockfiles.
|
||||
- Проверить Tauri v2 и Windows x64 compatibility.
|
||||
- Не добавлять dependency, если stdlib/native API или уже установленный crate решает задачу.
|
||||
- Не добавлять shell/process library, возвращающую production PowerShell path.
|
||||
- Объяснить, зачем dependency нужна и какой owner её вызывает.
|
||||
|
||||
## Release hygiene
|
||||
|
||||
Before release:
|
||||
Перед release candidate:
|
||||
|
||||
- Verify app version in `package.json` and Tauri config if applicable.
|
||||
- Verify icons/assets size.
|
||||
- Verify CSP and capabilities.
|
||||
- Verify no raw secrets/test URLs in repo.
|
||||
- Verify installer scripts with `-PlanOnly`.
|
||||
- Verify clean install on Windows VM.
|
||||
- Verify external SOCKS5 flow.
|
||||
- Verify local sing-box subscription flow.
|
||||
- Verify uninstall/safe cleanup behavior.
|
||||
- версии совпадают в `package.json`, `package-lock.json`, `src-tauri/tauri.conf.json` и `src-tauri/Cargo.toml`;
|
||||
- packaged component catalog, asset hashes, licenses и `THIRD_PARTY_NOTICES.md` согласованы;
|
||||
- installer содержит consolidated offline component bundle и WebView2 Offline Installer;
|
||||
- runtime PowerShell checker проходит, bundled cleanup script отсутствует;
|
||||
- NSIS hook разделяет verify-only upgrade и full managed uninstall;
|
||||
- fresh offline VM, legacy upgrade/rollback, foreign service refusal, UAC cancel, uninstall/reboot и реальные routing flows записаны в evidence;
|
||||
- tag/publish выполняются только для того же проверенного commit.
|
||||
|
||||
## Final report format
|
||||
Установка Control App не должна скрыто install/start/update routing-компоненты. Payloads могут быть в installer, но component mutation остаётся отдельным user action.
|
||||
|
||||
```text
|
||||
Changed:
|
||||
- ...
|
||||
## Финальный отчёт
|
||||
|
||||
Verified:
|
||||
- npm run build
|
||||
- cargo test
|
||||
Разделить:
|
||||
|
||||
Not verified:
|
||||
- Windows elevated install/uninstall, because ...
|
||||
- `Проверено`: точные команды и результаты;
|
||||
- `Не проверено`: Windows VM/UAC/SCM/driver/installer gaps;
|
||||
- `Риски`: только конкретные release blockers.
|
||||
|
||||
Risks:
|
||||
- ...
|
||||
```
|
||||
Не писать «все тесты проходят», если весь релевантный набор действительно не запускался.
|
||||
|
||||
Do not write “all tests pass” unless all listed relevant tests actually ran. Humanity has enough fictional dashboards.
|
||||
|
||||
## Как отчитываться
|
||||
|
||||
Перед финальным ответом применить `.agent/skills/communication-reporting/SKILL.md` и `.agent/checklists/communication.md`.
|
||||
|
||||
Минимум для нетривиальной задачи:
|
||||
|
||||
- короткая сводка;
|
||||
- таблица файлов `Файл / Что изменилось / Зачем`;
|
||||
- важные места без пересказа каждой строки;
|
||||
- что проверено;
|
||||
- что не проверено;
|
||||
- конкретные риски.
|
||||
Перед ответом применить `.agent/skills/communication-reporting/SKILL.md` и `.agent/checklists/communication.md`.
|
||||
|
||||
Reference in New Issue
Block a user