Codexqa Rootcause Analyzer

What it does

When your agent uses it

• The user mentions codexqa-rootcause-analyzer
• AI code diagnosis
• Stack diagnosis
• Asks to turn an exception into a root-cause report

Example prompts

• “Use the codexqa-rootcause-analyzer skill to diagnose exception root causes from stack traces, logs, call-chain dumps, and debug output using the…”
• “/codexqa-rootcause-analyzer”

Requirements

• Node.js
• Compatibility (from SKILL.md): Requires Node.js 22+ and git on PATH when cloning remotes. Talks to the `@openqa-cn/codexqa` CLI via npm (`codexqa` binary only); do not copy engine or skill source. Task data lives under this skill's `data/` directory.

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

1. 1Collect exception evidence and the code location. Write an exception file if needed.
2. 2One process: run (or submit --with-analyze) with --exception/--exception-file plus --git/--branch, --file, or --dir. Bare flags without…
3. 3run writes brief.json, facts.json, and a heading-only report.draft.md. It does not author or persist report.md. parse-exception is already…
4. 4If stdout has facts / factsPath, fill report.draft.md from facts.json in one pass (Report rules below). If codexqa.ready=true and brief…
5. 5write-report --from-draft. If stdout has storyGaps, edit the draft once from that output and retry. Do not retry to shrink length.
6. 6Show one English paragraph from stdout chat.en (the first line of Executive summary) plus paths to report.md / report.en.md / report.html…
7. 7Observe stdout/meta timings after every CLI step. If a step is abnormally slow, diagnose that delay and fix it before continuing RCA.
8. 8Skill defects (mandatory): if a step is wrong, truncates, skips a rule, or is flaky, first encode the rule in TypeScript (scripts/*.ts +…

What it can do on your machine

Read from SKILL.md and the folder at commit 7839542. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (JavaScript, from the files we listed), which the agent can run.

  Shell commands in SKILL.md call:

  • node
  • git
  • npm

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • registry.npmjs.org

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Requires Node.js 22+ and git on PATH when cloning remotes. Talks to the `@openqa-cn/codexqa` CLI via npm (`codexqa` binary only); do not copy engine or skill source. Task data lives under this skill's `data/` directory.

  From compatibility in the SKILL.md frontmatter.

Context cost

Codexqa Rootcause Analyzer loads about 2.6k tokens when it runs, and up to ~6.6k if it reads all its reference files. Until then it costs about 160 tokens; SKILL.md has 1,054 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~160

When it runs · the whole SKILL.md, loaded when a task matches

~2.6k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~6.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from openqa-cn/codexqa at commit 7839542, republished under its Apache-2.0 licence (© openqa-cn). 1,054 words, ~2,599 tokens.

name

codexqa-rootcause-analyzer

description

Diagnoses exception root causes from stack traces, logs, call-chain dumps, and debug output using the CodexQA CLI for structured repo analysis. Use when the user mentions codexqa-rootcause-analyzer, exception RCA, crash analysis, AI code diagnosis, stack diagnosis, 异常根因, 堆栈诊断, 崩溃分析, 异常诊断, or asks to turn an exception into a root-cause report. Not structure/impact analysis (that is codexqa-code-analyzer), not SAST + Agent LLM Detection code-risk scan reports (that is codexqa-defect-analyzer), and not CodexQA evidence-pack HTML review (that is codexqa-code-reviewer). Former skill name: root-cause-diagnosis.

compatibility

Requires Node.js 22+ and git on PATH when cloning remotes. Talks to the `@openqa-cn/codexqa` CLI via npm (`codexqa` binary only); do not copy engine or skill source. Task data lives under this skill's `data/` directory.

license

Apache-2.0

metadata.author

open-source

metadata.version

0.0.1

metadata.open-standard

agentskills

node "$SKILL_SCRIPT" run --exception-file "$PATH" --dir "$LOCAL_DIR"
# uploaded business file (non-git OK; stack sibling sources in the same folder are bundled):
#   node "$SKILL_SCRIPT" run --exception-file "$PATH" --file /abs/path/OrderService.java
# remote:
#   node "$SKILL_SCRIPT" run --exception "$TEXT" --git "$GIT_URL" --branch "$BRANCH"
# already-open IDE / cwd:
#   node "$SKILL_SCRIPT" run --exception "$TEXT"
# stepwise (debug only):
node "$SKILL_SCRIPT" submit --exception-file "$PATH" --dir "$LOCAL_DIR"
node "$SKILL_SCRIPT" ensure-codexqa --task-id $TASK_ID --with-analyze
# fill data/<id>/report.draft.md from facts.json, then:
node "$SKILL_SCRIPT" write-report --task-id $TASK_ID --from-draft

© openqa-cn, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 39 other files (scripts, references, assets) in skills/codexqa-rootcause-analyzer of openqa-cn/codexqa.

• SKILL.md
• .gitignore
• .meta.json
• HOW_IT_WORKS.md
• HOW_IT_WORKS.zh-CN.md
• KNOWN_LIMITATIONS.md
• KNOWN_LIMITATIONS.zh-CN.md
• README.md
• README.zh-CN.md
• assets/report-chrome.css
• assets/report-chrome.js
• data/.gitkeep
• package.json
• references/codexqa.md
• references/exception-parse.md
• references/report-template.md
• references/workflow.md
• scripts
• … and 22 more

Open the folder on GitHubat commit 7839542