commit b5a4a8ffa9d65b5ea9140520ef71e816e0c1f08f Author: wehub-skill-sync Date: Mon Jul 13 21:36:12 2026 +0800 chore: import zh skill skills-cli diff --git a/README.wehub.md b/README.wehub.md new file mode 100644 index 0000000..05714eb --- /dev/null +++ b/README.wehub.md @@ -0,0 +1,9 @@ +# WeHub 来源说明 + +- Skill 名称：`skills-cli` +- 中文类目：skill 生命周期 CLI 管理 +- 上游仓库：`xixu-me__skills` +- 上游路径：`skills/skills-cli/SKILL.md` +- 上游链接：https://github.com/xixu-me/skills/blob/HEAD/skills/skills-cli/SKILL.md +- 本仓库为 WeHub 中文 Skill 汉化包，基于 skill 市场筛选 Top200 清单整理 +- 原作者、版权和许可证信息以上游仓库为准 diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..3b0ebd4 --- /dev/null +++ b/SKILL.md @@ -0,0 +1,280 @@ +--- +name: skills-cli +description: 当用户询问如何发现、安装、列出、检查、更新、移除、备份、恢复、同步或初始化 Agent Skills，提及 `bunx skills`、`npx skills`、`skills.sh` 或 `skills-lock.json`，询问"找一个做 X 的 skill"，或希望借助可安装技能扩展 Agent 能力时，使用本技能。 +--- + +使用本技能帮助用户通过 `skills` CLI 使用开放的 Agent Skills 生态系统。 + +## 概述 + +`skills` CLI 是可安装 Agent Skills 的包管理器。它用于发现技能、以正确的标志安装它们，以及管理已安装的技能。 + +以下示例使用 `bunx skills`，但如果用户环境中没有 Bun，`npx skills` 也是同样的工作流程。 + +始终优先使用当前的 CLI 语法： + +```bash +bunx skills add --skill +``` + +不要使用较旧的 `owner/repo@skill-name` 示例。 + +## 使用时机 + +当用户有以下行为时，使用本技能： + +- 询问"找一个做 X 的 skill"、"有没有做 X 的 skill"或"如何做 X"，且 X 听起来像是一个可复用的工作流 +- 询问"你能做 X 吗"，且 X 听起来像是一种可能已存在对应技能的专门能力 +- 希望获得有关 `bunx skills`、`npx skills`、`skills.sh`、技能包安装或 `skills-lock.json` 的帮助 +- 希望为特定 Agent（如 Codex 或 OpenCode）安装技能 +- 希望列出、检查、更新、移除、恢复、同步、备份或初始化已安装的技能 +- 希望获得搜索工作流、工具、模板或领域特定能力（如设计、测试、部署、文档或代码审查）的帮助 + +当用户已有本地技能并希望编写或改进其内容时，不要使用本技能。此时应使用技能创作工作流。 + +## 发现工作流 + +当用户需要某个技能时，按照以下顺序进行： + +1. 确定领域和任务。 + 示例：React 性能、PR 审查、变更日志生成、PDF 提取。 + 同时判断该任务是否足够常见，很可能已有可复用的技能存在。 +2. 首先查看 [skills.sh](https://skills.sh/)。 + 如果该领域已有覆盖，优先选择知名度高、安装量大的技能。 +3. 如果排行榜无法明确满足需求，使用以下命令搜索： + +```bash +bunx skills find +``` + +1. 在推荐任何内容之前先验证质量： + - 安装量：优先选择安装量在 1K+ 的技能，对低于 100 的技能要谨慎 + - 来源信誉：优先选择官方或成熟维护者，如 `openai`、`anthropics`、`microsoft` 或类似的可信发布者 + - 仓库质量：检查源代码仓库，对 stars 数少于 100 的仓库中的技能保持怀疑态度 +2. 清晰呈现选项。 + 包括技能名称、它做什么、安装量和来源、为何看起来可信、安装命令，以及前往 `skills.sh` 了解更多信息的链接。 +3. 如果用户希望继续，提供安装帮助。 +4. 如果没有找到合适的技能，直接说明，利用你的通用能力帮助用户完成任务，并提及用户可以使用 `bunx skills init` 创建自己的包。 + +## 安装快速参考 + +### 常见来源 + +```bash +# GitHub 简写 +bunx skills add xixu-me/skills + +# 完整 GitHub URL +bunx skills add https://github.com/xixu-me/skills + +# 仓库内某个技能的直接路径 +bunx skills add https://github.com/xixu-me/skills/tree/main/skills/skills-cli + +# GitLab URL +bunx skills add https://gitlab.com/org/repo + +# 任意 git URL +bunx skills add git@github.com:owner/repo.git + +# 本地包路径 +bunx skills add ./my-local-skills +``` + +### 常见安装模式 + +```bash +# 列出包中的技能但不安装 +bunx skills add --list + +# 安装一个技能 +bunx skills add --skill skills-cli + +# 安装多个技能 +bunx skills add --skill pr-review --skill commit + +# 全局安装 +bunx skills add --skill skills-cli -g -y + +# 安装到指定 Agent +bunx skills add --skill skills-cli -a codex -y + +# 将所有技能安装到所有 Agent +bunx skills add --all + +# 将所有技能安装到一个 Agent +bunx skills add --skill '*' -a codex -y + +# 复制文件而非符号链接 +bunx skills add --skill skills-cli -a codex --copy -y +``` + +### 安装方式 + +当用户选择安装方式时： + +- 符号链接是默认方式，通常是最佳选择，因为更新保持集中管理 +- `--copy` 创建独立副本，当符号链接不受支持或不方便时作为备选方案 + +如果用户只要求安装技能，优先使用默认的符号链接工作流，除非用户提到 CI 打包、可移植性、文件系统限制或明确要求使用副本。 + +### 重要标志 + +| 标志 | 用途 | +| --------------------- | ---------------------------------------------- | +| `--skill ` | 安装一个或多个指定名称的技能 | +| `-a, --agent ` | 针对特定 Agent，例如 `codex` | +| `-g, --global` | 安装在用户作用域而非项目作用域 | +| `-y, --yes` | 跳过提示 | +| `--list` | 列出包中可用的技能 | +| `--copy` | 复制而非符号链接 | +| `--all` | 将所有技能安装到所有 Agent 的简写 | + +## 管理已安装的技能 + +使用以下命令进行日常维护： + +```bash +# 列出已安装的技能 +bunx skills ls +bunx skills ls -g +bunx skills ls -a codex +bunx skills ls --json + +# 检查更新 +bunx skills check + +# 更新已安装的技能 +bunx skills update + +# 移除已安装的技能 +bunx skills remove my-skill +bunx skills remove my-skill -a codex +bunx skills remove -g my-skill +bunx skills remove --all + +# 初始化一个新的技能包 +bunx skills init +bunx skills init my-skill + +# 从 skills-lock.json 恢复 +bunx skills experimental_install + +# 将 node_modules 中的技能同步到 Agent 目录 +bunx skills experimental_sync +bunx skills experimental_sync -a codex -y +``` + +当用户要求初始化技能时，说明他们想要哪种方式： + +- `bunx skills init` 在当前目录下创建 `SKILL.md` +- `bunx skills init ` 创建一个包含 `SKILL.md` 的新子目录 + +## 相关工具：Skills Vault + +如果用户希望跨机器或团队进行声明式的已安装技能备份和恢复，请使用 [Skills Vault](https://github.com/xixu-me/skills-vault)。 + +Skills Vault 是 `skills` 生态系统中一个独立的 CLI 配套工具。它不是一个可通过 `skills add` 安装的技能来源。当用户希望将已安装的技能快照到清单文件中、预览恢复命令或在不同环境中复现相同设置时，使用该工具。 + +常用配套命令： + +```bash +# 将已安装的技能备份到 skvlt.yaml +bunx skvlt backup + +# 预览恢复 +bunx skvlt restore --dry-run + +# 从清单文件恢复所有内容 +bunx skvlt restore --all + +# 诊断本地环境 +bunx skvlt doctor +``` + +当用户明确需要可移植的清单工作流、跨机器备份和恢复或团队共享已安装技能设置时，优先使用此工具而非 `skills experimental_*` 命令。 + +## 推荐格式 + +在推荐技能时，确保内容具体且可安装。 + +使用如下结构： + +```text +我找到了一个可能适合的技能。 + +技能： +匹配理由：<一句话> +来源： +质量检查：<安装量 / 来源信誉 / 仓库可信度说明> +安装： +bunx skills add --skill [可选标志] +了解更多：https://skills.sh/// + +如果你愿意，我可以为 安装它。 +``` + +如果用户提到了目标 Agent 或作用域，将其包含在命令中。示例： + +```bash +bunx skills add --skill -a codex -y +bunx skills add --skill -g -y +``` + +示例： + +```text +我找到了一个可能有帮助的技能。 + +技能：screenshot +匹配理由：它专注于操作系统级别的桌面和窗口截图捕获。 +来源：openai/skills +质量检查：安装量高、发布者可信、源代码仓库被广泛使用。 +安装： +bunx skills add openai/skills --skill screenshot +了解更多：https://skills.sh/openai/skills/screenshot +``` + +## 常见技能类别 + +当用户的描述比较模糊时，可以映射到以下常见类别： + +| 类别 | 示例查询 | +| --------------- | -------------------------------------------------- | +| Web 开发 | `react`、`nextjs`、`typescript`、`css`、`tailwind` | +| 测试 | `testing`、`jest`、`playwright`、`e2e` | +| DevOps | `deploy`、`docker`、`kubernetes`、`ci-cd` | +| 文档 | `docs`、`readme`、`changelog`、`api-docs` | +| 代码质量 | `review`、`lint`、`refactor`、`best-practices` | +| 设计 | `ui`、`ux`、`design-system`、`accessibility` | +| 效率 | `workflow`、`automation`、`git` | + +## 搜索技巧 + +- 使用具体的关键词。`react testing` 比仅用 `testing` 更好。 +- 尝试替代术语。如果 `deploy` 搜不到，试试 `deployment` 或 `ci-cd`。 +- 先查看热门来源。许多优秀技能来自成熟发布者。 +- 如果首次搜索范围太广，通过领域加任务进行缩小。 + +## 常见错误 + +- 推荐搜索结果中的技能前，未检查其是否看起来足够成熟。 +- 用户指定了特定 Agent 时，忘记指定 `-a `。 +- 将 `bunx skills find --help` 当作真正的帮助命令使用。应使用 `bunx skills --help` 获取命令帮助。 +- 仅用一个弱搜索词就断定没有对应的技能。应首先尝试更具体或更接近的查询。 + +## 故障排除 + +如果用户遇到错误或令人困惑的结果： + +- "未找到技能"——建议更好的查询、查看 [skills.sh](https://skills.sh/)，或直接提供帮助并提及 `bunx skills init` +- 自动化或 CI 中出现交互式提示——添加 `-y` +- 安装作用域错误——在项目安装和 `-g` 之间切换 +- 符号链接问题——使用 `--copy` 重试 +- 不确定包中的可用内容——运行 `bunx skills add --list` +- 不确定已安装状态——运行 `bunx skills ls` 或 `bunx skills ls --json` +- 跨机器可移植备份或恢复——推荐 [Skills Vault](https://github.com/xixu-me/skills-vault) 及其 `backup` / `restore --dry-run` 工作流 + +当你不确定具体标志时，使用： + +```bash +bunx skills --help