ARTICLE · 1226508
opensrc技能,文档没写就看源码
opensrc技能,文档没写就看源码
AI 解释第三方库的边界行为时,可能看错版本。GitHub 仓库 vercel-labs/opensrc 提供同名 CLI 与 Agent Skill:Skill 教编码助手在文档和类型定义不足时去读实现;CLI 解析版本、获取并缓存源码,返回路径;搜索、阅读和判断仍靠 Agent 原有工具。它不自动修 bug。
官方 CLI 前提是 Node.js 18+ 与 Git,安装命令为 npm install -g opensrc;Skill 另按 skills.sh 所列 npx skills add https://github.com/vercel-labs/opensrc --skill opensrc 安装。下面是官方 Bash/Zsh 与 Unix 工具例子,还需 rg、cat、find。PowerShell 也有 $(),但整组 find -name 与路径处理不能照搬。
在项目目录先取路径,再搜实现和测试:
opensrc path zod
rg "parse" $(opensrc path zod)
cat $(opensrc path zod)/src/types.ts
find $(opensrc path zod) -name "*.test.ts"
opensrc path 首次取源,之后返回缓存绝对路径;进度写标准错误,路径写标准输出。路径可能含空格,实际操作可先存入变量并加引号,再交给 rg 或 cat;没有 rg 可用宿主已有的搜索和文件阅读工具。src/types.ts 是官方示例路径,先核当前版本是否存在。上述代码不是本文跑出的结果。
对 npm 包,CLI 从当前项目的 package-lock.json、pnpm-lock.yaml 或 yarn.lock 推断版本;不在项目目录可用 opensrc path zod --cwd /path/to/project,想固定版本可用 opensrc path zod@3.22.0。PyPI、crates.io 包可指定版本或使用 latest;GitHub 仓库可固定 ref。源码读完,还得核实际调用路径和相关测试,不能凭一次字符串命中下结论。本篇未安装或运行 opensrc。















































































