Angular最佳实践规则创建工具 - 自动化生成代码规范与库技能 | SkillsMD⚠️重要前提
安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →
Angular最佳实践规则创建工具 - 自动化生成代码规范与库技能
angular-best-practices-rule-creator by alfredoperez/angular-best-practices
npx skills add https://github.com/alfredoperez/angular-best-practices --skill angular-best-practices-rule-creator🇨🇳中文介绍
规则创建代理
创建新的 Angular 最佳实践规则和可选的库技能，严格遵循项目约定。
能力
1. 创建新规则
当被要求创建规则时：
- 从规则文件名确定前缀（例如，
material-imports.md → 前缀 material）
- 在
packages/angular-best-practices-build/src/config.ts → sectionMap 中查找章节编号
- 根据前缀将文件放置在正确的
rules/ 子目录中：
test-* → rules/testing/a11y-*, , , , →
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
ui-*
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 复制模板按照以下规则填写 frontmatter 和内容：
- 标题： 动词 + 主语（例如，"使用 Signal Inputs"）
- 描述： 最多 1 句话
- 代码块： 最多 0-2 个（错误 + 正确，或仅正确）
- 每个代码块的行数： 最多 3-5 行
- 总长度： 少于 50 行（理想 30-40 行）
- 不包含安装命令、配置转储或文件夹结构
使用 angular-best-practices-rules-reviewer 技能进行验证2. 创建新库技能
- 选择下一个可用的章节编号（检查 config.ts 中的
SECTION_TITLES）
- 更新
packages/angular-best-practices-build/src/config.ts：
- 在
sectionMap 中添加 前缀 → 章节编号
- 在
SECTION_TITLES 中添加章节标题
- 在
SECTION_IMPACTS 中添加章节影响
- 在
OPTIONAL_SKILLS 数组中添加条目
- 在
rules/_sections.md 中添加章节定义
- 创建
skills/<skill-name>/SKILL.md 并包含 frontmatter（name, description, metadata, tags, globs）。阅读 .claude/skills/angular-best-practices-rules-reviewer/references/skill-best-practices.md 了解 SKILL.md 的质量标准。
- 在
rules/angular/ 中使用该技能的前缀创建初始规则文件
- 运行
npm run build 以生成 AGENTS.md 文件
前缀 → 章节映射（当前）
| 前缀 | 章节 | 标题 |
|---|
async, opt-async | 1 | 消除瀑布流 |
bundle | 2 | 打包优化 |
opt, performance | 3 | JavaScript 性能 |
ts | 4 | TypeScript 最佳实践 |
signal | 5 | 信号与响应式 |
component | 6 | 组件模式 |
rxjs | 7 | RxJS 模式 |
cd | 8 | 变更检测 |
template | 9 | 模板优化 |
ssr | 10 | SSR 与 Hydration |
form | 11 | 表单 |
ngrx | 12 | NgRx 状态管理 |
signalstore | 13 | SignalStore |
tanstack | 14 | TanStack Query |
arch | 15 | 架构 |
test | 16 | 测试 |
core, di, error-handling, observability, pattern, routing, security | 17 | 基础设施 |
ui, a11y, loading, dialogs, theming | 18 | UI 与无障碍 |
http, mapper | 19 | 数据处理 |
material | 20 | Angular Material |
primeng | 21 | PrimeNG |
spartan | 22 | Spartan UI |
transloco | 23 | 国际化 |
文件放置
| 子目录 | 前缀 |
|---|
rules/angular/ | signal, component, rxjs, cd, template, ssr, form, ngrx, signalstore, tanstack, material, primeng, spartan, transloco |
rules/testing/ | test |
rules/ui/ | ui, a11y, loading, dialogs, theming |
rules/typescript/ | ts |
rules/optimization/ | opt, bundle, async, performance |
rules/core/ | arch, core, di, error-handling, observability, pattern, routing, security |
rules/data/ | http, mapper |
模板参考
---
title: Verb + Subject
impact: MEDIUM
impactDescription: Brief metric (e.g., "2-10x faster", "O(n) to O(1)")
tags: tag1, tag2
---
## Verb + Subject
One sentence explaining the rule.
**Incorrect:**
\`\`\`typescript
// 3-5 lines max
\`\`\`
**Correct:**
\`\`\`typescript
// 3-5 lines max
\`\`\`
构建命令
npm run build # 重新生成所有 AGENTS.md 文件
npm run build:skip-validation # 开发期间跳过验证
🇺🇸English
Rule Creator Agent
Creates new Angular best practice rules and optional library skills following the exact project conventions.
Capabilities
1. Create a New Rule
When asked to create a rule:
- Determine the prefix from the rule filename (e.g.,
material-imports.md → prefix material)
- Look up the section number in
packages/angular-best-practices-build/src/config.ts → sectionMap
- Place the file in the correct
rules/ subdirectory based on the prefix:
test-* → rules/testing/a11y-*, ui-*, loading-*, dialogs-*, theming-* → rules/ui/http-*, mapper-* → rules/data/ts-* → rules/typescript/opt-*, bundle-*, async-* → rules/optimization/arch-* → rules/core/- Everything else (signals, components, forms, rxjs, ngrx, material, primeng, spartan, transloco, etc.) →
rules/angular/
- Copy the template from
rules/_template.md
- Fill in the frontmatter and content following these rules:
- Title: Verb + Subject (e.g., "Use Signal Inputs")
- Description: 1 sentence max
- Code blocks: 0-2 max (incorrect + correct, or just correct)
- Code per block: 3-5 lines max
- Total length: Under 50 lines (ideal 30-40)
- No installation commands, configuration dumps, or folder structures
- Validate with the
angular-best-practices-rules-reviewer skill
2. Create a New Library Skill
When asked to create a new optional library skill:
- Choose the next available section number (check
SECTION_TITLES in config.ts)
- Update
packages/angular-best-practices-build/src/config.ts:
- Add prefix → section number in
sectionMap
- Add section title in
SECTION_TITLES
- Add section impact in
SECTION_IMPACTS
- Add entry in
OPTIONAL_SKILLS array
- Add section definition in
rules/_sections.md
- Create
skills/<skill-name>/SKILL.md with frontmatter (name, description, metadata, tags, globs). Read .claude/skills/angular-best-practices-rules-reviewer/references/skill-best-practices.md for SKILL.md quality standards.
Prefix → Section Mapping (Current)
| Prefix | Section | Title |
|---|
async, opt-async | 1 | Eliminating Waterfalls |
bundle | 2 | Bundle Optimization |
opt, performance | 3 | JavaScript Performance |
ts | 4 | TypeScript Best Practices |
|
File Placement
| Subdirectory | Prefixes |
|---|
rules/angular/ | signal, component, rxjs, cd, template, ssr, form, ngrx, signalstore, tanstack, material, primeng, spartan, transloco |
rules/testing/ | test |
rules/ui/ | ui, a11y, loading, dialogs, theming |
rules/typescript/ | ts |
rules/optimization/ | opt, bundle, async, performance |
rules/core/ |
Template Reference
---
title: Verb + Subject
impact: MEDIUM
impactDescription: Brief metric (e.g., "2-10x faster", "O(n) to O(1)")
tags: tag1, tag2
---
## Verb + Subject
One sentence explaining the rule.
**Incorrect:**
\`\`\`typescript
// 3-5 lines max
\`\`\`
**Correct:**
\`\`\`typescript
// 3-5 lines max
\`\`\`
Build Commands
npm run build # Regenerate all AGENTS.md files
npm run build:skip-validation # Skip validation during development
Weekly Installs
44
Repository
alfredoperez/an…ractices
GitHub Stars
19
First Seen
Feb 16, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
codex42
opencode41
github-copilot41
gemini-cli40
amp39
kimi-cli39
Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程
48,700 周安装
rules/angular/ with the skill's prefixRun npm run build to generate AGENTS.md filescomponent | 6 | Component Patterns |
template | 9 | Template Optimization |
ngrx | 12 | NgRx State Management |
core, di, error-handling, observability, pattern, routing, security | 17 | Infrastructure |
ui, a11y, loading, dialogs, theming | 18 | UI & Accessibility |
http, mapper | 19 | Data Handling |
material | 20 | Angular Material |
transloco | 23 | Internationalization |
| arch, core, di, error-handling, observability, pattern, routing, security |
