用途:为 Ignite UI for Angular 仓库撰写可被智能体稳定发现和加载的 SKILL.md 提供规则参考。
文件位置:内部贡献者技能放 .agents/skills/<name>/SKILL.md;随包发布的公开技能放 skills/<name>/SKILL.md,文件夹名须与 name 字段一致。
Frontmatter 规则:license 必填,默认 MIT;name 必填,最多 64 字符,仅小写字母、数字和连字符,不含 XML 标签,禁用 anthropic、claude 等保留词,并使用 igniteui-angular- 前缀;description 必填非空,最多 1,024 字符,不含 XML 标签。描述用第三人称,先说明覆盖范围,再加 WHEN TO USE: 与 WHEN NOT TO USE: 两个标记,后者指出不覆盖的邻近任务并点名应改用的技能。智能体加载前只看到 name 和 description,因此描述决定技能是否被使用。
Token 预算:SKILL.md 正文保持在 500 行以内;超出时采用渐进式披露,把概述和核心规则留在 SKILL.md,细节移入 references/<topic>.md,并从 SKILL.md 直接链接(仅一层),说明何时阅读,以便按需加载。
公开技能中的 MCP 服务器:涉及组件或网格用法(选择器、导入、输入、输出、方法)需 igniteui-cli,用 list_components 并设 framework: "angular" 验证;涉及主题(调色板、主题、排版、高度、组件设计令牌)需 igniteui-theming,用 detect_platform 验证;两者都覆盖则两个都需。每个必需服务器须在任何步骤前按表中调用验证;若工具缺失,告知智能体自行执行 npx -y igniteui-cli ai-config(或 ig ai-config)配置,请用户重载并停止。仅在用户明确要求时可在无服务器下继续,并标注未验证细节。不得把服务器描述为可选,也不得添加“when available”回退,措辞沿用 igniteui-angular-components 与 igniteui-angular-theming。
检查清单:frontmatter 符合规则;描述含 WHEN TO USE: 与 WHEN NOT TO USE:;正文 500 行内且每个引用文件都从 SKILL.md 链接;公开技能含所需 MCP 服务器检查;技能已列入 AGENTS.md 的 Skills 表,内部技能还列入 .agents/README.md 与 .github/copilot-instructions.md。
相关技能:igniteui-angular-build、igniteui-angular-testing、igniteui-angular-linting。
限制:资料仅描述仓库内技能撰写规范,未提供其他平台、收费或额外使用步骤信息。