# @gallopsystems/agent-skills 中文文档

规范地址：https://npmcn.com/package/%40gallopsystems/agent-skills/

版本：1\.32\.0
npm 元数据更新时间：2026-10-28T20:30:28.462Z
中文译文更新时间：2026-11-15T21:48:25.931Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gallopsystems/agent-skills
原文对照：https://npmcn.com/package/%40gallopsystems/agent-skills/?lang=original
项目主页：https://github.com/gallop-systems/agent-skills#readme
源码仓库：https://github.com/gallop-systems/agent-skills

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：776 kB，131 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=16
- 运行依赖：0 个
- 首次发布：2026-06-03T15:25:52.679Z
- 最新版本发布：2026-10-28T20:30:27.600Z
- 近 30 天下载量：3279（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 39 个）

## 中文简介

Gallop系统代理技能,在安装时与.claude/技能(Claude Code)和.agents/技能(Codex)相接.

## 安装

```sh
npm install @gallopsystems/agent-skills
```

也可以使用：`pnpm add @gallopsystems/agent-skills`、`yarn add @gallopsystems/agent-skills`、`bun add @gallopsystems/agent-skills`

## README

# 克劳德技能

克劳德密码技术集.

## 安装

第一,增加市场:

```
/plugin marketplace add gallop-systems/agent-skills
```

然后安装您想要的技能 :

```
/plugin install kysely-postgres@gallop-systems-agent-skills
/plugin install nuxt-nitro-api@gallop-systems-agent-skills
/plugin install nitro-testing@gallop-systems-agent-skills
/plugin install linear@gallop-systems-agent-skills
/plugin install doctl@gallop-systems-agent-skills
/plugin install git-github@gallop-systems-agent-skills
/plugin install copier-template@gallop-systems-agent-skills
/plugin install vue-nuxt@gallop-systems-agent-skills
/plugin install frontend-design@gallop-systems-agent-skills
/plugin install gallop-ui@gallop-systems-agent-skills
/plugin install generate-documentation@gallop-systems-agent-skills
```

## 更新

更新最新版本的特定技能 :

```
/plugin update kysely-postgres@gallop-systems-agent-skills
```

**自动更新 :** 第三方市场不自动更新 默认。 使:

1.  运行 `/plugin` 选择 **市场**
2.  选择 `gallop-systems-agent-skills`
3.  选择 **启用自动更新**

## 安装为 npm 依赖( 每repo)

对于JS/TS Repos来说,你可以通过你的锁文件将技能固定在一个版本上,而不是 市场。 将软件包添加为 dev 依赖 :

```
yarn add -D @gallopsystems/agent-skills
```

安装时, a `postinstall` 脚本将软件包的内容链接到 claude Code和Codex项目:

-   **技能** ——每个目录中包含一个 `SKILL.md` → `.claude/skills/<name>` (简体中文) **财务报告和审定财务报表** `.agents/skills/<name>` (科德克斯语). 这个 `SKILL.md` 格式为 两个代理都一样,所以每个技能目录都是逐字相连的. 所有船只 作为一种技能:在目前的克洛德法典中,一种技能既可被斜取(`/<name>`和 型号可以使用,所以 `contribute-skill`比如说,给你 `/contribute-skill` _财务报告和审定财务报表_ 相关时自动出价——不需要单独的指令.
-   **命令** ——每个 `.md` 任意下的文件 `commands/` 目录 ∗ `.claude/commands/<name>.md` (仅Claude; Codex 没有项目命令目录). 固定状态 给遗产/只给荣誉的命令,这个包裹今天没有.

更新只是一个版本的凸起 :

```
yarn up @gallopsystems/agent-skills
```

这些链接是生成的文物(它们指向 `node_modules` 并且现在 每次安装时都重新创建,所以忽略其中 `.gitignore`数字 :

```
.claude/skills
.claude/commands
.agents/skills
```

注释:

-   剧本从不拍出真实的 `.claude/skills/<name>`, (中文(简体) ), `.agents/skills/<name>`, (中文(简体) ), 或者说 `.claude/commands/<name>` ,只删除它创建的同义链接. 运行 `yarn unlink-skills` 删除所有已管理的链接.
-   与Yarn(Classic, 或Berry)合作 `nodeLinker: node-modules`(中文(简体) ) 和npm. (英语). **小时** (v10+) 块依赖默认构建脚本——添加 软件包到 `pnpm.onlyBuiltDependencies` 联 合 国 `postinstall` 运行.
-   Yarn Berry 默认 **密码** 不支持链接( 无) `node_modules` 要链接的文件夹; 使用 `nodeLinker: node-modules`。 。 。 .

## 现有技能

### 邮递员

PostgreSQL 的 Type- safe Kysely 查询模式. 在与Kysely合作的Node.js/TypeScript项目中自动激活.

封面:

-   查询模式(SELECT、JOIN、在哪里、汇总)
-   移徙和建议的列类型
-   JSON/JSONB和阵列处理
-   字符串连接
-   避免的常见陷阱

### nuxt- nitro- api 键

Nuxt 4 / Nitro API模式,用于构建型号安全全层应用. 在 Nuxt 4 工程中工作时自动激活 .

封面:

-   以 h3( 标准Schema 支持) 进行 Zod 验证
-   使用 Fach 对 $fatch 对 使用 AsyncData
-   类型推论( 不要添加手动类型 !)
-   nuxt- auth- utils (OAuth, WebAuthn, 中间软件)
-   编译器对 utils
-   SSR + 局部积分图案
-   深链接( URL 参数同步)
-   Nitro 任务和任务队列
-   服务器事件( SSE)
-   第三方服务一体化

### 硝化试验

测试 Nitro API 处理器, 使用交易回滚隔离使用真实的 PostgreSQL 。 每一次测试都是在一次交易中进行,自动卷回进行完全隔离,而不进行高额清理.

封面:

-   交易回滚模式(快速、孤立、真实的SQL)
-   维特自定义固定装置`factories`, (中文(简体) ), `db`(中文(简体) )
-   模拟事件助手( M)`mockGet`, (中文(简体) ), `mockPost`, (中文(简体) ), `mockPatch`, (中文(简体) ), `mockDelete`(中文(简体) )
-   制造测试数据的工厂模式
-   Nuxt 自动进口全球根
-   同步/自动化测试设施
-   使用 GitHub 动作和 PostgreSQL 设置的 CI/CD

### 线性

创建,分解,管理 Linear 问题遵循团队惯例,为 Linear MCP 服务器不曝光的操作使用 GraphQL CLI .

封面:

-   问题创建和分类公约
-   技术仓库标签
-   A 类 `linear.mjs` 图QL 操作的 CLI

### 医生

以 doctl CLI 管理 DigitalOcean 资源.

封面:

-   Auth 上下文( 每个命令) `--context` 超状态切换)
-   解析当前 git repo 到其 DO 上下文 + app
-   App平台:部署、定界投票、记录及其保留
-   App specs: env var/ 秘密回转, 验证, 创建应用
-   `--format` 编号 : `-o json` 来了
-   管理的数据库、空间密钥、液滴、 DNS

### 基图

Git和GitHub(gh CLI)工作流程用于代理.

封面:

-   基本规则和分支 + 承诺 + 公关循环
-   读取 PR 和 CI 状态(`gh pr view --json`, (中文(简体) ), `gh pr checks`(中文(简体) )
-   调试失败的 GitHub 动作运行( 完整播放本)
-   修理梯子:被拒的推力、再基后浮出水面、浅层克隆、工作树
-   `gh api` 食谱: PR 注释, 不检查出文件读取, repo 设置, PAT 得到chas
-   发行:标签,npm 信任出版,发行-请
-   带有代码CLI的外部审查循环

### 复印机模板

维护一个复制项目模板并传播更新以生成再投放.

封面:

-   模板解剖学:复印机. yml,有条件的文件,任务,jinja在CI工作流程中逃脱
-   测试模板更改( E)`--vcs-ref HEAD`,生成和验证)
-   发布版本(tag + GitHub Release)及更新检查工作流程模式
-   应用 `copier update` 在后代中:冲突分类, `.rej` 文件, 验证

### 骑行

Gallop 共享的 Nuxt UI 层 `layers/gallop-ui` 以树枝为主. 激活任何还款 `layers/gallop-ui`。 。 。 .

封面:

-   在应用程序中使用层:自动进口, `pt`, (中文(简体) ), `class`, (中文(简体) ), `gallopUi` 内 `app.config`,合并顺序,符号和暗模式, `/_ui`
-   在复合材料之前找到正确的组件(准确、接近或没有匹配),提出组件
-   API 原理和 API 更改的栏目( 所有人呼叫、 模拟、 代码)
-   拉出一个释放: `yarn ui:pull`, (中文(简体) ), `ui:migrate`, (中文(简体) ), `ui:tokens`, (中文(简体) ), `ui:check`,合并-承诺子树 PR
-   更改图层, 检查每个应用程序 `ui:impact` 和截图扫描, 和工作规则学到了艰难的方法

### 生成文档

以应用程序的真实截图写出客户端-显示指南,作为PDF,HTML页面,电子邮件草稿或WhatsApp消息. 运行它 `/generate-documentation <format> <what to document>`。 。 。 .

封面:

-   两种模式: **回复** (把客户的问题变成"你已经可以做到这一点","我们改变了它","这里是固定的")和 **发布** (把合并的工作变成一个"你现在可以..." )
-   在写入代码和运行中的应用程序前检查每个答案
-   屏幕截图来自该应用软件的虚构演示数据副本, 仅来自真实数据
-   `bin/shots.mjs` Playwright 帮助器(签名入场,仍然抓取,突出显示环,区域和元素镜头)和 `bin/render.mjs` (HTML改为PDF,外加用于审查分页的接触表)
-   指南模板、非技术阅读器的写作规则和每格式规则

## 提供反馈课程

每个技能都以 **向后贡献** 区域:当克洛德通过 技术没有涵盖的东西, 它提供贡献的教训上游。 这个 `contribute-skill` 技能(运行) `/contribute-skill` 克洛德密码,或让其中之一代理 当相关时引用它 自动流出: 提炼一般的教训, 私密扫地 克隆或叉出这回波 打开公关 对抗正确的技能 文档。 来自叉子的PR是受欢迎的——内容必须是通用的(只有占位符,不) 特定项目的名称、ID或域).

## 添加新技能

1.  创建新插件目录 : `plugins/my-skill/`
2.  添加 `plugins/my-skill/.claude-plugin/plugin.json`数字 :
    
    ```json
    {
      "name": "my-skill",
      "description": "Short description",
      "version": "1.0.0",
      "author": { "name": "yeedle" }
    }
    ```
    
3.  添加 `plugins/my-skill/skills/my-skill/SKILL.md` 前题 :
    
    ```yaml
    ---
    name: my-skill
    description: When to use this skill...
    ---
    
    # Skill content here
    ```
    
4.  附加任何引用文件 `SKILL.md`
5.  注册插件于 `.claude-plugin/marketplace.json`
6.  提交和推

## 常见问题

### @gallopsystems/agent-skills 是什么？

Gallop系统代理技能,在安装时与\.claude/技能\(Claude Code\)和\.agents/技能\(Codex\)相接\.

### 如何安装 @gallopsystems/agent-skills？

在项目目录运行 npm install @gallopsystems/agent-skills，或使用 pnpm add / yarn add / bun add。

### @gallopsystems/agent-skills 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/gallopsystems\_\_agent-skills 是否存在。

### @gallopsystems/agent-skills 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=16。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @gallopsystems/agent-skills 可以商用吗？

@gallopsystems/agent-skills 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @gallopsystems/agent-skills 的下载量有多少？

根据 npm 官方下载统计，@gallopsystems/agent-skills 在 2026/10/16 – 2026/11/14 这 30 天内被下载 3,279 次，日均约 109 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gallopsystems/agent-skills 还在维护吗？

最新版本 1\.32\.0 发布于 2026/10/29（18 天前）；至今共发布 39 个版本，其中过去 12 个月发布了 39 个；首次发布于 2026/06/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。