name: tldr-router description: 将问题映射到最优的tldr命令。用这个来选择合适的分析层
TLDR 智能路由器
将问题映射到最优的tldr命令。用这个来选择合适的分析层。
问题 → 命令映射
“存在哪些文件/函数?”
tldr tree . --ext .py # 文件概览
tldr structure src/ --lang python # 函数/类概览
用途: 开始探索,定位方向
“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
│
├─► "存在什么?" ──► tree / structure
│
├─► "X如何连接?" ──► context / calls
│
├─► "为什么X复杂?" ──► cfg
│
├─► "Y流向了哪里?" ──► dfg
│
├─► "什么依赖于Z?" ──► slice
│
└─► "查找某个东西" ──► search
意图检测关键词
| 意图 | 关键词 | 层 |
|---|---|---|
| 导航 | “what”, “where”, “find”, “exists” | tree, structure, search |
| 架构 | “calls”, “uses”, “connects”, “depends” | context, calls |
| 复杂性 | “complex”, “refactor”, “branches”, “paths” | cfg |
| 数据流 | “variable”, “value”, “assigned”, “comes from” | dfg |
| 影响 | “affects”, “changes”, “slice”, “dependencies” | slice/pdg |
| 调试 | “bug”, “error”, “investigate”, “broken” | cfg + dfg + context |
自动钩子集成
tldr-read-enforcer 和 tldr-context-inject 钩子自动:
- 从您的消息中检测意图
- 路由到适当的层
- 将上下文注入工具调用
您不需要手动运行这些命令 - 钩子为您完成。
手动覆盖
如果您需要钩子未提供的特定层:
# 强制特定分析
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