核心用法
Greptile Skill 是一款面向开发者的 AI 代码库智能查询工具，通过封装 Greptile REST API 提供四大核心能力：
1. 仓库索引管理：将 GitHub/GitLab 仓库提交至 Greptile 进行向量化处理，支持指定分支与强制重载控制
2. 索引状态监控：实时追踪索引进度（completed/processing/failed）、文件处理数量等元数据
3. 智能代码问答（query）：基于 AI 生成自然语言答案并附带精确的源代码引用（文件路径+行号），--genius 模式针对架构设计与 PR Review 场景提供更深度分析
4. 语义代码搜索（search）：返回相关性排序的代码片段、函数定义位置，无 AI 生成环节，响应更快
显著优点
- 精确溯源：所有回答均附带可跳转的源代码引用，避免 LLM 幻觉导致的错误引用
- Git 原生集成：直接对接 GitHub/GitLab 仓库，无需本地克隆即可分析大型代码库
- 双模式适配：
query适合理解逻辑，search适合快速定位，配合--genius覆盖从日常开发到 Code Review 的全场景 - 轻量封装：基于 curl + jq 的 Shell 脚本实现，依赖极简，易于审计与二次开发
潜在局限
- 外部服务依赖：核心功能完全依赖 Greptile 云端 API，存在网络延迟、服务可用性及数据隐私顾虑（代码需上传至第三方索引）
- Token 配置门槛：需同时持有 GREPTILE_TOKEN 与 GitHub/GitLab PAT，配置链路较长
- 无多仓库联合查询：Wrapper 脚本未封装多 repo 查询能力，复杂跨仓库分析需直接调用 API
- 索引时效性：仓库更新后需手动触发重索引，非实时同步
适合人群
- 需要快速理解陌生代码库的开发者/技术负责人
- 执行大规模 PR Review 或架构审计的工程师
- 技术写作人员（需提取真实代码示例与引用）
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | 代码库内容需上传至 Greptile 服务器索引，敏感项目需评估合规性 |
| Token 泄露 | GREPTILE_TOKEN 与 GitHub PAT 需妥善保管，避免硬编码或日志泄露 |
| API 依赖性 | 服务中断或定价变更将直接影响可用性，建议保留本地 fallback 方案 |