用途:该技能面向 angular-best-practices 项目的贡献者,用于按项目既有约定创建新的 Angular 最佳实践规则文件,以及可选的库技能(library skill),不用于 Angular 应用开发。
主要能力:创建新规则时,会从规则文件名推断前缀(如 material-imports.md → material),在 packages/angular-best-practices-build/src/config.ts 的 sectionMap 中查找章节编号,并按前缀将文件放入对应子目录,例如 test-* 放入 rules/testing/,ui-、a11y-、loading-、dialogs-、theming-* 放入 rules/ui/,http-、mapper- 放入 rules/data/,ts-* 放入 rules/typescript/,opt-、bundle-、async-* 放入 rules/optimization/,arch-* 放入 rules/core/,其余(signals、components、forms、rxjs、ngrx、material、primeng、spartan、transloco 等)放入 rules/angular/。规则内容从 rules/_template.md 复制模板,并遵循标题为“动词+主语”、描述不超过一句、代码块最多 0-2 个、每块 3-5 行、总长度 50 行以内(理想 30-40 行)、不包含安装命令或配置转储等约定,最后用 angular-best-practices-rules-reviewer 技能校验。
创建库技能时,需选择下一个可用章节编号,更新 config.ts 中的 sectionMap、SECTION_TITLES、SECTION_IMPACTS、OPTIONAL_SKILLS,更新 rules/_sections.md,创建 skills/<skill-name>/SKILL.md 及其 frontmatter,并在 rules/angular/ 下创建初始规则文件,最后运行 npm run build 生成 AGENTS.md 文件。
使用方式:通过自然语言请求创建规则或库技能,工具会按上述流程执行。构建命令为 npm run build(重新生成所有 AGENTS.md 文件)和 npm run build:skip-validation(开发时跳过校验)。
限制:仅适用于该项目的贡献流程,不适用于 Angular 应用开发;资料未提供收费、价格、平台或效果等信息。