菜单
Query reference test results captured from real tclsh (8.4–9.0). Look up individual tests, search groups, view suite summaries, and compare results across Tcl versions.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Compare our compiler's bytecode output against tclsh reference disassembly (8.4, 8.5, 8.6, 9.0). Use when verifying bytecode correctness, investigating instruction sequence differences, or checking that our codegen matches C Tcl.
Debug the Tcl compiler pipeline (lexer → green tree → segmenter → IR → CFG → SSA → codegen) running from source — never a built pyz/zipapp. Wraps the tcl-explorer CLI and adds source-slice and raw-token views that make off-by-one range bugs obvious. Use when investigating a wrong diagnostic position, a stray-brace / unmatched-delimiter false positive, a mis-tokenised word, an IR statement whose range looks wrong, or any time you need to see what the compiler produces for a snippet of Tcl.
Download and extract Tcl source trees (8.4, 8.5, 8.6, 9.0) to tmp/ for test suites and bytecode reference. Idempotent — skips versions already present.
Manage differential-fuzzer findings: query fixed/unfixed status, list by category, verify findings against the current VM, mark findings as fixed/unfixed, and batch-update categories. Use when working on fuzz findings, checking what's fixed, or triaging new results.
Use when verifying Tcl LSP server behavior: semantic tokens, diagnostics, formatting, hover, completion, definition, references, code actions, optimizations, document symbols, diagram extraction, event/command registry lookups, or benchmarking server performance and collecting timing logs. Tests the server directly over JSON-RPC without VS Code.
Run the full release workflow: validate branch, test, generate changelog, tag, push, and publish to all editor marketplaces. Asks for patch/minor/major if not specified. Tag-only — no source-file edits, no commit on main (main is protected).
| name | test-results |
| description | Query reference test results captured from real tclsh (8.4–9.0). Look up individual tests, search groups, view suite summaries, and compare results across Tcl versions. |
| allowed-tools | Bash, Read |
Reads reference test results from tests/test_reference/<version>/ (captured
by scripts/capture/test_results.sh) and provides quick lookups
at any granularity: individual test, group within a suite, or full suite.
python3 .claude/skills/test-results/test_results.py <command> [args...]
| Command | Arguments | What it does |
|---|---|---|
status | Show which versions and suites have reference data | |
summary | [VERSION] | Summary table: suite, total/pass/skip/fail, pass rate |
suite | SUITE [VERSION] | Full results for one suite — lists every PASS/SKIP/FAIL |
group | PATTERN [VERSION] | All tests matching a glob pattern across suites |
lookup | TEST_NAME [VERSION] | Look up one test by name, show status in all versions |
compare | SUITE | Cross-version comparison for a suite (8.4 vs 8.5 vs 8.6 vs 9.0) |
source | TEST_NAME [VERSION] | Extract test source code, parsed options, and file-level setup |
8.4, 8.5, 8.6, or 9.0. Defaults to best available (9.0 > 8.6 > 8.5 > 8.4).compExpr-old or compExpr-old.test (both work).compExpr-old-1.*, expr-old-2?.*, parse-*.
If no wildcards, * is appended automatically.expr-old-29.1, compExpr-old-1.1.$ python3 .claude/skills/test-results/test_results.py summary 9.0
Reference test results — Tcl 9.0
Suite Total Pass Skip Fail Rate
──────────────────────────────── ─────── ─────── ─────── ─────── ──────
compExpr-old.test 184 184 0 0 100.0%
compExpr.test 82 82 0 0 100.0%
expr-old.test 461 426 35 0 100.0%
$ python3 .claude/skills/test-results/test_results.py lookup expr-old-29.1
expr-old-29.1 SKIP (testexprlong) in expr-old.test
Across all versions:
Tcl 8.5: SKIP (testexprlong)
Tcl 8.6: SKIP (testexprlong)
Tcl 9.0: SKIP (testexprlong)
$ python3 .claude/skills/test-results/test_results.py group "compExpr-old-1.*" 9.0
Tests matching 'compExpr-old-1.*' — Tcl 9.0
12 matches
PASSED (12):
compExpr-old-1.1 (compExpr-old.test)
compExpr-old-1.2 (compExpr-old.test)
...
$ python3 .claude/skills/test-results/test_results.py compare expr-old
Cross-version comparison: expr-old
Version Total Pass Skip Fail Rate
────────── ─────── ─────── ─────── ─────── ──────
Tcl 8.4 385 350 35 0 100.0%
Tcl 8.5 461 426 35 0 100.0%
Tcl 9.0 461 426 35 0 100.0%
Tests that differ between versions (76):
...
$ python3 .claude/skills/test-results/test_results.py source incr-1.28 8.6
=== incr-1.28 (incr.test:219 — Tcl 8.6) ===
Reference result: PASS
--- File-level setup ---
proc readonly varName {
upvar 1 $varName var
trace add variable var write \
{apply {{args} {error "variable is read-only"}}}
}
--- Test ---
test incr-1.28 {TclCompileIncrCmd: runtime error, readonly variable} -body {
set x 123
readonly x
list [catch {incr x 1} msg] $msg $::errorInfo
} -match glob -cleanup {
unset -nocomplain x
} -result {1 {can't set "x": variable is read-only} {*variable is read-only ...}}
--- Parsed ---
Name: incr-1.28
Description: TclCompileIncrCmd: runtime error, readonly variable
Body: set x 123 \n readonly x \n list [catch {incr x 1} msg] ...
Result: 1 {can't set "x": variable is read-only} ...
Match: glob
Cleanup: unset -nocomplain x
Reference data must be captured first:
./scripts/capture/test_results.sh
$ARGUMENTS