SuperAPI AI 工具集

research-software

写作与研究

查看项目

更新于 10-15 17:29

技能介绍

research-software 是一个软件调研技能,用途是围绕指定工具做系统化资料收集与整理,输出可直接用于编写技能(skill)的 Markdown。资料强调:以最新 STABLE tag 为准(不是 main),内容过滤到 2025-2026,代码优先于文档,跳过 Stack Overflow。

主要能力:输出统一结构,含版本号与日期、仓库与 commit、命令表、配置表、环境变量、坑点(问题与修复及来源)、来源列表(代码 file:line、PR 编号、文章 URL)。来源优先级依次为源码、近期 PR、GitHub issue、2025-2026 博客、官方文档(常过时)。

使用方式:先检测项目上下文(package.json、Cargo.toml、pyproject.toml 中的现有版本);再克隆仓库到 /tmp 并检出最新稳定 tag: git clone --depth 1 https://github.com/[org]/[repo] /tmp/[repo]-research cd /tmp/[repo]-research && git fetch --tags && git checkout $(git describe --tags --abbrev=0) 随后并行启动 Explore 子代理分析源码(CLI、配置、隐藏标志、环境变量),查询 GitHub 合并 PR 与 issue: gh pr list -R [org]/[repo] --state merged --limit 30 --json title,mergedAt gh issue list -R [org]/[repo] --label question --limit 20 并进行 2025/2026 网络搜索;最后综合成上述结构,并清理:rm -rf /tmp/[repo]-research。

关键检索可用 ripgrep 查找隐藏或实验性标志与各语言环境变量,如 rg "hidden|experimental|unstable"、rg "process.env."、rg "std::env::"、rg "os.environ"、rg "os.Getenv",以及 git log --oneline --since="2025-06-01"。

适用场景按对象分:CLI 工具侧重 src/cli/、命令、标志、环境变量;库/框架侧重 packages/*/src/、导出 API、弃用项;运行时侧重内置能力、运行时标志、兼容层;数据库/服务侧重查询语法、配置、限制与坑点。

限制与要求:需能访问网络、GitHub CLI 与本地克隆;研究对象须有可检出仓库与稳定 tag。资料未说明计费、价格、平台支持或具体效果。参考资料还提及 STRATEGIES.md、OUTPUT-TEMPLATES.md、EXAMPLES.md 等文件,但未提供其内容。