angular-new-app-angular-angular

1. 基本信息

项目自述名称：angular-new-app（SKILL.md 内自述，未带拥有者/仓库前缀；正式名称按合集子技能规则补全为下表名称）

项目	内容
名称	angular-new-app-angular-angular
作者/维护者	Angular Team @ Google（SKILL.md metadata 字段自述）
来源链接	https://github.com/angular/angular/tree/main/skills/dev-skills/angular-new-app
许可证	MIT（SKILL.md 自述 + 仓库根 LICENSE 双重确认，来自 GitHub API）
GitHub Stars	所在 angular/angular 仓库 100,612（GitHub API 实测，monorepo 星数不直接代表该子技能热度）；官方分发镜像仓库 angular/skills 单独 591 stars（GitHub API 实测）
Forks	angular/angular 27,337；angular/skills 41（均为 GitHub API 实测）
最新版本	1.0（SKILL.md 自身 metadata 版本号，随 angular/angular 仓库持续演进，不单独发版）
安装方式	`npx skills add https://github.com/angular/skills`（官方 README 给出的标准安装方式，可指定只装本技能）

2. 功能介绍与亮点

angular-new-app 是 Angular 核心团队官方维护的新项目脚手架技能，专门处理“从零创建一个新 Angular 应用”这一步骤，与同仓库的 angular-developer（日常开发指导）分工明确、互为姊妹技能。

核心亮点：

前置环境自检：先判断本机是否已安装 Angular CLI（which ng / where ng），未安装时会先询问用户是否需要全局安装，而不是直接报错中断
版本决策树：明确区分“用户指定版本→用 npx 拉取对应版本”与“未指定版本→检测本地已装版本或回退最新版”三种路径，避免生成命令猜错版本
AI 配置联动：ng new 命令支持 --ai-config 参数，可按当前使用的 agent（agents/claude/copilot/cursor/gemini 等）生成对应配置并要求 agent 读入内存，保证后续生成的代码与项目 AI 配置保持一致
常用脚手架命令速查：组件、服务、管道、指令、接口、守卫、拦截器、解析器、枚举、类等全部 CLI 生成命令一次性列全，并提醒记录生成文件的实际路径

3. 适用场景

所属分类：前端与设计

适合需要用 Claude Code / Codex 等 agent 从零创建新 Angular 项目的前端开发者：确定项目名称与技术选型（样式方案、路由、SSR、组件前缀等 CLI 参数）、首次搭建项目骨架、后续用 CLI 命令批量生成组件/服务/管道等场景，用一句自然语言描述即可让 agent 补全对应的 ng new/ng generate 命令而无需自己记忆参数。

4. 跨 Agent 兼容性

Claude Code：❓ 未验证——官方 README 仅点名 Gemini CLI、Antigravity 为目标工具，未见独立第三方资料确认本技能（区别于姊妹技能 angular-developer，那份技能有独立文章确认过 Claude Code 实际接入）
Codex：❓ 未验证——同上，公开材料未见直接证据
OpenClaw：❓ 未验证——公开材料未见相关证据
Hermes Agent：❓ 未验证——公开材料未见相关证据

5. 推荐理由

创建新 Angular 项目时最容易踩的坑是版本参数记错、CLI 未安装时流程卡死、或生成后风格与项目实际使用的 agent 不匹配。这个技能由 Angular 核心团队直接维护，把“先查 CLI 是否安装→按用户诉求选版本→生成项目→按当前 agent 类型联动 AI 配置”整个决策流程固化成明确的分支判断，出错概率比让 agent 现场拼凑 ng new 命令低得多，且与 Tailwind CSS 集成等常见后续步骤也一并给出了官方推荐路径。

6. 评分

维度	分数	说明
受欢迎程度	9	Google/Angular 核心团队直接维护并合并进框架主仓库（官方一线机构出品）；不采用 monorepo 整体 100,612 stars 作为该子技能热度依据，独立佐证为官方分发镜像仓库 angular/skills 自身 591 stars，且姊妹技能 angular-developer 已有独立第三方文章确认其官方地位，本技能与其同源同仓库同团队维护
可用性	9	`npx skills add` 一条命令安装；SKILL.md 步骤清晰、决策分支明确，覆盖组件/服务/管道/指令/接口/守卫/拦截器/解析器/枚举/类全部脚手架命令；仓库近日仍有提交，无付费依赖
安全性	8	见下方安全检查清单
综合	8.7	三项均值，超过 7.0 达标线，安全性远超一票否决线

安全检查清单：

检查项	结果
① Shell 命令及权限范围	涉及 `which`/`where ng`（只读检测）、`npm install -g @angular/cli`（全局安装，范围比本地安装更广但用途明确且需用户确认后才执行）、`npx ng new`/`ng generate`/`ng add tailwindcss`（标准脚手架与官方支持的第三方集成命令）
② 运行时联网外发	无独立外发逻辑，`npx`/`npm install` 仅按标准 npm 生态行为联网拉包
③ API Key / 凭据	不需要
④ 可疑指令（注入迹象）	未发现——通篇为脚手架操作指导，无诱导访问敏感文件或越权操作的表述
⑤ 作者/组织信誉	Google LLC / Angular 核心团队，一线科技公司官方框架团队
⑥ License 是否明确	明确——MIT，SKILL.md 自述与仓库根 LICENSE 双重确认
⑦ 最近维护时间	极活跃——所在仓库近日持续有提交

7. 跟同类 Skills 相比的优势

Skill	定位	与本技能的差异
angular-developer-angular-angular	Angular 日常开发指导（组件/路由/Signals/表单/DI/测试）	同源姊妹技能，解决“项目已存在，怎么继续开发”的问题；本技能解决的是更早一步的“项目还不存在，怎么从零创建”
expo-router-expo-skills	Expo/React Native 文件路由系统	服务完全不同的技术栈（移动端 React Native 而非 Web Angular），且聚焦路由架构而非项目初始化
react-best-practices-vercel-labs-agent-skills	React 生态最佳实践	同属“框架官方/一线出品”定位但服务不同技术栈；React 侧由 Vercel（生态伙伴）维护，本技能由 Angular 框架团队自身直接维护

8. 用户评价

该技能作为 2026 年新上线的姊妹技能，公开可见的独立第三方使用评价尚不多见。已有独立文章确认了同仓库、同团队维护的 angular-developer 已被 Angular 核心团队正式合并进主仓库并定位为项目“强制性基线”，本技能与其共享同一套安装入口与官方背书；针对 angular-new-app 本身的独立评测文章目前尚未出现。

9. 其他补充

技能遵循开放的 Agent Skills 格式，与姊妹技能 angular-developer 共享同一个官方分发镜像仓库 angular/skills，可通过同一条 npx skills add 命令按需只安装其中一个或两个都装；改动均需提交回 angular/angular 主仓库，angular/skills 仅作为面向社区的统一分发出口。

10. 安装使用方式

CLI 一条命令（官方推荐）：npx skills add https://github.com/angular/skills，可指定只安装 angular-new-app
手动方式：克隆 angular/angular 仓库，将 skills/dev-skills/angular-new-app 目录复制进 .claude/skills/（或对应 agent 的技能目录）
触发方式：用自然语言提出“帮我创建一个新的 Angular 项目”之类的请求即可自动触发；技能会先确认 Angular CLI 是否已安装，再按版本诉求生成对应的 ng new 命令
安装后注意：无需重启；若本机未安装 Angular CLI，技能会先询问是否需要全局安装而非直接报错

11. 注意事项

官方文档明确点名的目标工具是 Gemini CLI、Antigravity，Claude Code / Codex / OpenClaw / Hermes Agent 上的实际表现均未经独立验证，建议先小范围测试
npm install -g @angular/cli 为全局安装操作，多项目共享同一全局 CLI 版本时需自行注意版本兼容性
技能本身只负责项目创建阶段，创建后的日常开发建议与姊妹技能 angular-developer 搭配使用
内容与 Angular CLI 版本强相关，--ai-config 等参数的具体支持范围随 CLI 版本迭代可能变化