资讯动态

ai-agent-skills install 命令实战:全局/项目安装、依赖解析与 dry-run 预览全掌握

发布时间:2026/10/13 21:02:06 来源:尧图企业网站定制
AI 技能开发工具人工智能【免费下载链接】ai-agent-skillsUniversal skill installer and package manager for AI coding agents. One command, 12 runtimes. npx ai-agent-skills项目地址https://gitcode.com/gh_mirrors/ai/ai-agent-skills点击查看免费下载ai-agent-skills是面向 AI 编码代理的通用技能安装器和包管理器一条命令即可把技能装到 12 种代理运行时。本文带你实战install命令从全局/项目两种安装范围到依赖自动解析再到--dry-run安全预览一次讲透。一、install 命令能做什么install是整个 CLI 的核心命令它可以从四类来源安装技能来源示例命令内置库技能名npx ai-agent-skills install frontend-designGitHub 仓库owner/reponpx ai-agent-skills install anthropics/skills本地目录npx ai-agent-skills install ./my-skills精选合集collectionnpx ai-agent-skills install --collection swift-agent-skills安装动作只有一步把技能文件夹复制到目标目录并写入.skill-meta.json元数据记录来源、安装方式、范围方便后续sync刷新和check检查更新。命令入口实现在 cli.js 中。二、30 秒上手安装第一个技能不需要 clone 仓库npx直接拉起 CLInpx ai-agent-skills install pdf执行后你会看到类似这样的计划输出Resolved表示最终解析出的技能数Installing pdf Targets: ~/.claude/skills/ Requested: 1 skill Resolved: 1 skill ✓ pdf 不传任何范围参数时默认装到全局目录~/.claude/skills/所有项目都能用到。三、全局 vs 项目安装范围参数详解这是新手最容易混淆的地方一张表看懂路径定义见 lib/paths.cjs参数范围目标目录适用场景-g, --global全局~/.claude/skills/个人通用技能跨项目生效-p, --project项目.agents/skills/当前目录下团队共享随仓库提交--all两者都装全局 项目既想自用又想进仓库--agent name指定代理如.cursor/skills/兼容旧版代理路径几个典型用法# 装到项目提交后队友 clone 仓库即可用 npx ai-agent-skills install pdf -p # 全局 项目各装一份 npx ai-agent-skills install frontend-design --all # 兼容 Cursor 等旧代理 npx ai-agent-skills install frontend-design --agent cursor 判断口诀自己想用的装全局团队共建的装项目。四、四种来源类型与精选技巧1️⃣ 从仓库装单个技能——用技能名或--skill参数npx ai-agent-skills install anthropics/skillsfrontend-design npx ai-agent-skills install openai/skills --skill linear2️⃣ 装整个仓库——不带技能名时安装仓库内发现的技能npx ai-agent-skills install anthropics/skills3️⃣ 先浏览再安装——--list只列出、不改任何文件是零风险操作npx ai-agent-skills install openai/skills --list4️⃣ 一键装精选合集——合集是官方策划好的技能包npx ai-agent-skills install --collection swift-agent-skills -p目前可用的合集包括my-picks、build-apps、build-systems、test-and-debug、docs-and-research、mktg等用npx ai-agent-skills collections可随时查看。五、依赖解析装 1 个为什么变成装 3 个这是install命令最聪明的部分。每个技能在 skills.json 中可以用requires字段声明依赖比如技能 A 依赖技能 B那么install A会自动把 B 也装上而且顺序正确。背后的机制构建依赖图buildDependencyGraph 把所有技能及其requires关系建成有向图同时检测循环依赖、未知依赖、自依赖三类错误计算安装顺序resolveInstallOrder 用拓扑排序保证被依赖者先装生成安装计划getCatalogInstallOrder 在进入安装流程前解析出完整技能列表dry-run 输出中会直接展示依赖链一目了然Requested: 1 skill Resolved: 3 skills Dependency order: base-toolkit - pdf - doc-handling⚠️ 如果你只想要指定的技能本身加--no-deps跳过依赖展开npx ai-agent-skills install pdf --no-deps六、--dry-run 预览不装先看清--dry-run别名-n是安心之选完整跑一遍解析流程打印安装计划但不修改任何文件。它特别适合三种场景依赖太多想确认Resolved: N skills里到底都包含什么装到项目前先看看会不会把不想进仓库的东西也带上排查问题官方错误提示也建议重试时先加--dry-run或--list检查来源# 预览全局安装计划 npx ai-agent-skills install anthropics/skills --dry-run # 预览装到项目的计划 npx ai-agent-skills install --collection mktg -p --dry-run输出会标注每个技能来自内置 house copy离线可用还是live upstream从源仓库实时拉取远程仓库还会提示Clone mode: sparse checkout稀疏检出只拉需要的文件速度更快。七、进阶参数速查参数作用适用场景--yes跳过交互确认CI/CD 流水线、自动化脚本--dry-run, -n只预览不安装安装前检查--no-deps跳过依赖展开只要技能本体--list列出来源中的技能安装前浏览--format json机器可读输出脚本与代理调用CI 场景组合拳npx ai-agent-skills install pdf -p --yes八、装完之后配套维护命令install不是孤立的配合这些命令形成完整生命周期详见 README.md Commands 章节npx ai-agent-skills check # 检查已安装技能是否有更新 npx ai-agent-skills sync pdf -p # 刷新某个已安装技能 npx ai-agent-skills uninstall pdf # 卸载 npx ai-agent-skills doctor # 诊断安装问题 npx ai-agent-skills validate [path] # 校验技能目录遇到安装失败时优先doctor看诊断结果涉及上游仓库拉取失败可以按错误提示先用--dry-run或--list定位问题来源。小结需求记住这一条个人自用install name默认全局团队共享install name -p安装前先看加--dry-run或--list控制依赖加--no-deps自动化加--yes --format json掌握install命令的范围参数、来源类型、依赖解析和 dry-run 预览这四块基本就打通了ai-agent-skills的日常使用。核心实现参考cli.js、lib/dependency-graph.cjs、lib/paths.cjs。赞分享AI 技能开发工具人工智能【免费下载链接】ai-agent-skillsUniversal skill installer and package manager for AI coding agents. One command, 12 runtimes. npx ai-agent-skills项目地址https://gitcode.com/gh_mirrors/ai/ai-agent-skills点击查看免费下载相关推荐Git 中的 Dry Run安全预览命令执行效果的实战指南Git 中的 Dry Run安全预览命令执行效果的实战指南 导读 git clean 、 git commit 等命令都支持 dry run 干跑模式G文档教程知识库OpenHarnessoh入门指南安装、Provider 配置、Dry-run 安全预览与 ohmo 个人 Agent 实战OpenHarness oh 入门指南安装、Provider 配置、Dry run 安全预览与 ohmo 个人 Agent 实战 OpenHarness人工智能AI AgentAgent 框架代码智能体工具调用MCP 服务Agent 记忆多智能体bun install 命令详解用 tldr 指南掌握 Bun 的依赖安装全流程bun install 命令详解用 tldr 指南掌握 Bun 的依赖安装全流程 本篇指南以 pages.bn/common/bun install.md h文档教程知识库创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑