菜单
Structural code search and refactoring via ast-grep. Reach for this when Edit fails with 'old_string not unique', when refactoring across formatting variations, or when matching code shape rather than text.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Get an outline (functions/classes/exports) of a file or package without reading it whole. Use when the question is 'list/show/what's in' rather than 'where is' (search) or 'how does it work' (read).
Use when deciding whether to add a third-party dependency or library, or when evaluating an existing one (npm install, pip install, go get, cargo add, adding to a manifest). Covers crypto/security deps, the build-it-yourself threshold, and transitive-tree risk.
Extract a known field from a JSON file by running jq instead of reading the whole file.
Use when working in a Python repo and about to run python, pip, pytest, ruff, mypy, or any Python tool. Resolves the project virtualenv and requires full ./venv/bin/<tool> paths in all commands, plan files, and subagent prompts. Never run bare pytest or python.
Use when producing substantial prose -- docs, READMEs, design notes, PR descriptions, commit messages, long explanations, or report writeups. The full Strunk & White economy rules, the cut-list of needless constructions, the AI-tell vocabulary blocklist, and cadence guidance. The two always-on guardrails (no em-dashes, avoid AI tells) live in AGENTS.md.
Extract a known field from a YAML file by running yq instead of reading the whole file.
| name | ast-grep |
| description | Structural code search and refactoring via ast-grep. Reach for this when Edit fails with 'old_string not unique', when refactoring across formatting variations, or when matching code shape rather than text. |
Search and rewrite code by AST shape instead of literal text. Resilient to whitespace, line breaks, and formatting differences that defeat string matching.
ast-grep -l LANG -p 'PATTERN'ast-grep -l LANG -p 'OLD' -r 'NEW'ast-grep -l LANG -p 'OLD' -r 'NEW' --update-all-l (language) is required -- auto-detection is unreliable. The
interactive flag -i does not work from this harness.
$VAR -- a single AST node (an expression or identifier)$$$ARGS -- zero or more list items (function args, statement bodies)$$STMT -- multiple statementsRename a function across all call sites:
ast-grep -l typescript -p 'oldFn($$$ARGS)' -r 'newFn($$$ARGS)'
Rename a method on any receiver:
ast-grep -l javascript -p '$OBJ.oldMethod($$$ARGS)' -r '$OBJ.newMethod($$$ARGS)'
Rewrite imports:
ast-grep -l typescript -p 'import $WHAT from "old-pkg"' -r 'import $WHAT from "new-pkg"'
Run without -r to see matches, with -r to preview the diff, then add
--update-all to apply. For surgical per-site control, use ast-grep to find the
locations and the Edit tool to apply each change.