功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

仓库归档搜索（免费版）

概述

仓库归档搜索免费版是一款面向个人开发者的代码仓库 issue/PR 查询工具。通过本地缓存归档数据，优先使用缓存查询而非实时拉取，减少 GitHub API 调用次数。支持按关键词搜索、查看相邻关联、检测数据新鲜度等核心功能，帮助开发者快速了解项目历史与当前状态。

核心能力

已知限制

执行已知限制操作,使用input_params参数进行配置,支持创建/查询/导出等操作。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

单次仅支持查询 1 个仓库

单次仅支持查询 1 个仓库

输出: 返回单次仅支持查询 1 个仓库的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

归档数据需手动更新同步

归档数据需手动更新同步

输出: 返回归档数据需手动更新同步的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

不支持重复 issue 聚类分

不支持重复 issue 聚类分析

输出: 返回不支持重复 issue 聚类分的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

不支持多仓库批量管理

不支持多仓库批量管理

输出: 返回不支持多仓库批量管理的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

不支持团队协作共享

不支持团队协作共享

输出: 返回不支持团队协作共享的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

输出: 返回已知限制的执行结果,包含操作状态和输出数据。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：轻量级代码仓库、归档搜索工具、支持本地缓存查询、与新鲜度检测、适合个人开发者日、常代码仓库管理、核心能力、本地缓存、GitHub、检测归档数据新鲜、提示更新需求、查看相邻、关联关系等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：查询项目历史 issue

开发者想了解某个开源项目的特定问题历史。

# 检查归档数据新鲜度
gitcrawl doctor --json

# 搜索包含特定关键词的 issue
gitcrawl search issues "memory leak" \
  -R owner/repo \
  --state all \
  --json number,title,url

预期输出包含所有匹配的 issue 编号、标题和链接，帮助快速定位相关讨论。

场景二：查看 PR 状态

贡献者想了解某个 PR 的当前状态和关联信息。

# 查看 PR 基本信息
gitcrawl gh pr status 123 \
  -R owner/repo \
  --compact

# 查看 PR 详细信息
gitcrawl gh pr view 123 \
  -R owner/repo \
  --json number,title,state,url,isDraft,headRef,headSha

场景三：了解 issue 关联讨论

开发者想查看某个 issue 周边的相关讨论。

# 查看相邻 issue
gitcrawl neighbors owner/repo \
  --number 456 \
  --limit 12 \
  --json

返回与指定 issue 相邻的 12 条讨论，帮助理解上下文。

不适用场景

以下场景仓库归档搜索不适合处理：

• 实时流数据处理
• 小规模数据手动分析
• 非结构化文本情感分析

触发条件

需要数据分析、报表生成、统计洞察、数据可视化时使用。不适用于非本工具能力范围的需求。

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

依赖详情

# 安装 gitcrawl
# 参考官方文档进行安装

# 初始化本地归档
gitcrawl init --storage $HOME/.gitcrawl/archive

# 验证安装
gitcrawl doctor --json

执行首次查询

# 搜索指定仓库的 open issue
gitcrawl search issues "bug report" \
  -R owner/repo \
  --state open \
  --json number,title,url

更新归档数据

# 手动同步最新数据
gitcrawl sync owner/repo

# 验证数据新鲜度
gitcrawl doctor --json

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

基础查询配置

# 搜索 open 状态的 issue
gitcrawl search issues "feature request" \
  -R owner/repo \
  --state open

# 搜索包含 closed 状态的 issue
gitcrawl search issues "fixed" \
  -R owner/repo \
  --include-closed

# 查看指定 issue 详情
gitcrawl threads owner/repo \
  --numbers 123,456 \
  --include-closed \
  --json

参数说明

优选实践

查询流程优化

1. 先查缓存：优先使用 gitcrawl 本地查询
2. 检测新鲜度：使用 gitcrawl doctor 确认数据时效
3. 必要时实时：仅在需要最新数据时使用 --live 参数
4. 验证后再操作：关闭/合并前用 gh 实时验证

# 推荐的查询流程
gitcrawl doctor --json                          # 1. 检查新鲜度
gitcrawl search issues "query" -R owner/repo    # 2. 缓存搜索
gitcrawl gh pr view 123 -R owner/repo --compact # 3. 查看详情
gh pr view 123 --json                           # 4. 实时验证（操作前）

搜索关键词优化

数据新鲜度管理

# 定期检查数据新鲜度
gitcrawl doctor --json | python -m json.tool

# 数据过期时手动更新
gitcrawl sync owner/repo

# 查看最后同步时间
gitcrawl status owner/repo

常见问题

归档数据过期

# 检查新鲜度
gitcrawl doctor --json

# 更新归档
gitcrawl sync owner/repo

# 验证更新
gitcrawl doctor --json

搜索无结果

# 检查仓库地址是否正确
gitcrawl list-repos

# 尝试更宽泛的关键词
gitcrawl search issues "bug" -R owner/repo --state all

# 包含已关闭的 issue
gitcrawl search issues "keyword" -R owner/repo --include-closed

实时查询失败

# 检查 GitHub 认证
gh auth status

# 重新认证
gh auth login

# 使用缓存模式（非实时）
gitcrawl search issues "query" -R owner/repo

查询速度慢

# 使用缓存优先模式
gitcrawl search issues "query" -R owner/repo --cached

# 减少 JSON 输出字段
gitcrawl search issues "query" -R owner/repo --json number,title

# 限制返回数量
gitcrawl search issues "query" -R owner/repo --limit 5

依赖说明

运行环境

• Agent 平台：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统：Windows / macOS / Linux
• 网络环境：需可访问 GitHub（实时查询时）
• 存储空间：至少 500MB 用于归档缓存

第三方依赖

API Key 配置

• 本地缓存查询无需 API Key
• 实时查询需配置 GitHub Token：

# 配置 GitHub CLI 认证
gh auth login

# 或使用环境变量
export GITHUB_TOKEN=your_token_here

可用性分类

• 分类：MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力）
• 说明：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 执行任务
• 适用人群：个人开发者、开源贡献者、技术调研人员
• 升级建议：如需多仓库管理、重复聚类、实时同步等高级功能，请使用 PRO 版本

错误处理

安全注意事项

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

效率量化分析

差异化对比

核心功能

• 自动化执行: 基于指令驱动的自动化流程
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据