用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/tomevault-io/tomes --skill tsa-index命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
> Use when this capability is needed.
Use when writing kernel, account, or note MASM code that reads from or writes to the advice provider (advice stack / advice map) — validate advice data.
Use when writing a Rust test that exercises a failure path or a MASM test that expects a `panic` / `assert` — assert on the specific expected error variant or error code.
基于 SOC 职业分类
正在显示 SKILL.md
| name | tsa-index |
| description | | Use when this capability is needed. |
Not a daily skill. Most agents never need it. Pull when index is stale or a language plugin behaves oddly.
| Goal | Tool |
|---|---|
| Status / stats of the AST cache | index action=cache (mode=status) |
| Force rebuild | index action=full |
| Incremental refresh | index action=cache (mode=index) |
| Watch a directory and auto-refresh | index action=cache (mode=watch_start) |
| AST-level diff of one file across commits | edit action=ast_diff |
| First-time index for a freshly-cloned repo | index action=auto |
| Full bulk reindex (large monorepo) | index action=full |
| "Is the python plugin / swift plugin ready" | project action=parser |
The auto-cache is usually correct. Force rebuild only when:
--callees / --callers returns callee_resolution: unknown consistently
AND the symbols clearly exist (means imports not indexed)uv run tree-sitter-analyzer --ast-cache --ast-cache-mode index --ast-cache-force
# OR safer (preserves what works):
uv run tree-sitter-analyzer --ast-cache --ast-cache-mode index
For structural change detection (not text):
edit action=ast_diff file_path="..." base_ref="HEAD~5" head_ref="HEAD"
# returns: {nodes_added: n, nodes_removed: n, nodes_modified: n,
# classification_hints: [...]}
Useful for distinguishing pure formatting from real change.
project action=parser language="swift"
# returns: {status: "stable|beta|stub", supported_queries: [...], limitations: [...]}
Avoid asking "why doesn't swift work" — query this first.
uv run tree-sitter-analyzer --ast-cache --ast-cache-mode stats
uv run tree-sitter-analyzer --ast-cache --ast-cache-mode index --ast-cache-force
uv run tree-sitter-analyzer --ast-diff --ast-diff-file <file> --ast-diff-old-ref HEAD~5 --ast-diff-new-ref HEAD
uv run tree-sitter-analyzer --parser-readiness swift
uv run tree-sitter-analyzer --autoindex # index action=auto
uv run tree-sitter-analyzer --full-index # index action=full
# WARNING: slow — can exceed 60s on medium-large repos (~2000 files / 100K+ edges).
# Prefer `--ast-cache --ast-cache-mode index` for an incremental refresh.
# `--full-index` defaults to mode 'incremental'; pass `--full-index-mode full` for a
# true full rebuild, and `--full-index-max-files N` (default 20000) to cap scope.
--full-index on a small project — --ast-cache --ast-cache-mode index is faster--watch and --watch-health in the same process — see tsa-health-watchSource: aimasteracc/tree-sitter-analyzer — distributed by TomeVault.