关于 skill-compat-matrix
skill-compat-matrix 用于报告技能元数据和捆绑资源与受支持 harness 的对应情况。它可生成单项或全仓库报告,包括机器可读的 JSON,且不会安装技能或修改 harness 配置。
主要功能
- 01单项技能兼容性矩阵
- 02全仓库兼容性汇总
- 03机器可读的 JSON 输出
- 04区分可移植字段与运行时专属字段
- 05报告兼容性但不更改配置
适用场景
- 01记录技能前检查 harness 兼容性
- 02审查仓库技能字段的可移植性
- 03生成 JSON 兼容性报告
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ wyattowalsh/ agents --skill skill-compat-matrix安装后在 Claude Code 中输入/skill-compat-matrix确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/evals.jsonscripts/check.pycompat_matrix.pyscripts/asset_toolkit/validate_hooks.py详细介绍
技能兼容性矩阵
总结技能的前置元数据和捆绑资源如何映射到受支持的运行环境。
范围: 仅报告兼容性。不安装技能,也不编辑运行环境配置。
分派
| $ARGUMENTS | 操作 |
|---|---|
<name> | 单个技能的矩阵 |
repo / --all | 仓库中所有技能的矩阵摘要 |
--format json | 机器可读报告 |
| 空 | 显示运行环境列表和字段层级 |
字段层级
| 层级 | 示例 |
|---|---|
| portable-core | name、description、license、metadata |
| portable-but-variable | allowed-tools、脚本、参考资料 |
| runtime-specific | user-invocable、hooks、context、paths |
解读结果时,加载 skills/skill-creator/references/runtime-compatibility.md。
工作流
uv run python skills/skill-compat-matrix/scripts/compat_matrix.py <name>
uv run python skills/skill-compat-matrix/scripts/compat_matrix.py --all --format json
验证约定
uv run python skills/skill-compat-matrix/scripts/check.py
关键规则
- 明确标注未知或尽力而为的运行环境行为。
- 切勿将运行环境特定字段视为可移植的安全控制。
- 对于可执行内容,矩阵输出应与 skill-creator 安全审计配套使用。
- 不要通过此技能修改运行环境投影。
- 安装路径说明仅作为文档内容提供,不要将其作为要运行的命令。
评论
支持 Markdown