# @event4u/agent-config 中文文档

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

版本：20\.4\.0
npm 元数据更新时间：2026-11-12T15:50:24.032Z
中文译文更新时间：2026-11-14T01:07:35.070Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40event4u/agent-config
原文对照：https://npmcn.com/package/%40event4u/agent-config/?lang=original
项目主页：https://event4u-app.github.io/agent-config
源码仓库：https://github.com/event4u-app/agent-config

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

- 包体积（解压后）：73.1 MB，4386 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.6\.0
- 运行依赖：17 个
- 首次发布：2026-04-23T13:04:37.446Z
- 最新版本发布：2026-11-12T15:50:23.513Z
- 近 30 天下载量：5777（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：212（近 12 个月 212 个）

## 中文简介

技能,规则,斜线命令和克洛德码,克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克克勒斯克勒斯克勒斯克勒斯克勒斯克.

## 安装

```sh
npm install @event4u/agent-config
```

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

## README

[![event4u Agent Config](https://npmcn.com/package/%40event4u/agent-config/.github/assets/info-banner.png)](https://event4u-app.github.io/agent-config/)

安装到您的用户级 AI 工具配置中; 您的仓库只获得一个 `agents/overrides/` 用于修改的文件夹。 用20个AI编码工具工作.

# Agent Cifig——教你的AI编码员在他们说完成之前检查他们的工作

[![npm](https://img.shields.io/npm/v/@event4u/agent-config?style=flat-square&label=npm&color=orange)](https://www.npmjs.com/package/@event4u/agent-config) [![downloads](https://img.shields.io/npm/dm/@event4u/agent-config?style=flat-square&label=downloads%2Fmonth&color=orange)](https://www.npmjs.com/package/@event4u/agent-config) [![Smoke](https://github.com/event4u-app/agent-config/actions/workflows/smoke.yml/badge.svg)](https://github.com/event4u-app/agent-config/actions/workflows/smoke.yml) [![Public install smoke (3 OS × 2 Node)](https://github.com/event4u-app/agent-config/actions/workflows/smoke-public-install.yml/badge.svg)](https://github.com/event4u-app/agent-config/actions/workflows/smoke-public-install.yml) [![agent-config MCP server](https://glama.ai/mcp/servers/event4u-app/agent-config/badges/score.svg)](https://glama.ai/mcp/servers/event4u-app/agent-config) [![MCP Toplist](https://mcptoplist.com/badge/io.github.event4u-app%2Fagent-config.svg)](https://mcptoplist.com/server/io.github.event4u-app%2Fagent-config)

[![Skills](https://img.shields.io/badge/Skills-303-orange?style=flat-square)](https://github.com/event4u-app/agent-config/tree/main/dist/agent-src/skills) [![Rules](https://img.shields.io/badge/Rules-122-orange?style=flat-square)](https://github.com/event4u-app/agent-config/tree/main/dist/agent-src/rules) [![Commands](https://img.shields.io/badge/Commands-214-orange?style=flat-square)](https://github.com/event4u-app/agent-config/tree/main/dist/agent-src/commands) [![Guidelines](https://img.shields.io/badge/Guidelines-121-orange?style=flat-square)](https://github.com/event4u-app/agent-config/tree/main/docs/guidelines) [![Personas](https://img.shields.io/badge/Personas-29-orange?style=flat-square)](https://github.com/event4u-app/agent-config/tree/main/dist/agent-src/personas) [![Advisors](https://img.shields.io/badge/Advisors-5-orange?style=flat-square)](https://github.com/event4u-app/agent-config/tree/main/dist/agent-src/personas/advisors)

**安装一次。 您的 AI 编码工具被告知在他们说完成前进行计划,测试和核实;在 Claude 代码上,可以停止一个转弯,不检查文件即可更改文件.**

```bash
npx -y @event4u/agent-config init
```

免费和麻省理工的执照。 在macOS,Linux或WSL2上的节点22.6或更新. 花费更多的代币:7.8×一跑,没有安装克洛德·海库的规则,2.9×只有核心规则. [付出的代价](https://npmcn.com/package/%40event4u/agent-config/#readme-what-it-costs)

在桌面上打开浏览器向导: 选择您的角色和工具, 请单击 Finish 。 在你做之前,没有东西是写的.

## 30秒内试试看

还没准备好安装什么? 将一个只读的检查器放入您的 repo 并询问您的分支是否真的完成 :

```bash
mkdir -p .claude/agents
curl -fsSL https://raw.githubusercontent.com/event4u-app/agent-config/main/docs/wedge/production-validator/production-validator.md \
  -o .claude/agents/production-validator.md
# then in Claude Code:  @production-validator check this branch is actually done
```

`production-validator` 读到那条航道上会载运,狩猎的代码 嘲弄和占位者,并要求证明它运行。 它改变不了什么. [它检查什么](https://github.com/event4u-app/agent-config/blob/main/docs/wedge/production-validator/README.md)

## 什么变化

**从前.** 您要求您的代理商添加 CSV 导出 。 它写着一个处理器 返回硬码占位符,现有测试保持绿色并回复 "提出——出口实施". 从来没有运行过新的代码.

**过后.** 在克劳德代码中,你问 `@production-validator` 分支是否为 痷 它读到的代码将运送, 找到占位符和 答题 **还没准备好** 准确的文件和行。 在一个真正 写完答案 **准备** 和报告什么。 我们在两起案子上测试过: 一个有占位符,一个完成.

在克洛德代码上,包还可以拒绝让一个回合结束 当"done" 代理更改了文件, 没有运行检查它们 。 在所有其他工具上 要求代理人遵循的指示,而不是一个街区.

### 你的经纪人要做什么

| 默认行为 | 有代理配置 |
| --- | --- |
| 盲目猜测和编辑 | 更改前分析代码 |
| 项目公约的漂移 | 遵循检测到的堆栈常规 |
| 跳过或发明测试 | 在项目框架内进行写作测试 |
| 一般承诺消息 | 具有范围+票价链接的常规承诺 |
| 跳过质量检查 | 运行项目的质量管道并纠正所报告的错误 |
| 无上下文打开 PR | Jira / Linear / GitHub 结构化的 PR 描述 |
| 没有证据的“done”索赔 | 在索赔完成之前用实际执行进行核查 |

它改变了经纪人被告知要做的事,而不是模型有多聪明. 2026年11月在一次计分器修复后被重新测量,全安装对克洛德·海库的纪律增益并不显著,克洛德·索内特也没有表现出任何增益;只有小核心规则集对海库保持了显著增益. 我们发表这样的结果,而不是隐藏它们. [整个故事](https://event4u-app.github.io/agent-config/getting-started/introduction/)

## 如何融为一体

![How Agent Config fits together: slash commands such as /review:changes, /project:map, /cost:report and /roadmap:create feed one core with rules, memory, skills, a second opinion from other AI models (Council), tests and evidence; it produces five outcomes — code review, security audit, code map, cost report and roadmaps — and installs with npx -y @event4u/agent-config init](https://npmcn.com/package/%40event4u/agent-config/.github/assets/info-image.png)

一个安装会给代理您已经使用一套技能,代理规则和斜线命令. 每项任务都必须遵守规则;当任务需要时,越小的规则越大. [看见每个斜线命令](https://event4u-app.github.io/agent-config/workflows/commands/)

## 付出的代价

-   **更多纪念品.** Claude Haiku在两个范围纪律任务上,作为发运的安装费用为7.8×无规则的运行;核心规则本身(内核+ `downstream-changes`费用为2.9×. 这个 `discipline_profile` 设置尚不改变克劳德安装的负载.
-   **只能挡住克洛德密码 只能挡住它的钩子.** 主机设置可以将其关闭,用户安装的mod可以解除拒绝; `agent-config doctor neighbours` 列表已安装的模型。 在其他地方,规则是指示:它们削减违反,但不会消除.
-   **腾讯网.** 默认情况下,除了每天对照 npm 注册进行更新检查和通过您自己的程序向 GitHub 提出日常问题外, 您的机器没有留下任何东西 `gh` 登录, 无论您提出的拉动请求是否合并了 。 更新检查在CI中关闭,没有终端或与 `AGENT_CONFIG_NO_UPDATE_CHECK=1`遥测关闭了 第二投注功能在设置之前是关闭的;然后它用自己的API密钥将工作发送给了其他的AI提供者,而API密钥会向您计费. [你的机器还剩下什么](https://event4u-app.github.io/agent-config/trust/network/)
-   **诀竟.** 节点22.6或更新. 每个工具的常备费用: [图表](https://npmcn.com/package/%40event4u/agent-config/docs/contracts/rule-router.md)。 。 。 .
-   **汝出家道来.** `agent-config uninstall --global` 仅删除它自己的条目, 并保持其它工具的配置未受影响 .

[基准和费用,已解释](https://event4u-app.github.io/agent-config/trust/benchmark-and-cost/)

## 看这变化

`agent-config code-graph map --open` 绘制您的寄存器的本地地图: 谁调用什么,哪个测试覆盖它,数据,接口和发送. 选一个文件,每个区域都照亮 它运行离线并保持 `file:line` 对于每一个事实.

![The code map on a sample project: areas as bubbles; selecting a file lights up every area it reaches; the blast-radius panel counts its direct and transitive dependents](https://npmcn.com/package/%40event4u/agent-config/docs/media/code-map/demo-graph-blast.webp)

[**打开演示地图 {}**](https://event4u-app.github.io/agent-config/demo-map/) (样本项目,不是你的代码) [密码地图 +](https://event4u-app.github.io/agent-config/features/code-map/)

## 选择您的简介

向导要您的角色, 并为它安装一个焦点集, 而不是整个目录 。 他们大多不是工程角色.

| 简介 | 对于 | 开始于 |
| --- | --- | --- |
| `developer` (默认) | 运输密码的工程师 | `/work`, (中文(简体) ), `/implement-ticket`, (中文(简体) ), `/review:changes`, (中文(简体) ), `/commit` |
| `founder` | 独奏和早期创始人 | `/work`, (中文(简体) ), `/feature`, (中文(简体) ), `/challenge-me`;视觉、优先顺序和跑道技能 |
| `content_creator` | 作家、幽灵作家、推销员 | `/work`, (中文(简体) ), `/ghostwriter`, (中文(简体) ), `/post-as`电影AI的视频故事板 |
| `agency` | 为几个客户提供的商店 | `/work`, (中文(简体) ), `/implement-ticket`, (中文(简体) ), `/refine-ticket`, (中文(简体) ), `/roadmap` |
| `finance` | 首席财务干事,分层财务,FP&A | `/work`, (中文(简体) ), `/challenge-me`;预测技能和单位经济学 |
| `ops` | RevOps, 支持, SRE相邻的工作 | `/work`, (中文(简体) ), `/threat-model`, (中文(简体) ), `/review:changes`;事件和伐木技能 |

[选择配置文件](https://event4u-app.github.io/agent-config/getting-started/choose-a-profile/)

## 工作流量

你开始一个作品,而不是命令列表. 这些调查涉及大部分日子:

| 命令 | 对你有什么好处 |
| --- | --- |
| `/work "<what you want>"` | 通过精细化、规划、执行、测试和核实以及报告,提出自由形式的要求;它从未为您作出承诺. |
| `/implement-ticket <ticket>` | 一张票的相同回路:它首先完善了票面,并在某事模棱两可时停下来询问. |
| `/review:changes` | 在公关前与焦点审查员(bug, security, tests, 质地, 架构, spec, 过度构建)审查本地 diff 并合并其判决. |
| `/commit` | 显示拆分后, 将您的更改阶段化, 并将其作为逻辑的常规任务 . |
| `agent-config doctor` | 检查安装并报告磁盘上缺少或更改的任何信息,并有下一个命令来修复它. |

当请求不明确时, 代理用编号选项而不是猜测来停止和询问 . [实施变革 ∗∗](https://event4u-app.github.io/agent-config/workflows/implement/)

## 在您的项目中使用

开始于 [快速启动](https://npmcn.com/package/%40event4u/agent-config/#readme-quickstart) 下;全行行入地. [安装 −](https://event4u-app.github.io/agent-config/getting-started/installation/)

## 证明一下

这个README中每个测量出的数字都带有一个标记,它指向一个记录的,可重用的证据. 当人们停止解决时,建筑失败了。 证明页列出每个索赔及其证据,包括包没有改变的跑道,加上你自己在新的检查中运行的命令. [你自己去核实一下](https://event4u-app.github.io/agent-config/proof/)

![A real run of the proof page: every "verify it yourself" command passing](https://npmcn.com/package/%40event4u/agent-config/docs/media/proof-demo.gif)

## 贡献

技能、规则和命令在下面是简单的Markdown `src/`; 一个命令重建每个工具的复制并运行检查. [发展](https://npmcn.com/package/%40event4u/agent-config/#readme-development) 有循环. [贡献指南](https://github.com/event4u-app/agent-config/blob/main/CONTRIBUTING.md)

## 快速启动

```bash
npx -y @event4u/agent-config init                              # browser wizard on a desktop
npx -y @event4u/agent-config init --tools=claude-code,cursor    # no wizard: CI, scripts, servers
```

`init` 找到您安装的 AI 工具, 并为您选择 。 在CI中,没有终端或与 `--yes` 或者说 `--tools=<ids>` 它在没有向导的情况下安装;两个路径运行相同的安装器. `install` 是同一个巫师在另一个名字下.

**安装器默认 :** 用户全球. `agent-config init` 安装到您的家目录中 — 软件包下方 `~/.event4u/agent-config/` 和每个 AI 工具的用户级文件夹, 如 `~/.claude/` 或者说 `~/.cursor/` - 并且没有写任何技能、规则或命令 您的仓库, 它只得到一个 `agents/overrides/` 属于您的文件夹 更改外加一些已忽略的簿记文件和每个块 `.gitignore` 财务报告和审定财务报表 `.gitattributes`· ; `agent-config init --project` 创建公正 那些在仓库里,没有别的.

然后,在你的AI工具中:

```text
/work "your first real task"
```

| 再见 | 命令 |
| --- | --- |
| 改变角色、配置或工具 | `agent-config setup` |
| 打开设置屏幕 | `agent-config config` |
| 更新最新发布 | `agent-config upgrade` |
| 检查安装 | `agent-config doctor` |
| 拿开 | `agent-config uninstall --global` (单位:千美元)`--purge` 也删除它记录的写入的文件 ) |

[你的第一项任务](https://event4u-app.github.io/agent-config/getting-started/first-task/)

## 它是什么,它不是吗

Agent Config是一套技能,代理规则,斜线命令和准则,它会被写入每个AI工具自己的格式. 技能使用打开的代理技能 `SKILL.md` 格式,带有一些特定软件包的前题键.

这不是一个特工。 您的 AI 代理仍然运行该回路, 调用 LLM 并使用它自己的工具; 软件包会改变该代理被告知要做的事 。 它不会把你锁在模特儿或小贩身上.

## 里面的东西

**上面的徽章上的计数怎么算** - 一个柜台, `update_counts --check`,从树上重新划出所有6个,当一个关闭一个时,会失败. **命令 214** 计数每个命令文件,包括子文件夹中的文件;所有213个都列在命令部分 [目录页面](https://event4u-app.github.io/agent-config/catalog/)。 。 。 . **规则122** 计算源规则,而链接文件夹持有121,因为一条规则被关闭而未被运出. **人 数 29** 将目录删除。 这些都是档案的计数:它们都没有衡量质量或收养.

你没有得到所有的时间。 在没有方法隐藏技能的工具上,新安装的舰只为您的角色选择了更小的一套;克洛德代码和Codex获得所有技能,并根据需要展示. [浏览目录](https://event4u-app.github.io/agent-config/catalog/)

## 自定义

-   **规则级别.** `--profile minimal | balanced | full` 安装时设置规则级别:每个任务上加载多少规则。 它与上述角色简介不同; `balanced` 是默认,并且 `full` 代价最高的象征.
-   **你自己的变化.** 放进去 `agents/overrides/` ,而不是编辑已安装的文件.
-   **设置.** `agent-config config` 通过搜索和重置打开设置屏幕.
-   **技能为角色设定.** 为另一个域添加一组技能而不切换配置.

[设置文件 ~](https://event4u-app.github.io/agent-config/configuration/overview/)

## 支持的工具

`init` 检测出23个AI编码工具,并与其中20个一起工作. 工具的获得取决于其等级:

-   **18个工具** 将自己的格式写入用户级文件夹。 下面的表格中列出了每一条规则、技能和命令。 只有克洛德代码可以阻止转弯;其他规则则是指令.
-   **代码 CLI** 是其中之一,但只读技能.
-   **GitHub 副驾驶** 获得一个发现插件:指向安装的只读的MCP服务器.
-   **克劳德桌面** 获得技能 ZIP 在设置下上传给自己 – 自定义 – 技能 .
-   **援助、Zed和JetBrains公司** 只导出:您将导出的文件添加到其配置中.

| 工具 | 规则 | 技能 | 图标 | 如何运作 |
| --- | --- | --- | --- | --- |
| **克劳德代码** | ✅ | ✅ | ✅ | 读取 `.claude/` |
| **光标** | ✅ | —— 说 | ☑️ | 读取 `.cursor/rules/` + 通过 AGENTS.md 命令 |
| **线** | ✅ | —— 说 | ☑️ | 读取 `.clinerules/` + 通过 AGENTS.md 命令 |
| **风起浪起** | ✅ | —— 说 | ☑️ | 读取 `.windsurfrules` + 通过 AGENTS.md 命令 |
| **双子座CLI** | ✅ | —— 说 | ☑️ | 读取 `GEMINI.md` |
| **GitHub 副驾驶** | ✅ | —— 说 | ☑️ | 发现插件( 只读 MCP 服务器, 无钩子); 项目规则通过 `agent-config export --tool=copilot-instructions` 输入 `.github/copilot-instructions.md` |
| **Roo 代码** | ✅ | —— 说 | ☑️ | 自动发现 `.roo/rules/*.md` + AGENTS.md (韩语) |
| **代码 CLI** | —— 说 | ✅ | —— 说 | 阅读技能从 `~/.codex/skills/`;规则和命令交付但未宣读,没有 `AGENTS.md` 已写入(您的工程本身) `AGENTS.md` 仍在读取) |
| **继续. dev** | ✅ | —— 说 | ☑️ | 自动发现 `.continue/rules/*.md` + AGENTS.md (韩语) |
| **助手** | 📌 | —— 说 | —— 说 | 只导出: 将文件添加到 `read:` 内 `.aider.conf.yml` |
| **增加额** (甚高频/IntelliJ) | 📌 | —— 说 | —— 说 | 全局; 项目写标记 |
| **克劳德桌面** | —— 说 | 📦 | 📦 | 技能 ZIP( 将命令捆绑为技能) , 您可以在设置下上传到您自己 – 自定义 – 技能 |

QQ 本地文本引用( 在 AGENTS. md 中, 不是本地 slash 命令) QQ 标记或导出只您自己上传的 ZIP —— 不可用

**插头.** 增强CLI也可以作为插件安装,带有规则,技能和命令. GitHub Copilot获得一个只被发现的插件:一个只读的MCP服务器和一个指向安装,没有钩子的技巧. 每个项目的副驾驶指令运行 `agent-config export --tool=copilot-instructions --output=.github/copilot-instructions.md`. Claude 代码市场插件被贬值,因为 npm 安装已包含内容和钩子; `agent-config doctor` 标记一个剩余插件.

**队伍.** 您安装的每一个工具都记录在 `agents/installed-tools.lock`; 新的团队成员运行 `npx @event4u/agent-config sync` 克隆后.

**云会会.** 克劳德代码云会(claude.ai/code, `claude --cloud`)开始于一款新鲜的克隆并看不到家用指令安装,因此它运行时没有代理配置技能,规则和钩子. 见 [云层会议](https://npmcn.com/package/%40event4u/agent-config/docs/setup/cloud-sessions.md)。 。 。 .

[哪个装置? →](https://event4u-app.github.io/agent-config/tools/overview/)

## 代理交换器

[`agent-switch`](https://github.com/event4u-app/agent-switch) 在一台机器上运行多个代理账户,每个账户在自己的配置图中。 两者作曲:代理-开关将账户分开,代理-配置塑造了代理在他们内部的所为. 其设置范围保留到活动配置 . [他们如何合作](https://event4u-app.github.io/agent-config/works-with-agent-switch/)

## 这是给谁的

任何人的AI编码代理 说"done"太早。 习惯——首先分析,检验,核实,承诺干净——在任何堆放中工作. 最深层的技能组合是Laravel和现代PHP(Pest, PHPStan, 校长, Elopoent, Livewire),然后是Symfony, Next.js和React. Cross-stack技能涵盖API设计,测试,安全,数据库,多克克,Git,CI,审查,威胁模型和即时工程.

这些技能来自TypeScript和PHP编码库的生产工作. 把其他堆叠的覆盖视为有希望,没有证明. 告诉我们它在哪里不足. [讨论情况 \*](https://github.com/event4u-app/agent-config/discussions)

## 法律和安全说明

> **法律包——不是法律咨询.** 欧盟/丹麦法律技能集(合同、《国家发展援助协定》和《和平协议》审查)只是研究和起草方面的援助。 它不能取代合格的律师,在具体事项上不得依赖它。 读取 [法律通知(LEGAL NOTIEC.md)](https://github.com/event4u-app/agent-config/blob/main/LEGAL_NOTICE.md) 在使用前使用.

安全报告: [警卫](https://github.com/event4u-app/agent-config/blob/main/SECURITY.md)。 。 。 . [安全特征 +](https://event4u-app.github.io/agent-config/features/security/)

## 文档

| 页次 | 你在那里找到的东西 |
| --- | --- |
| [安装](https://event4u-app.github.io/agent-config/getting-started/installation/) | 每个安装路径, 旗帜和被写在哪里 |
| [你的第一个任务](https://event4u-app.github.io/agent-config/getting-started/first-task/) | 从安装到完成更改 |
| [更新](https://event4u-app.github.io/agent-config/getting-started/update/) 财务报告和审定财务报表 [卸载](https://event4u-app.github.io/agent-config/getting-started/uninstall/) | 保持时空并离开干净 |
| [工作流量](https://event4u-app.github.io/agent-config/workflows/implement/) | 执行、审查、计划、承诺和开放一项公关 |
| [特征](https://event4u-app.github.io/agent-config/features/code-map/) | 代码映射、安全、成本、第二意见、内存 |
| [CLI 参考](https://event4u-app.github.io/agent-config/reference/cli/) | 每个 `agent-config` 命令 |
| [检查我们的报销](https://event4u-app.github.io/agent-config/trust/check-our-claims/) | 每个数字背后的证据 |

AI工具的机器可读索引 : [`llms.txt`](https://github.com/event4u-app/agent-config/blob/main/llms.txt)。 。 。 .

## 解决问题

开始 `agent-config doctor`: 它标记缺少的二进制 `PATH`,版本不匹配和剩余,每个版本都有一行固定. 如果规则或钩子没有起火, `agent-config routing:doctor` 正在检查的报告和原因。 升级问题, 如缺少命令或两次列出的技能 : [排除出问题](https://github.com/event4u-app/agent-config/blob/main/docs/troubleshooting.md#upgrade-and-staleness)。 。 。 .

## 发展

正在研究包裹本身? 编辑 `src/` 只重建所生的树木:

```bash
task sync             # regenerate dist/agent-src/ and .augment/
task generate-tools   # regenerate .claude/, .cursor/, .clinerules/, .windsurfrules
task ci               # full pipeline — green before PR
task test             # unit + integration tests
task dev:setup        # boot the onboarding wizard against the working tree
```

从源检出时,将 CLI 运行为 `./agent-config <command>`· ; `npx @event4u/agent-config` 不解决那里没有 `npm link`与 `npm run build:cli` 若为 `dist/cli/agent-config.js` 缺少。 整个堆栈为TypeScript.

[发展指南](https://github.com/event4u-app/agent-config/blob/main/docs/development.md) • 妇女 [质量和CI](https://github.com/event4u-app/agent-config/blob/main/docs/maintainers/quality.md) • 妇女 [捐款额](https://github.com/event4u-app/agent-config/blob/main/CONTRIBUTING.md) • 妇女 [变化](https://github.com/event4u-app/agent-config/blob/main/CHANGELOG.md) • 妇女 [中断更改](https://github.com/event4u-app/agent-config/blob/main/BREAKING_CHANGES.md)

## 所需资源

-   **节点22.6或更新.** `npx -y @event4u/agent-config init` 是安装路径;不需要其他路径.
-   **平台:** macOS 12.3+, Linux 和 WSL2. Git Bash 需要开发者模式来表示共鸣链接. 捐助者也需要 [任务](https://taskfile.dev/)。 。 。 .

**视窗.** 原生PowerShell和cmd不支持文件安装;使用WSL2. 没有WSL2,将任何MCP客户端指向内置的MCP服务器,以及技能,规则和命令都可以作为提示和资源:

```bash
npx -y @event4u/agent-config mcp-server
```

[所需经费](https://event4u-app.github.io/agent-config/getting-started/requirements/)

## 供资

该套装是免费的,麻省理工学院的,并保持这种方式——没有付费等级,没有双重许可. 如果这能节省你的时间,你想要芯片插入,则Repo上方的GitHub赞助按钮就是整个机制. 如果你不愿意,无论如何,使用它;这里没有任何东西.

## 许可证

[麻省理工学院](https://github.com/event4u-app/agent-config/blob/main/LICENSE)。 。 。 .

mcp-名称:io.github.event4u-app/代理配置

## 常见问题

### @event4u/agent-config 是什么？

技能,规则,斜线命令和克洛德码,克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克勒斯克克勒斯克勒斯克勒斯克勒斯克勒斯克\.

### 如何安装 @event4u/agent-config？

在项目目录运行 npm install @event4u/agent-config，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agent-config，可以用 npx agent-config 直接运行。

### @event4u/agent-config 支持 TypeScript 吗？

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

### @event4u/agent-config 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

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

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

### @event4u/agent-config 可以商用吗？

@event4u/agent-config 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @event4u/agent-config 的下载量有多少？

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

### @event4u/agent-config 还在维护吗？

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