1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | nx-workspace-nrwl-nx-ai-agents-config |
| 作者/维护者 | Nrwl（Nx 构建系统的官方开发商） |
| 来源链接 | https://github.com/nrwl/nx-ai-agents-config/tree/main/skills/nx-workspace |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars / Forks | 所属仓库 27 stars（数据来自 GitHub API；该数字属整个配置仓库，不代表本技能自身热度） |
| 最新版本 | 无独立版本号，最近一次提交 2026-07-23 |
| 安装方式 | 官方一键命令 / 手动复制目录，见第 9 章 |
2. 功能介绍与亮点
nx-workspace 教 Agent 用只读的 nx CLI 命令理解 monorepo 真实结构，而非猜测或翻找配置文件：nx show projects 按类型/标签/依赖筛选项目；nx show project <name> --json 取得比直接读 project.json 更准确的完整配置；nx graph --print 配合 jq 查询依赖图；结合 Git 基准分支定位改动影响范围；针对常见报错给出排查步骤。
亮点：官方出品、开源可审计、全程只读，输出走 --json 可编程解析，随 Nx 迭代持续维护。
3. 适用场景
所属分类：工程效率与代码质量——技能面向理解与排查代码仓库结构。
适用于使用 Nx 的 monorepo 项目：Agent 在新增功能库、排查任务失败、评估改动影响范围前，先用它建立对工作区的准确认知。受益人群是用 Claude Code、Codex 等 Agent 做开发与 CI 排障的 Nx 团队初中级工程师。
4. 跨 Agent 兼容性
- Claude Code：原生支持——官方一键命令
nx configure-ai-agents明确覆盖 - Codex：原生支持——同一命令覆盖；官方 issue 显示 Codex 端配置识别曾有兼容性问题，已被跟踪处理
- OpenClaw / Hermes Agent：未验证——官方材料未提及，技能本体为标准 SKILL.md 格式，理论上可手动复制使用
5. 推荐理由
它把“Agent 对 monorepo 的理解”从“读源码猜结构”变成“调用 Nx 自身查询命令拿准确答案”，减少 Agent 因看错项目边界或依赖关系而办错事。作为官方出品，它与 Nx CLI 同步演进，无社区技能常见的滞后风险，且全程只读、无网络外发。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Nrwl 是 Nx 构建系统的官方开发商，发布方即所服务技术的所有者；所属配置仓库星数 27，目前未见独立第三方讨论 |
| 可用性 | 9 | 复制目录或一条命令即可安装；文档含完整示例与故障排查小节；最近一次提交 2026-07-23；不依赖付费服务 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：①仅只读命令，无写操作 ②无联网外发 ③不需要凭据 ④全文未见可疑指令 ⑤作者为 Nx 官方团队 ⑥License MIT ⑦最近维护 2026-07-23，活跃
综合评分（三项均值）：8.33
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| monorepo-management（wshobson/agents） | 社区参考指南，覆盖 Turborepo/Nx/pnpm 三套工具配置模板 | 覆盖更广但为静态模板，不驱动 Agent 读取真实仓库结构 |
| nx-generate（同属官方技能包） | 姊妹技能，专注按既有约定生成新库/新应用 | 面向新建代码而非理解现状，与本技能互补 |
| turborepo skill（TerminalSkills/skills） | 社区维护，专注 Turborepo 单一工具构建与缓存配置 | 只覆盖 Turborepo，无 Nx 依赖图查询能力 |
差异化在于官方出品、只读、直接驱动 Agent 调用 Nx 自身查询接口。
8. 用户评价
该技能目前在 Reddit、Hacker News 等平台尚无具名用户评价。Nx 官方仓库 nrwl/nx 的 issue 中可见用户使用官方安装入口后反馈的具体问题，如 Codex 端配置识别异常、希望安装时可跳过 Nx Cloud 相关技能。
9. 安装使用方式
- 官方一键安装（推荐）：仓库根目录运行
npx nx configure-ai-agents，同时生成 MCP server 配置、多个技能（含本技能）与指南文件，覆盖 Claude Code、Cursor、Copilot、Gemini、Codex、OpenCode - skills.sh 获取：
npx skills add nrwl/nx-ai-agents-config - 手动安装（仅取本技能）：复制
skills/nx-workspace/目录进 Agent 技能目录 - 安装后无需重启，Agent 按意图自动加载
10. 注意事项
- 仅适用于 Nx 管理的 monorepo，对 Turborepo-only、Bazel、纯 pnpm workspaces 项目不适用
- 官方一键安装命令会连带装入 Nx Cloud 相关技能，已有用户反馈此点；只需工作区理解能力时建议手动安装精确取用
- 依赖本机可调用 Nx CLI