名称: docs-ops 描述: “管理Gemini CLI文档生命周期。动作：抓取、验证、刷新、重建索引、清除缓存。” 参数提示: <动作> (抓取|验证|刷新|重建索引|清除缓存) [选项] 允许工具: 读取、写入、Bash、Glob、Grep
Gemini CLI 文档操作
通过一个统一的技能管理Gemini CLI文档的生命周期。
参数路由
| 动作 | 描述 |
|---|---|
scrape |
从geminicli.com llms.txt抓取文档，然后刷新和验证 |
validate |
验证索引完整性和检测漂移（只读） |
refresh |
从文件系统刷新索引，无需抓取 |
rebuild-index |
清除并立即重建搜索索引 |
clear-cache |
清除搜索缓存（在下次搜索时懒重建） |
解析$ARGUMENTS以确定动作。第一个令牌是动作关键字。剩余令牌作为选项传递给动作处理器。
动作: scrape
从配置的源（geminicli.com llms.txt）抓取所有文档。
步骤
- 使用并行处理运行抓取脚本：
python "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/scripts/core/scrape_all_sources.py" --parallel --skip-existing
- 抓取完成后，重建索引：
python "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/scripts/management/rebuild_index.py"
- 验证索引：
python "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/scripts/management/manage_index.py" verify
报告每个步骤的结果。
动作: validate
对文档索引运行验证检查，不进行任何修改。
步骤
- 运行索引验证：
python "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/scripts/management/manage_index.py" verify
- 运行完整验证并汇总：
python "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/scripts/validation/validate_index_vs_docs.py" --summary-only
- 报告文档计数：
python "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/scripts/management/manage_index.py" count
报告每个验证步骤的结果，突出发现的问题。
动作: refresh
刷新本地索引，无需从web重新抓取。当手动修改文档文件或需要重建索引时使用此动作。
步骤
- 从文件系统重建索引：
python "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/scripts/management/rebuild_index.py"
- 验证索引完整性：
python "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/scripts/management/manage_index.py" verify
- 报告文档计数：
python "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/scripts/management/manage_index.py" count
报告每个步骤的结果。
动作: rebuild-index
清除并立即重建gemini-cli-docs搜索索引。这比clear-cache + 等待下次搜索更快，因为它立即触发重建。
何时使用
- 手动编辑
index.yaml或文档文件后 - 当搜索结果似乎过时或不正确时
- 在
git pull文档更改后 - 当需要立即使用搜索时
与clear-cache的区别
| 动作 | 行为 | 搜索可用性 |
|---|---|---|
clear-cache |
仅清除缓存 | 在下次搜索时重建（懒） |
rebuild-index |
清除 + 重建 | 立即（急） |
选项
- 无选项: 显示计划并请求确认
- –force: 跳过确认并立即重建
指令
此动作清除Gemini CLI文档搜索缓存并立即重建索引。
检查当前状态
首先，检查当前缓存状态。报告缓存是否存在、是否有效以及最后构建时间。
请求确认
除非用户传递了--force，否则显示重建计划与当前缓存状态，并在继续前请求确认。解释重建需要几秒钟，并且在重建期间搜索将不可用。
清除和重建
一旦确认（或如果传递了--force）：
- 使用cache_manager.py --clear命令清除缓存
- 使用rebuild_index.py重建索引
- 使用manage_index.py verify验证重建成功
报告结果
报告新索引统计信息，包括文档计数和构建时间。确认搜索现在可用。
## 索引已重建
成功重建Gemini CLI文档搜索索引。
**新索引统计：**
- 文档: X
- 构建时间: Xms
**搜索现在可用。**
错误处理
- 插件未安装: 报告“未找到google-ecosystem插件。”
- 重建失败: 报告脚本错误
- 权限被拒绝: 报告并给出修复步骤
动作: clear-cache
清除gemini-cli-docs搜索缓存（倒排索引）。这迫使索引在下次文档搜索时重建。
何时使用
- 手动编辑
index.yaml或文档文件后 - 当搜索结果似乎过时或不正确时
- 在
git pull文档更改后 - 为释放磁盘空间
选项
- 无选项: 显示将清除的内容并请求确认
- –force: 跳过确认并立即清除
步骤 1: 解析选项
检查--force标志是否存在。
force_mode = "--force" in arguments (不区分大小写)
步骤 2: 定位缓存目录
gemini-cli-docs缓存位于：
${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/.cache/
或通过安装路径：
~/.claude/plugins/cache/<marketplace>/google-ecosystem/<version>/skills/gemini-cli-docs/.cache/
步骤 3: 检查缓存状态
列出缓存文件：
| 文件 | 用途 |
|---|---|
inverted_index.json |
搜索索引 |
cache_version.json |
基于哈希的有效性跟踪 |
如果缓存目录不存在或为空，报告：“缓存已清除。无事可做。”
步骤 4: 确认（除非 --force）
如果不是force_mode，呈现缓存清除计划：
## 缓存清除计划
**目标:** Gemini CLI文档搜索索引
| 文件 | 大小 |
|------|------|
| inverted_index.json | X.X MB |
| cache_version.json | 512 字节 |
**总计:** X.X MB
> **注意:** 搜索索引将在下次文档搜索时自动重建。
> 立即重建，请在清除后使用`rebuild-index`动作。
**继续?** 回复“是”继续，或使用`--force`跳过此确认。
步骤 5: 清除缓存
使用cache_manager.py脚本清除：
python "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/scripts/utils/cache_manager.py" --clear
或手动删除缓存文件：
rm -f "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/.cache/inverted_index.json"
rm -f "${CLAUDE_PLUGIN_ROOT}/skills/gemini-cli-docs/.cache/cache_version.json"
步骤 6: 报告成功
## 缓存已清除
成功清除Gemini CLI文档搜索缓存。
**清除内容:**
- inverted_index.json
- cache_version.json
**下一步:**
- 搜索索引将在下次搜索时自动重建
- 或使用`rebuild-index`动作立即重建
错误处理
- 缓存未找到: 报告“缓存已清除或插件未安装。”
- 权限被拒绝: 报告“权限被拒绝。尝试使用提升的权限运行。”
- 插件未安装: 报告“未找到google-ecosystem插件。”