name: repoprompt description: 使用 RepoPrompt CLI 进行 token 高效的代码库探索 allowed-tools: [Bash, Read]
RepoPrompt 技能
何时使用
- 探索代码库结构（树状图、代码地图）
- 搜索代码 带有上下文行
- 获取代码签名 无需完整文件内容（token 高效）
- 读取文件切片（特定行范围）
- 构建上下文 用于任务
Token 优化
RepoPrompt 比原始文件读取更 token 高效：
structure→ 仅签名（非完整内容）read --start-line --limit→ 切片而非完整文件 n-search --context-lines→ 相关匹配带上下文
CLI 使用
# 如果安装到 PATH（设置 → MCP 服务器 → 安装 CLI 到 PATH）
rp-cli -e '命令'
# 或使用别名（在 shell 中配置）
repoprompt_cli -e '命令'
命令参考
文件树
# 完整树
rp-cli -e 'tree'
# 仅文件夹
rp-cli -e 'tree --mode folders'
# 仅选定文件
rp-cli -e 'tree --mode selected'
代码结构（代码地图）- TOKEN 高效
# 特定路径的结构
rp-cli -e 'structure src/auth/'
# 选定文件的结构
rp-cli -e 'structure --scope selected'
# 限制结果
rp-cli -e 'structure src/ --max-results 10'
搜索
# 基本搜索
rp-cli -e 'search "模式"'
# 带上下文行
rp-cli -e 'search "错误" --context-lines 3'
# 按扩展名过滤
rp-cli -e 'search "TODO" --extensions .ts,.tsx'
# 限制结果
rp-cli -e 'search "函数" --max-results 20'
读取文件 - TOKEN 高效
# 完整文件
rp-cli -e 'read 路径/to/file.ts'
# 行范围（切片）
rp-cli -e 'read 路径/to/file.ts --start-line 50 --limit 30'
# 最后 N 行（尾部）
rp-cli -e 'read 路径/to/file.ts --start-line -20'
选择管理
# 添加文件到选择
rp-cli -e 'select add src/auth/'
# 设置选择（替换）
rp-cli -e 'select set src/api/ src/types/'
# 清除选择
rp-cli -e 'select clear'
# 查看当前选择
rp-cli -e 'select get'
工作空间上下文
# 获取完整上下文
rp-cli -e 'context'
# 特定包含
rp-cli -e 'context --include prompt,selection,tree'
链式命令
# 多个操作
rp-cli -e 'select set src/auth/ && structure --scope selected && context'
工作空间
# 列出工作空间
rp-cli -e 'workspace list'
# 列出标签页
rp-cli -e 'workspace tabs'
# 切换工作空间
rp-cli -e 'workspace switch "项目名称"'
AI 聊天（使用 RepoPrompt 的模型）
# 发送到聊天
rp-cli -e 'chat "认证系统如何工作？"'
# 计划模式
rp-cli -e 'chat "设计新功能" --mode plan'
上下文构建器（AI 驱动的文件选择）
# 自动选择相关文件用于任务
rp-cli -e 'builder "实现用户认证"'
工作流程快捷标志
# 快速操作，无需 -e 语法
rp-cli --workspace 我的项目 --select-set src/ --export-context ~/out.md
rp-cli --chat "认证如何工作？"
rp-cli --builder "实现用户认证"
脚本文件 (.rp)
对于可重复的工作流程，将命令保存到脚本：
# daily-export.rp
workspace switch 前端
select set src/components/
context --all > ~/exports/frontend.md
运行方式：
rp-cli --exec-file ~/scripts/daily-export.rp
CLI 标志
| 标志 | 目的 |
|---|---|
-e 'cmd' |
执行命令 |
-w <id> |
目标窗口 ID |
-q |
静默模式 |
-d <cmd> |
命令的详细帮助 |
--wait-for-server 5 |
等待连接（脚本） |
异步操作 (tmux)
对于长时间运行的操作如 builder，使用异步脚本：
# 启动上下文构建器异步
uv run python -m runtime.harness scripts/repoprompt_async.py \
--action start --task "理解认证系统"
# 带工作空间切换
uv run python -m runtime.harness scripts/repoprompt_async.py \
--action start --workspace "我的项目" --task "探索 API 模式"
# 检查状态
uv run python -m runtime.harness scripts/repoprompt_async.py --action status
# 完成后获取结果
uv run python -m runtime.harness scripts/repoprompt_async.py --action result
# 如果需要终止
uv run python -m runtime.harness scripts/repoprompt_async.py --action kill
注意
需要 RepoPrompt 应用运行并启用 MCP 服务器。