Angular 官方智能体 Skills:让 AI 编程工具生成现代化 Angular 代码
Angular 官方智能体 Skills:让 AI 编程工具生成现代化 Angular 代码
谷歌 Angular 团队发布
angular/skills仓库,为 AI 编程智能体提供结构化指令,以生成符合最新 Angular 约定(Signals、独立组件等)的现代化代码,而非模型默认使用的过时模式。该仓库当前包含两个核心 Skill:angular-developer和angular-new-app,分别用于代码生成与项目脚手架搭建,并针对 Gemini CLI 和 Antigravity 等智能体工具设计。
什么是智能体 Skills
智能体 Skills 是由 Anthropic 提出的一种开放格式,本质上是结构化的、领域特定的指令文件。这些文件按需加载,为 AI 智能体提供特定任务的专业知识,使其在执行编程任务时能够遵循最新的框架约定,而非依赖模型训练数据中可能过时的模式。
Angular 团队发布的 angular/skills 仓库正是这样一套指令集合,旨在教会 AI 编程工具编写语义正确、符合当前 Angular 最佳实践的代码。
两个核心Skills
目前 Angular 官方集合包含两个 Skill:
angular-developer
该 Skill 用于生成代码,并在以下方面提供架构指导:
- 响应式编码(Signals、linkedSignal、resource)
- 表单
- 依赖注入
- 路由
- 服务器端渲染(SSR)
- 无障碍(a11y)
- 动画
- 样式
- 测试
在实践中,angular-developer 强制采用 Angular v20 约定,例如:使用 @if 替代 *ngIf,并自动移除冗余的 standalone: true 标记(因为独立组件已是默认选项)。
angular-new-app
该 Skill 通过 Angular CLI 搭建新的应用脚手架,帮助开发者快速创建遵循最新配置的项目基础。
这些 Skill 专为 Gemini CLI 和 Antigravity 等智能体工具设计,官方文档指出它们能使智能体与 Signals、独立组件等约定保持同步。
注意:该仓库是一个已发布的快照,并非原始的事实来源。实际贡献在主仓库
angular/angular中进行,并自动镜像到此 Skill 仓库。
动机:AI 常推荐过时模式
为何要发布这些 Skills?正如 Brandon Roberts 在相关文章中所解释的,编程智能体“经常建议过时的 Angular 模式、NgModules、@Input() 装饰器、*ngIf 和构造函数注入”。这是因为 LLM 训练数据中缺乏最新上下文,导致它们默认使用旧版 API,而非 Angular 团队当前推荐的最佳实践。
通过注入结构化的 Skill 指令,AI 工具可以即时获取框架最新约定,从而生成更高质量的代码。
安装与使用
开发者可通过社区提供的 skills CLI 轻松安装:
npx skills add
该发布建立在社区工作之上,正如 Angular 新闻作者 Gérôme Grignon 所观察到的,智能体 Skills 已成为向大模型提供框架上下文的“最受欢迎”方式。最广泛使用的前作是 Roberts 的 analogjs/angular-skills。此外,竞争性方法如受 Vercel 的 react-best-practices 启发的 alfredoperez/angular-best-practices 也依然存在。
社区反响与讨论
评论集中在官方基于仓库的 Skills 为何重要。为 Angular.love 撰文的 Dominik Donoch 赞赏其“自动验证循环”功能——该机制在编辑后会强制智能体运行 ng build,从而提高生成代码的可构建性。他还肯定了编排器设计,该设计只加载相关参考文件,从而限制 token 使用,提升效率。
在 Reddit 上,开发者表示这些 Skill“因为存在于仓库中而感觉更原生”,且“可版本化、可比较差异(diffable)”,也有人承认他们“之前不知道 Angular 有自己的最佳实践技能”。怀疑者则对格式能否修复 LLM 的可靠性持保留态度。
在 Hacker News 上,有评论者指出了此类机制的根本问题:它们假设 LLM 是严格且完美遵循规则的,唯一的问题只是无法足够清晰地指定足够多的规则。这反映了对 LLM 工作方式的根本性认知错误。也有人反驳说,不应该“让完美成为足够好的敌人”。
迁移注意事项
对于已使用社区包(如 analogjs/angular-skills)的团队,迁移前应先将其移除:
npx skills remove analogjs/angular-skills
CLI 还通过锁文件跟踪偏移,开发者可使用以下命令跟上 Angular 频繁发布的节奏:
npx skills check
npx skills update
由于这些 Skill 面向 Angular v20 及更高版本,旧项目应首先按照官方升级指南采用独立组件、inject() 和 Skill 假定的内置控制流,然后再应用这些 Skills。
关键要点
- Angular 官方发布
angular/skills仓库,通过结构化指令文件引导 AI 智能体编写符合 v20 约定的现代化代码。 - 当前包含两个 Skill:
angular-developer(代码生成与架构指导)和angular-new-app(CLI 脚手架搭建)。 - 该方案解决了 AI 常推荐过时 Angular 模式(如 NgModules、
*ngIf等)的问题。 - 安装简单:
npx skills add,并支持版本化、差异对比和自动验证循环。 - 社区反馈积极,但也存在对 LLM 规则遵循能力的争议。
- 旧项目需先升级到独立组件等最新约定,再使用这些 Skills。