用途
RepoPrompt Skill 用于以更省 token 的方式探索代码库。它通过 RepoPrompt 提供的命令行接口,让开发者或 AI 代理能够查看目录结构、提取代码签名、执行带上下文的搜索、读取文件片段,并围绕具体任务构建上下文,而不必一次性读取完整文件。
主要能力
- 文件树:查看完整树、仅文件夹或仅选中文件,命令如
rp-cli -e 'tree'、rp-cli -e 'tree --mode folders'、rp-cli -e 'tree --mode selected'。 - 代码结构(Codemaps):获取指定路径或选中文件的结构,可限制返回数量,例如
rp-cli -e 'structure src/auth/'、rp-cli -e 'structure --scope selected'、rp-cli -e 'structure src/ --max-results 10'。 - 搜索:支持基本搜索、带上下文行、按扩展名过滤和限制结果,如
rp-cli -e 'search "error" --context-lines 3'、rp-cli -e 'search "TODO" --extensions .ts,.tsx'、rp-cli -e 'search "function" --max-results 20'。 - 读取文件(省 token):支持读取完整文件、按行范围读取切片以及读取末尾若干行,如
rp-cli -e 'read path/to/file.ts --start-line 50 --limit 30'、rp-cli -e 'read path/to/file.ts --start-line -20'。 - 选区管理:可添加、替换、清空和查看当前选中文件,如
select add、select set、select clear、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 "ProjectName"'。 - AI 聊天:使用 RepoPrompt 的模型进行对话,并支持 plan 模式,如
rp-cli -e 'chat "How does the auth system work?"'、rp-cli -e 'chat "Design a new feature" --mode plan'。 - 上下文构建器:根据任务自动选择相关文件,如
rp-cli -e 'builder "implement user authentication"'。
使用方式
若已将 CLI 安装到 PATH(Settings → MCP Server → Install CLI to PATH),可直接使用 rp-cli -e 'command';也可使用别名 repoprompt_cli -e 'command'(需在 shell 中配置)。
还提供工作流简写标志,无需 -e 语法,例如:
rp-cli --workspace MyProject --select-set src/ --export-context ~/out.md
rp-cli --chat "How does auth work?"
rp-cli --builder "implement user authentication"
对于可重复的工作流,可将命令保存为 .rp 脚本文件,例如:
# daily-export.rp
workspace switch Frontend
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 等待连接(用于脚本)。
对于 builder 等长时间运行的操作,可使用异步脚本(tmux),例如:
uv run python -m runtime.harness scripts/repoprompt_async.py \
--action start --task "understand the auth system"
支持 --action start(可配合 --workspace)、--action status、--action result、--action kill。
适用场景
- 探索不熟悉的代码库结构。
- 在限制 token 的前提下获取代码签名而非完整内容。
- 为特定任务(如实现用户认证)自动收集相关文件和上下文。
- 需要带上下文行的代码检索或读取文件特定行范围。
- 通过脚本将日常导出或工作区切换流程自动化。
限制与注意事项
使用前需要 RepoPrompt 应用正在运行,并已启用 MCP Server。部分功能(如 AI 聊天)依赖 RepoPrompt 的模型。关于定价、平台支持范围、性能效果等资料暂未提供。