Angular 开发者技能
让编码代理按照最新 Angular 版本的最佳实践生成代码并给出架构建议,覆盖组件、信号、路由、表单、测试等核心主题。
技能只含指导性文本与文档引用,不要求危险权限;外部效果限于 ng/npx 命令与本地构建,未见数据外发或凭据接触。扣分项:npx 拉取 @angular/cli@latest 与远程文档 angular.dev 的依赖属隐式网络/供应链行为,未说明来源校验、回滚或用户确认机制。
指令内部大体自洽,ng new 的三分支决策树明确,要求 ng build 验证有失败反馈路径。扣分项:静态审查无法执行验证;references 中个别 API 写法(如 @Service、autoProvided)与主流 Angular 文档惯例不一致且无本地核对手段,异常输入的错误处理未覆盖。
description 触发条件枚举详尽(组件、signals、表单、路由、SSR、测试、CLI),场景清晰;但未声明不适用边界(如 NgModules 老项目深度支持)、无中文语言说明,且 npx/cli 与 angular.dev 文档在大陆网络可达性存在不确定性,构成环境扣分。
结构良好:SKILL.md 做路由层、references 做渐进披露;有 MIT 许可、作者(Google LLC)与版本号 1.0。扣分项:无 changelog、无已知限制清单、维护责任需经 README 转介到 angular/angular,更新路径间接;license 字段在提示中标记为 unknown 与文件内声明不完全一致。
目标是生成地道 Angular 代码与架构指导,大量带版本区分的参考内容对 agent 有实际边际价值;引用官方仓库来源可信。扣分项:静态审查无法验证代表性输出的直接可用性,未提供示例输出或对比收益证据,按上限封顶 7 分。
引用了大量官方主材料路径(references/*.md)与 angular.dev,来源可审计。扣分项:仓库未提供该技能自身的测试套件或第三方执行证据,关键主张仅靠引用而非可复现验证,静态审查下封顶 5 分。
- 技能会触发 npx 拉取 npm 包(含 @latest),属外部网络行为,建议在受限网络或离线环境使用前评估依赖来源。
- angular.dev 远程文档引用在中国大陆可能不可达,核心功能的完整体验或受影响。
- references/creating-services.md 中 @Service、autoProvided 等写法与常见 Angular 文档不一致,使用时建议对照本地项目实际 API 核实。
- 技能声明 'Always run ng build',会在用户项目中执行命令,需确认代理环境的命令执行授权。
- 发布方未经 FollowSkills 注册表验证,本评估为静态源码审查,未做任何执行测试。
这个 Skill 能做什么,适合哪些场景?
angular-developer 是 Google 官方 angular/skills 仓库中的一个 Agent Skill,用于生成符合最新 Angular 最佳实践的代码并提供架构指导。它要求先判断项目的 Angular 版本再给建议,生成代码后运行 ng build 验证。技能本身是纯 Markdown 指南加一组 references/ 参考文档,涵盖组件、Signals(含 linkedSignal、resource、httpResource)、表单、依赖注入、路由、无障碍(Angular Aria)、样式、测试和 CLI 工具。它与同仓库的 angular-new-app 是并列技能,安装时随整个仓库一起添加。技能采用 MIT 许可证,由 Google 维护,贡献与问题反馈走 angular/angular 主仓库。
读取内置 references/ 目录下的主题参考文档(组件、输入输出、signals、DI、路由、测试等);根据用户请求的版本选择 npx @angular/cli@版本 或本地 ng new 创建新项目;在生成组件、服务、指令、管道、路由时遵循 Angular 风格指南并优先使用 Angular CLI 脚手架;代码生成完成后运行 ng build 检查并修复构建错误;新项目默认使用 Angular v22+ 的 Signal Forms;需要更深入的文档时引导查阅 angular.dev 官方指南。
- 使用支持 Agent Skills 的编码代理(如 Gemini CLI、Antigravity、Claude Code)开发 Angular 应用的团队,希望生成符合官方最佳实践的组件和服务
- 新建 Angular 项目时,希望代理按最新稳定版和 Signal Forms 等现代默认值正确执行 ng new 流程
- 从旧版 Angular 迁移或重构的工程师,需要了解 v20+ 命名规范、signals、migrations 等现代化指导
- 构建含路由守卫、数据解析器、SSR/水合渲染策略的复杂导航场景
- 需要可访问的自定义组件(手风琴、下拉、标签页等)时参考 Angular Aria 的无头组件模式
- 编写单元测试(Vitest、TestBed)、组件 Harness 和 E2E 测试时获取官方推荐模式
这个 Skill 有哪些优点和局限?
- Google 官方出品,与 angular.dev 文档体系一致,内容可信且随 Angular 版本更新
- 覆盖面极广:组件、signals、DI、路由、表单、测试、无障碍、样式、CLI 均有专门参考文档
- 内置版本检测和 ng build 验证步骤,减少生成不可构建代码的风险
- 纯 Markdown + 参考文件,无脚本依赖,符合开放 Agent Skills 标准,跨工具可移植
- 仓库未提供仓库级许可证信息(SKILL.md 声明 MIT),README 亦未列出 Topics 或测试套件
- 深挖文档依赖网络访问 angular.dev;离线环境下参考链接不可用
- 主要面向最新版 Angular(如 Signal Forms 稳定于 v22+),维护旧版本的团队收益有限
- 运行 ng build 和 ng new 需要本地已配置 Node.js/Angular CLI 环境,技能未提供环境搭建说明
如何安装这个 Skill?
在支持 Agent Skills 的环境中运行:npx skills add https://github.com/angular/skills,将技能集合添加到你的代理工具中。仓库 README 未说明单独安装 angular-developer 这一个子目录的方法;各工具的具体安装路径请参考对应工具文档(如 Gemini CLI、Antigravity)或社区工具 skills.sh。
如何使用这个 Skill?
激活技能后,用自然语言提出 Angular 相关任务即可触发,例如:'创建一个新 Angular 项目'、'用 signals 重构这个服务'、'给这个模块加路由守卫'。代理会先检查项目 Angular 版本,再按技能内置规则生成代码,并运行 ng build 验证。具体激活命令取决于你的代理工具,README 未提供各工具的详细步骤。
这个 Skill 与同类方案有什么区别?
同一仓库还包含 angular-new-app 技能,专门负责新建 Angular 应用的初始化与目录结构搭建;若你的需求仅是创建新项目,可用那个技能,而通用开发指导应使用本技能。