全局项目检索
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装规范名 @user_287b0fec/global-project-index 的技能到你的 AI 助手中。
技能介绍
解决的核心问题
多项目并行开发时,手动遍历目录查找目标项目、定期更新项目索引、区分活动/已关闭项目状态等操作耗时且易出错。尤其在跨语言(中文/拼音/英文)、模糊语义的检索需求下,传统文件搜索难以快速定位,同时项目状态变更与索引更新脱节,导致信息滞后。
工作机制与关键步骤
- 自动索引生成与维护:首次使用时自动扫描 workspace 生成
project_index.json,后续通过 cron 每日 02:00 自动刷新,也可手动执行「刷新项目索引」或/项目 refresh。 - 五层检索架构:
- L1 主索引检索:基于 project_index.json 始终触发
- L2 会话历史上下文:自动嵌入 lcm_grep 数据
- L3 项目内文件搜索:实时扫描并嵌入
- L4 状态联动:通过 closed_tasks.json 同步任务状态,cron 关联项目标注 [CRON] 标签
- L5 批量管理:支持 /项目 list 等指令筛选活动/已关闭项目
- 多语言检索能力:支持中文、拼音全拼、首字母缩写、英文及模糊词,如输入「tq」可命中「天气仪表盘」,输入「experience」可匹配「经验累计模块」。
适用边界与注意事项
- 首次使用需等待索引自动生成,或手动触发刷新
- 项目目录需包含
README.md以便识别功能列表 - 已关闭项目需通过
/项目 list --status=terminated单独筛选 - 模糊匹配依赖
project_discovery.py脚本的版本一致性,低版本可能存在检索偏差
使用场景
- 在多个业务项目混存的工作区里,需要用“打开天气仪表盘”直接定位并打开项目目录。
- 当项目名记得不完整时,可用拼音首字母“tq”快速找到对应仪表盘项目。
- 盘点当前活跃项目时,执行 /项目 list --status=active 只列出未关闭项目。
- 需要跨项目查文件时,使用 /项目 search 关键词 定位某功能代码或文档。
适合人员
- 负责多个客户项目的交付工程师:需要在大量项目目录中快速打开指定系统或文档。
- 维护企业内部工具库的开发者:希望通过全局索引和状态标记区分在用与已停用项目。
- 负责项目盘点的运营人员:需要用列表筛选和跨项目搜索汇总项目位置与状态。
- 需要调整既有项目功能的产品经理:希望直接定位到目标模块并查看可调整项。