skills-index-snippets

用途

skills-index-snippets 用于维护 AGENTS.md / CLAUDE.md 中的技能索引片段。它的核心目的是让编码助手更容易使用技能：与其指望助手“记得”调用某个技能，不如在 AGENTS.md / CLAUDE.md 中放入一个小的路由片段，提供“任务→技能”的路由索引，从而消除决策点，并让技能使用在不同项目之间保持一致。

何时使用

资料列出的适用场景包括：

在本仓库中新增、删除或重命名任何技能
更新 .claude-plugin/plugin.json
为下游仓库（OpenCode、Claude Code 等）创建可复制粘贴的片段
希望获得一个紧凑、常驻、能提升技能利用率的索引

事实来源

注册表：.claude-plugin/plugin.json
技能以目录形式列出，每个目录包含 SKILL.md
技能 ID：每个 SKILL.md frontmatter 中的 name: 字段

为下游仓库编写片段时，应始终以技能 ID（frontmatter 中的 name）引用技能，而不是使用本地文件系统路径。

主要能力与片段模板

该技能提供两类片段模板。

可读版最小片段模板，用于在目标仓库中路由常见任务：

# Agent Guidance: ai-skills

Workflow: skim repo patterns -> use spfx-best-practices by name -> implement smallest-change -> note conflicts.

Routing (invoke by name)
- SPFx: spfx-best-practices

压缩片段模板（Vercel 风格），用于追求最大密度（占用较小的上下文）：

[ai-skills]|flow:{skim repo patterns -> use spfx-best-practices by name -> implement smallest-change -> note conflicts}
|route:
|spfx:{spfx-best-practices}

使用方式

重新生成 README 索引块

如果 README 包含以下标记，生成器可以自动更新该部分：

<!-- BEGIN AI-SKILLS COMPRESSED INDEX -->
...compressed snippet...
<!-- END AI-SKILLS COMPRESSED INDEX -->

运行：

./scripts/generate-skill-index-snippets.sh --update-readme

技能变更后更新片段的步骤

更新 .claude-plugin/plugin.json，以新增或删除技能。
确保每个技能具有正确的 frontmatter name:（供 OpenCode 等使用）。
运行 ./scripts/validate-marketplace.sh。
更新片段路由列表：
- 将新技能加入正确的类别
- 删除已删除的技能
- 保持名称与 frontmatter ID 完全一致
如果维护下游的 AGENTS.md/CLAUDE.md 片段，重新生成并重新复制到依赖仓库。

限制与注意事项

片段应保持精简，它是路由器而非文档。
引用技能时应使用 frontmatter name（技能 ID），不要使用本地文件系统路径。
资料未提供该技能的收费、价格、平台支持范围或效果数据。

技能介绍

用途