核心用法
Greptile是一个AI驱动的代码库智能平台，本Skill提供对其REST API的封装脚本，支持四大核心操作：
1. 代码库索引 (index) — 将GitHub/GitLab仓库导入Greptile进行分析，默认主分支，支持--no-reload避免重复索引
2. 索引状态检查 (status) — 查看索引进度（completed/processing/failed）及文件处理数量
3. AI智能查询 (query) — 基于索引进行自然语言问答，返回AI生成答案+精确源码引用（文件、行号），--genius模式提供更深度的架构分析
4. 语义搜索 (search) — 仅返回相关代码片段和位置，无AI解释，适合快速定位
显著优点
- 精准溯源：所有AI回答均附带具体文件路径和行号，可验证、可追溯
- 双模式适配：普通查询快速响应，
--genius模式深度分析复杂架构问题 - 多平台支持：原生支持GitHub和GitLab（通过
--remote切换） - CLI友好：输出可直链
jq处理，便于脚本化集成
潜在局限
- 依赖外部服务：完全依赖Greptile云服务可用性，无离线能力
- 令牌门槛高：需同时配置
GREPTILE_TOKEN和GITHUB_TOKEN（或GitLab等效令牌），设置复杂 - 索引前置成本：首次使用必须先完成索引，大型仓库耗时较长
- 多库查询受限：包装脚本不支持多仓库联合查询，需直接调API
- 成本不透明：Greptile服务可能存在调用费用，文档未明确说明
适合人群
- 需要快速理解陌生代码库的开发者
- 进行代码审查（PR Review）的Tech Lead或高级工程师
- 维护多仓库系统的平台工程师
- 需要生成架构文档或 onboarding 指南的团队
常规风险
- 令牌泄露风险：双令牌配置增加了密钥管理复杂度，建议配合密钥管理工具使用
- 数据外泄：代码内容需上传至Greptile云端索引，涉及敏感代码需谨慎评估合规性
- AI幻觉：尽管有源码引用，AI总结仍可能存在理解偏差，关键决策需人工复核
- 服务依赖：索引状态和查询结果完全依赖第三方服务SLA