菜单
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).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.
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 | code-structure |
| description | 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). |
When the question is "list the X in Y", do not Read the whole file. Get an outline first, then Read selectively.
1. Compiler/parser-aware tool (preferred when one fits the language -- respects exports, works across files, gives real semantic info):
go doc -all ./path/to/pkgpython -m pydoc some.module.path (needs an importable module, its deps, and PYTHONPATH)cat node_modules/<pkg>/dist/index.d.ts (the .d.ts is a pre-made API outline)javap -p <Class> (needs a compiled .class)2. ast-grep signature pattern (works on any file, no build step; swap the
keyword for function/class/struct/interface/type):
ast-grep -l typescript -p 'export function $NAME($$$)' file.tsast-grep -l python -p 'def $NAME($$$):' file.pyast-grep -l go -p 'func $NAME($$$)' file.go | rg -e '^func [A-Z]'ast-grep -l rust -p 'pub fn $NAME($$$)' file.rs3. ctags fallback (universal, canonical for C/C++):
ctags -f - file | grep -v '^!' | cut -f1,4
(prints symbol + kind)
Use the outline to decide what to Read, then Read just that section.