Angular 新建应用技能
指导编码代理用 Angular CLI 按官方最佳实践搭建现代化 Angular 应用,避免手工脚手架踩坑。
技能指令仅调用 Angular CLI 官方命令,无敏感数据读取或隐蔽外传;全局安装前会先询问用户,属良性确认。但依赖 npx/npm 拉取外部包、缺少回滚说明与权限范围声明,属部分披露,未达满分。得15分,扣分点:依赖安全与回滚/数据流说明不完整。
指令自洽、步骤清晰(检查CLI→创建→生成代码),失败路径(CLI缺失)有处理。但无测试或可复现证据,对 npx 失败、网络错误、参数非法等异常输入缺少诊断性反馈,静态校准上限10分。得9分,扣分点:异常输入的错误反馈薄弱。
触发场景明确(用户想创建新 Angular 应用),列出了常用 flags 与 ai-config 选项,边界相对清楚。但未声明不适配场景,且核心流程完全依赖 npm registry 与外网(含 tailwindcss.com 文档),对中国大陆网络可达性存在风险,按规则在此扣分。得8分。
SKILL.md 含 name、description、license(MIT)、版本号与作者元数据,README 提供了清晰的贡献与维护路径(angular/angular 仓库),文档分层合理。但版本仅 '1.0' 无 changelog,环境前置依赖说明较简略,license 元数据在仓库级别标记为未知。得10分,扣分点:版本治理与已知限制披露不完整。
指令描述了完整可用的新建流程并引用 CLI 保证代码风格一致,happy path 可信;但静态审查无法验证产物正确性,边际收益依赖 Claude/Gemini 等环境,证据有限,静态校准上限7分。得6分,扣分点:输出可用性缺乏代表性验证。
仅有声明性指令与外部链接,无提交的测试套件或第三方执行证据,关键主张不可独立复现,静态校准上限5分。得4分,扣分点:缺乏可复现测试覆盖。
- 静态审查未执行任何命令;实际效果需用户自行验证。
- 核心流程完全依赖 npm registry 与外网(含 tailwindcss.com),中国大陆网络环境下 npx 安装与文档访问可能失败。
- npm install -g 全局安装与 npx 拉包会执行第三方代码,用户应在确认来源与版本后再同意。
- 技能未提供回滚或卸载指引;建议在受控环境中先行试用。
- 维护在 angular/angular 仓库进行,skills 仓库为输出产物,更新以输出为准。
这个 Skill 能做什么,适合哪些场景?
angular-new-app 是 angular/skills 仓库中收录的一个 Agent Skill,由 Google 的 Angular 团队维护。它在用户需要创建新 Angular 应用时激活,指导代理检查并安装 Angular CLI、使用 ng new 创建项目并按需启用 AI 配置。之后它规范组件、服务等代码的生成方式,并覆盖 Tailwind CSS 接入流程。适合希望代理产出符合最新 Angular 规范代码的开发者。
运行 which ng / where ng 检查 Angular CLI 是否存在,缺失时建议执行 npm install -g @angular/cli 全局安装;使用 npx ng new <app-name> 加上 --interactive=false 和 --ai-config 选项创建应用,并支持 --style、--routing、--ssr、--prefix 等常用参数;通过 npx ng generate 生成组件、服务、管道、指令、接口、守卫、拦截器、解析器、枚举和类;用 npx ng build 验证并修复错误;用 npx ng add tailwindcss 接入 Tailwind v4;并提示可访问 Angular CLI 内置的 MCP 服务器(ng mcp)获取最佳实践。
- 开发者想让代理从零搭建一个全新的 Angular 项目,而不是手写文件结构
- 团队希望生成的 Angular 代码遵循官方最佳实践,并让代理加载 ng new 生成的 AI 配置文件
- 需要代理在创建项目后继续生成组件、服务等 Angular 代码
- 想在新建应用时即接入服务端渲染(--ssr)或 Tailwind CSS
- 使用 Gemini CLI、Antigravity 等支持 Agent Skills 的代理工具的 Angular 开发者
这个 Skill 有哪些优点和局限?
- 由 Angular 团队官方维护,路径和参数遵循最新 CLI 用法
- 覆盖从环境检查、项目创建、代码生成到 Tailwind 接入的完整流程
- 明确利用 ng new 的 --ai-config 选项,使生成的项目自带 AI 工具配置
- 提示 CLI 内置 MCP 服务器(ng mcp)作为最佳实践来源
- 仓库 README 未标注许可证,仅 SKILL.md 声明 MIT;仓库层面也缺少描述和 topics
- 贡献和 issue 需提交到 angular/angular 仓库,反馈链路较绕
- 无测试套件或平台兼容性验证的证据;仅在文档列出的场景中验证
- 仅覆盖新建应用场景,已有项目的日常开发需配合 angular-developer 技能
如何安装这个 Skill?
在支持 Agent Skills 的环境中(如 Gemini CLI、Antigravity,或通过 skills.sh 等社区工具)执行:npx skills add https://github.com/angular/skills。该仓库包含 angular-developer 和 angular-new-app 两个技能,本技能位于 angular-new-app/ 目录(含 SKILL.md)。具体的各工具安装路径请参考对应工具的文档。
如何使用这个 Skill?
安装后在代理中提出创建新 Angular 应用的请求即可触发,例如:"帮我用 Angular CLI 创建一个叫 my-app 的新项目,使用 SCSS 并开启路由"。技能要求环境中有 node、npm 和网络访问;它建议优先使用与当前环境匹配的 --ai-config 值(agent、claude、copilot、cursor、gemini、jetbrains、none、windsurf)。注意:不要让代理在完成功能前就启动应用,可用 npx ng build 检查错误。
这个 Skill 与同类方案有什么区别?
同仓库的 angular-developer 技能负责已有项目的代码生成与架构指导(含信号、表单、路由、SSR 等),而 angular-new-app 专注项目脚手架;两者互补,新建项目场景应选本技能。