技能介绍

要解决什么问题

在本地开发里，Agent 常被问到「Node 装在哪」「这个项目用的 Spring 版本」「数据库连哪个端口」「Docker 镜像名是什么」之类的问题。若每次都靠猜或盲目跑 which、docker ps，既慢也容易答错。本技能约定：先查工作区里已经采集好的静态 JSON，只在索引里没有时再退回到 shell。

技能如何工作

触发条件覆盖四类信息：本机工具安装位置与版本、项目技术栈与依赖、数据库连接与端口、Docker 镜像与 Shell 别名。检索顺序是固定的：

系统级：路径、工具、Docker、别名 → 读 system.json
项目技术栈：先在 projects-index.json 里找项目映射，再读 projects/xxx.json
连接与配置：数据库等 → 读 configs.json
兜底：以上文件都没有对应项时，再执行 shell 命令

数据目录为 workspace/.staticInfo/。Gateway 启动时可通过 BOOT.md 触发自动采集（约 7 天过期）；需要立刻刷新时，可运行 collect.py 手动更新。

适用边界

答案质量取决于 JSON 是否已采集且未过期；新项目或未跑过采集的环境，仍会走 shell 兜底。技能不会替代你自行维护的项目文档，而是让 Agent 在同一套本地事实源上回答，减少与真实环境不一致的幻觉。

截图预览

使用场景

接手 unfamiliar 仓库时，向 Agent 询问该项目在 `projects-index` 里映射的框架与依赖版本，而不是让它猜 package 文件。
本地服务连不上数据库，需要 Agent 先读 `configs.json` 里的主机、端口与连接项，再决定是否执行网络类 shell。
换电脑或重装工具后，核对本机 Java、Node 等安装路径与版本是否已与 `system.json` 中的采集结果一致。
编写或调试 Docker 相关脚本时，让 Agent 从 `system.json` 读取本机登记的镜像名与 Shell 别名后再给建议。