关于 tldr-router
一个为代码探索设计的技能,根据问题意图选择合适的 tldr 命令层级。它涵盖结构、调用关系、复杂度、数据流和影响分析,并说明相关钩子的自动路由行为。
主要功能
- 01按问题选择 tldr 命令
- 02浏览文件与代码结构
- 03分析调用关系和架构
- 04检查复杂度与数据流
- 05评估代码变更影响
- 06支持手动指定分析层
适用场景
- 01初次了解代码库结构
- 02追踪函数调用与入口
- 03调查变量来源或程序错误
- 04评估重构的影响范围
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ parcadei/ continuous-claude-v3 --skill tldr-router安装后在 Claude Code 中输入/tldr-router确认已加载。
详细介绍
TLDR 智能路由器
将问题映射到最合适的 tldr 命令。用它来选择正确的层。
问题 → 命令映射
“有哪些文件/函数?”
tldr tree . --ext .py # File overview
tldr structure src/ --lang python # Function/class overview
用途: 开始探索、了解概况
“X 调用了什么/谁调用了 X?”
tldr context <function> --project . --depth 2
tldr calls src/
用途: 理解架构、查找入口点
“X 有多复杂?”
tldr cfg <file> <function>
用途: 找出重构候选项、了解难度
“变量 Y 从哪里来?”
tldr dfg <file> <function>
用途: 调试、理解数据流
“哪些内容会影响第 Z 行?”
tldr slice <file> <function> <line>
用途: 影响分析、安全重构
“搜索模式 P”
tldr search "pattern" src/
用途: 查找代码、进行结构化搜索
决策树
START
│
├─► "What exists?" ──► tree / structure
│
├─► "How does X connect?" ──► context / calls
│
├─► "Why is X complex?" ──► cfg
│
├─► "Where does Y flow?" ──► dfg
│
├─► "What depends on Z?" ──► slice
│
└─► "Find something" ──► search
意图检测关键词
| 意图 | 关键词 | 层 |
|---|---|---|
| 导航 | “什么”“哪里”“查找”“存在” | tree、structure、search |
| 架构 | “调用”“使用”“连接”“依赖” | context、calls |
| 复杂度 | “复杂”“重构”“分支”“路径” | cfg |
| 数据流 | “变量”“值”“赋值”“来自” | dfg |
| 影响 | “影响”“更改”“切片”“依赖项” | slice/pdg |
| 调试 | “错误”“故障”“调查”“损坏” | cfg + dfg + context |
自动钩子集成
tldr-read-enforcer 和 tldr-context-inject 钩子会自动:
- 从你的消息中检测意图
- 路由到相应层
- 将上下文注入工具调用
你无需手动运行这些命令——钩子会替你完成。
手动覆盖
如果你需要钩子未提供的特定层:
# Force specific analysis
tldr cfg path/to/file.py function_name
tldr dfg path/to/file.py function_name
tldr slice path/to/file.py function_name 42
评论
支持 Markdown