tritonkit-real-project-regression

Validates TritonKit against real iOS and Harmony apps using the triton CLI and evidence capture.

1|Updated May 15, 2026
One-click install
npx skills add https://github.com/NeptuneKit/TritonKit --skill tritonkit-real-project-regression-neptunekit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tritonkit-real-project-regression
Source: https://github.com/NeptuneKit/TritonKit/tree/main/TritonKit.skills/tritonkit-real-project-regression
Command: npx skills add https://github.com/NeptuneKit/TritonKit --skill tritonkit-real-project-regression-neptunekit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Moving a debugging runtime from demo smoke tests into a real customer app exposes gaps that self-tests never find: stale targets, unverified business state, leaked private data in public reports, and unproven regression claims. This Skill guides an AI agent through disciplined real-project regression testing of TritonKit so every finding is backed by machine-readable evidence and every product gap becomes a doc update, fix, or redacted GitHub issue. ## Core Features & Use Cases - Isolated real-app validation: Keeps external app repo changes separate from TritonKit commits, prefers the released Homebrew triton CLI, and verifies binary identity with triton version --json before any flow. - Triton-first command workflow: Preserves doctor, status, capabilities, and schema JSON facts before any fallback to raw xcrun, hdc, or xcodebuild, and treats schema contract anomalies as reportable TritonKit bugs. - Evidence-gated completion: Uses triton evidence capture, screenshots, wait/verify, and replay plans so a host action acknowledgement is never mistaken for a business verdict. - Redaction and issue filing: Enforces redaction of bundle IDs, private paths, accounts, and unredacted evidence before anything is published, routing gaps into the tritonkit-dev-feedback flow. - Use Case: An agent validating TritonKit in a customer's iOS app boots the simulator through triton sim, connects the DEBUG embedded runtime, runs an observe-act-verify flow, captures a .tritonevidence bundle, redacts it, and files a sanitized issue for a discovered capability gap. ## Quick Start Ask the agent to run a real-project regression of TritonKit against your iOS or Harmony app, starting with triton doctor and capabilities checks and ending with redacted evidence for every finding.

Frequently Asked Questions about tritonkit-real-project-regression

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I regression test TritonKit against a real iOS app?▼

Confirm the app repo, branch, and target device, verify the CLI with triton version --json, start triton serve on port 19421, then preserve doctor, status, capabilities, and schema output before running observe, act, and verify steps. Finish with triton evidence capture so the result has a machine-readable pass/fail artifact.

How do I validate a HarmonyOS app with the triton CLI?▼

Use host-side commands that need no app dependency: triton device doctor --platform harmony, device list, wait-ready, app install with a signed HAP, app launch, and triton smoke harmony. For a standalone embedded runtime, use direct checks with --runtime-base-url against the forwarded port.

Does a successful tap or launch command prove the app flow worked?▼

No. Host action acknowledgements such as tap, simctl openurl, or xcode run only prove submission. The workflow requires a follow-up wait, verify, snapshot, screenshot, or evidence capture that confirms the expected business state before claiming success.

When can I fall back to raw xcrun, simctl, or hdc instead of triton?▼

Fallback is allowed only after Triton reports failure, an unsupported capability, or a missing schema entry for the needed action. You must preserve the Triton-first evidence such as doctor, capabilities, or schema output in the regression report before using the raw tool.

What must be redacted before filing a public TritonKit issue?▼

Remove real app names, bundle IDs, team IDs, organization names, usernames, emails, phone numbers, internal hosts, absolute private paths, full logs, and unredacted screenshots or evidence bundles. Keep versions, command names, error codes, and minimal sanitized reproduction details.

What are the limitations of replay dry-run and offline diagnostics?▼

Replay dry-run, local-simulated, and matrix modes are offline diagnostics only; even passed results carry verdictBoundary.countsAsRealTestVerdict=false and cannot serve as regression evidence or reliability-gate samples. Only a real replay, smoke, wait, assert, or evidence capture against the app counts as a verdict.