القائمة
Debug bugs in Qaio. NEVER guess. Read log files first (backend + frontend). Add targeted tracing/logger if not enough info. Never ask user to copy-paste terminal output.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Build Qaio App locally (macOS). Clean stale artifacts, pnpm tauri build, notarize DMG manually (Tauri skips), staple, verify, copy to ~/Desktop/Qaio-{version}.dmg. Fallback when CI broken.
Ship new Qaio version. Bump semver across all packages, tag, push, let CI build + sign + notarize. STOP at draft — user publishes manually. Defaults patch bump. Minor needs explicit user permission.
Process a batch of PDF or CSV bank and credit-card statements end to end: extract every transaction (parallel Haiku subagents), canonicalize the party names, categorize against your locked chart of accounts (parallel Sonnet subagents), detect inter-account transfers, and assemble a reviewed Google Sheets workbook with a formula-driven P&L. Reconciliation mismatches surface as warnings, low-confidence categorizations land in Suspense — I never invent an account code, never silently plug a number, never post to your accounting system.
Set up your books from scratch with one founder interview that captures entity, fiscal year, accounting method, registered accounts, payroll posture, revenue model, investor cadence, and tax preparer, then writes the live bookkeeping brief every other skill reads first. Sub-mode `mode=opening-balances` captures your opening trial balance from a spreadsheet, CSV, or prior-accountant export. I never connect a bank, post to a general ledger, or move money from this skill — facts and a brief, full stop.
Tell me the basics about your company so I can give you better legal help. I ask a few quick questions about your entity, cap table, contracts in force, templates, and any open risks. You only need to do this once, and I keep it updated as things change.
Tell me the basics about your company, your customer, and how you talk so I can give you better marketing help. I ask a few quick questions about your product, positioning, ideal customer, voice, and what you're selling right now. You only need to do this once, and I keep it updated as things change.
| name | debug |
| description | Debug bugs in Qaio. NEVER guess. Read log files first (backend + frontend). Add targeted tracing/logger if not enough info. Never ask user to copy-paste terminal output. |
NEVER guess. Logs always faster than speculation.
Bug occurs + fix not obvious →
tracing::debug!() (Rust) or logger.debug() (TS).| Layer | File | Contents |
|---|---|---|
| Backend | ~/.qaio/logs/backend.log | Rust tracing — sessions, agent store, channels, watcher |
| Frontend | ~/.qaio/logs/frontend.log | JS console.error/warn, React crashes, Tauri cmd failures |
Both daily rolling. Latest = current file.
tracing::info!("session {id} started");
tracing::warn!(?error, "unexpected");
tracing::error!(?err, "failed to write");
tracing::debug!(agent = %agent_id, "received event");
Output → backend.log via tracing-subscriber + daily rolling file appender.
Levels: default info globally. debug for qaio_terminal_manager + qaio_tauri. Override: RUST_LOG=debug,crate_name=trace.
import { logger } from "@/lib/logger";
logger.error("fetch failed", { url, status });
logger.warn("retry", { attempt });
logger.info("user clicked");
logger.debug("render", { props });
Also console.error + console.warn patched to auto-write to frontend.log.
"Report bug" button on error toasts auto-attaches last 50 lines from both logs.
tracing::debug!(?relevant_vars, "descriptive message") at branch pointsclaude/wipDon't leave debug logs in. Remove after fix or downgrade to trace!.
unwrap() to silence compile errors → hides real failurelet _ = x.await on ops that can fail → silent failure (banned by style rules)# Tail backend
tail -f ~/.qaio/logs/backend.log
# Last 100 lines
tail -100 ~/.qaio/logs/backend.log
# Grep for pattern
grep -i error ~/.qaio/logs/backend.log
Use the dedicated Read tool, not bash cat/head/tail, when operating through Claude Code.