1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | nx-generate-nrwl-nx-ai-agents-config |
| 作者/维护者 | Nrwl（Nx 构建系统的官方开发商） |
| 来源链接 | https://github.com/nrwl/nx-ai-agents-config/tree/main/skills/nx-generate |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars / Forks | 所属仓库 27 stars（数据来自 GitHub API；该数字属整个配置仓库，不代表本技能自身热度） |
| 最新版本 | 无独立版本号，该技能文件最近一次提交 2026-05-12 |
| 安装方式 | 官方一键命令 / 手动复制目录，见第 10 章 |
2. 功能介绍与亮点
nx-generate 教 Agent 在 Nx monorepo 里正确调用 nx generate 完成脚手架，而不是凭猜测新建文件。核心流程：先用 nx list 发现工作区内可用的生成器（本地自定义生成器优先于第三方插件生成器），再读生成器源码理解真实副作用（不能只信 schema），接着参照仓库里已有的同类产物确定命名与结构约定，用 --dry-run 校验落盘位置无误后才正式执行，最后跑 nx format --fix 与 lint/test/build/typecheck 验证产物可用。
亮点：① 明确区分“可构建库”与“不可构建库”两种场景并给出选择标准，避免 Agent 生成不必要的构建配置；② --directory 参数的常见误用有专门的正反例说明；③ 官方出品，与 Nx CLI 版本同步演进；④ 与同仓库的 nx-workspace（只读理解工作区结构）分工互补，一读一写。
3. 适用场景
所属分类：工程效率与代码质量——技能面向“按仓库既有约定生成新代码”这一开发环节。
适用于使用 Nx 管理的 monorepo：新增应用、库或功能模块时，用它替代 Agent 凭经验猜测目录结构与生成器参数的做法。受益人群是用 Claude Code、GitHub Copilot 等 Agent 做日常开发的 Nx 团队初中级工程师。
4. 跨 Agent 兼容性
- Claude Code：原生支持——官方仓库
skills/nx-generate/SKILL.md即标准 Agent Skills 格式，npx nx configure-ai-agents一键安装会生成对应技能目录 - Codex：不支持——官方一键安装脚本为 Codex 只生成 MCP server 与 CI 监控子代理配置（
.codex/config.toml），未包含该技能的 skills 目录，需使用者手动移植 - GitHub Copilot / OpenCode：原生支持——官方安装同样为二者各生成一份独立的
skills/nx-generate/SKILL.md - OpenClaw / Hermes Agent：未验证——官方材料未提及，技能本体为标准 SKILL.md 格式，理论上可手动复制使用
5. 推荐理由
它把“新建代码”从“Agent 凭经验猜结构”变成“调用 Nx 自身的生成器发现与校验流程”，配合强制 --dry-run 预检和生成后的格式化/验证步骤，显著降低生成物落错位置或破坏仓库既有约定的概率。官方出品意味着它随 Nx 版本持续维护，不存在社区技能常见的滞后风险。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Nrwl 是 Nx 构建系统的官方开发商，发布方即所服务技术的所有者；所属配置仓库星数 27，目前未见独立第三方讨论 |
| 可用性 | 9 | 官方一键命令或手动复制目录即可安装；文档含完整的分步流程、常见误用的正反例和验证步骤；技能文件最近一次提交 2026-05-12；不依赖付费服务 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：①会执行 nx generate、nx format --fix、nx run-many 等本地 shell 命令并写入/修改工作区文件，范围限定在当前 monorepo 内，行为可审计 ②无联网外发，仅可能触发包管理器按生成器依赖拉取 npm 包（标准工具链行为，非本技能引入的额外外联）③不需要凭据 ④全文未见可疑指令 ⑤作者为 Nx 官方团队 ⑥License MIT，明确 ⑦最近维护 2026-05-12，活跃
综合评分（三项均值）：8.0
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| nx-workspace（同属官方技能包） | 姊妹技能，教 Agent 用只读命令理解 monorepo 现有结构 | 面向理解现状而非新建代码，二者一读一写、互补 |
| angular-new-app-angular-angular | Angular 官方脚手架技能，专注创建新 Angular 应用 | 只覆盖单一框架的应用创建，不处理 Nx 多插件生态下任意类型库/应用的生成器发现与仓库既有约定匹配 |
| monorepo-management（wshobson/agents） | 社区维护的参考指南，覆盖 Turborepo/Nx/pnpm 三套工具的静态配置模板 | 是文档模板，不驱动 Agent 实际发现并执行生成器，也不含 dry-run 校验环节 |
差异化在于官方出品、跨生成器通用（覆盖任意已安装的 Nx 插件生成器）、且流程内置了发现、校验、格式化、验证四个环节而非仅给出命令示例。
8. 用户评价
该技能目前在 Reddit、Hacker News 等平台尚无具名用户评价。Nx 官方博客文章《Teach Your AI Agent How to Work in a Monorepo》介绍了包含本技能在内的整套 AI Agent 配置包的设计动机。
9. 安装使用方式
- 官方一键安装（推荐）：Nx 工作区根目录运行
npx nx configure-ai-agents，会同时生成 MCP server 配置、多个技能（含本技能）与指南文件，覆盖 Claude Code、GitHub Copilot、Gemini、OpenCode 等 - skills.sh 获取：
npx skills add nrwl/nx-ai-agents-config - 手动安装（仅取本技能）：复制仓库
skills/nx-generate/目录进 Agent 技能目录 - 安装后无需重启，Agent 按意图触发词（如“scaffold”“create a new lib”）自动加载
10. 注意事项
- 仅适用于 Nx 管理的 monorepo，对非 Nx 项目不适用
- 官方一键安装命令对 Codex 不生成本技能的 skills 目录，Codex 用户需手动移植 SKILL.md
- 技能强调“必须先读生成器源码再执行”，对不熟悉 Nx 插件机制的用户，前几次使用仍需人工复核生成结果是否符合预期