mcpField
T
tldr-router

tldr-router

github.com/parcadei开发3.9k479 次安装39 周前更新
代码仓库

关于 tldr-router

一个为代码探索设计的技能,根据问题意图选择合适的 tldr 命令层级。它涵盖结构、调用关系、复杂度、数据流和影响分析,并说明相关钩子的自动路由行为。

主要功能

  1. 01按问题选择 tldr 命令
  2. 02浏览文件与代码结构
  3. 03分析调用关系和架构
  4. 04检查复杂度与数据流
  5. 05评估代码变更影响
  6. 06支持手动指定分析层

适用场景

  1. 01初次了解代码库结构
  2. 02追踪函数调用与入口
  3. 03调查变量来源或程序错误
  4. 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 钩子会自动:

  1. 从你的消息中检测意图
  2. 路由到相应层
  3. 将上下文注入工具调用

你无需手动运行这些命令——钩子会替你完成。

手动覆盖

如果你需要钩子未提供的特定层:

# 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