2026/8/14 12:42:37

npx skills 实战:3 步把命令手册存成离线帮助文档

npx skills 实战:3 步把命令手册存成离线帮助文档 npx skills 实战3 步把命令手册存成离线帮助文档【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills坐高铁穿隧道、出差刚接上内网的那一刻你突然想确认npx skills add的-s到底选技能还是选代理官网却怎么也打不开。这篇实战教程教你 3 步把命令帮助导出成本地离线帮助文档之后哪怕完全没网查看命令帮助也只需一条grep。一句话说清价值把命令帮助存成本地文件断网时随手就能翻。一步步生成 Markdown 帮助文件全程只需要终端不用装任何额外工具。前提是这台机器已经装过 skillsnpm install -g skills或让npx缓存过因为离线帮助文档的内容来自本机已安装的 CLI这也是它离线可用的原因。第一步先看帮助的原貌# 顶层帮助包含命令概览、各子命令选项和示例-h 与 --help 完全等价 npx skills --help输出按区块列出add、use、remove、list、find等命令每个区块下有各自的参数例如Add Options里的--copy、--all结尾还有一批可直接套用的示例。第二步过滤颜色码再落盘成文件帮助文本里带着终端颜色码直接重定向会把它们一并写进文件Markdown 里显示成乱码# perl 清掉 ANSI 转义码后写入当前目录的 skills-help.md npx skills --help | perl -pe s/\e\[[0-9;]*m//g skills-help.md第三步子命令细节单独存档多数子命令加--help会短路到顶层帮助唯独remove有独立帮助页别漏掉# remove 的专属帮助页同样过滤颜色码后另存一份 npx skills remove --help | perl -pe s/\e\[[0-9;]*m//g skills-remove.md深挖两个决定体验的细节细节一过滤颜色码不是可选项。下面两种写法生成的文件截然不同——前一个混着\e[38;5;145m之类的转义序列在编辑器里是花屏后一个才是干净可读的文档。npx skills --help skills-help-raw.md # 不推荐带颜色码 npx skills --help | perl -pe s/\e\[[0-9;]*m//g skills-help.md # 推荐细节二--help的短路行为帮你省文件。npx skills add --help、npx skills update --help都只打印顶层帮助不会真的去执行add、update流程只有remove --help走专属页。所以顶层一份 remove 一份就能覆盖全部命令说明。断网时怎么查看命令帮助两种方式怎么选场景做法适合有网络、只查一次直接跑npx skills --help临时确认断网、反复翻查用导出的skills-help.md配合grep、less出差、内网环境离线翻阅时最常用的是定位参数一行命令直达答案# 只看某个参数的解释-A 2 表示顺带显示后面两行 grep -A 2 -- --copy skills-help.md新手最容易踩的 3 个坑忘了清颜色码直接重定向出来的文件在 Markdown 里是花的务必保留perl -pe s/\e\[[0-9;]*m//g这道工序。把help当成命令npx skills help会报Unknown command: help正确入口永远是--help或-h。把文档当永久资料帮助文件是当前版本的快照升级 skills 后旧文件会过期重跑一遍生成命令并顺手用npx skills --version把版本号写进文件名例如skills-help-1.5.22.md。现在就去终端跑第一行npx skills --help这份随身命令手册用不了一分钟就能做好 ⚡【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考