关于 skill-sync
用于让 AGENTS.md 的 Auto-invoke 部分与技能元数据保持一致的技能。新增或修改技能时，可用脚本生成或预览指定范围内的更新。
主要功能
- 01读取技能范围和自动调用元数据
- 02生成 Auto-invoke 表格
- 03更新指定范围的 AGENTS.md
- 04通过 dry run 预览变更
适用场景
- 01创建技能后同步 AGENTS.md
- 02修改技能元数据后刷新指引
- 03预览单个范围的更新
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/skill-sync确认已加载。
附带文件assets/sync_test.shassets/sync.sh
详细介绍
用途
保持 AGENTS.md 中的自动调用部分与技能元数据同步。创建或修改技能后，运行同步脚本，自动更新所有受影响的 AGENTS.md 文件。
必需的技能元数据
每个需要出现在自动调用部分的技能都需要在 metadata 中包含以下字段。
auto_invoke 可以是单个字符串或操作列表：
metadata:
author: prowler-cloud
version: "1.0"
scope: [ui] # Which AGENTS.md: ui, api, sdk, root
# Option A: single action
auto_invoke: "Creating/modifying components"
# Option B: multiple actions
# auto_invoke:
# - "Creating/modifying components"
# - "Refactoring component folder placement"
作用域值
| 作用域 | 更新内容 |
|---|---|
root | AGENTS.md（仓库根目录） |
ui | ui/AGENTS.md |
api | api/AGENTS.md |
sdk | prowler/AGENTS.md |
mcp_server | mcp_server/AGENTS.md |
技能可以有多个作用域：scope: [ui, api]
用法
创建或修改技能后
./skills/skill-sync/assets/sync.sh
功能说明
- 读取所有
skills/*/SKILL.md文件 - 提取
metadata.scope和metadata.auto_invoke - 为每个 AGENTS.md 生成自动调用表格
- 更新每个文件中的
### Auto-invoke Skills部分
示例
给定以下技能元数据：
# skills/prowler-ui/SKILL.md
metadata:
author: prowler-cloud
version: "1.0"
scope: [ui]
auto_invoke: "Creating/modifying React components"
同步脚本会在 ui/AGENTS.md 中生成：
### Auto-invoke Skills
When performing these actions, ALWAYS invoke the corresponding skill FIRST:
| Action | Skill |
|--------|-------|
| Creating/modifying React components | `prowler-ui` |
命令
# Sync all AGENTS.md files
./skills/skill-sync/assets/sync.sh
# Dry run (show what would change)
./skills/skill-sync/assets/sync.sh --dry-run
# Sync specific scope only
./skills/skill-sync/assets/sync.sh --scope ui
修改技能后的检查清单
- 为新建或修改的技能添加
metadata.scope - 添加带有操作描述的
metadata.auto_invoke - 运行
./skills/skill-sync/assets/sync.sh - 确认 AGENTS.md 文件已正确更新
评论
支持 Markdown