mcpField
S
skill-compat-matrix

skill-compat-matrix

github.com/wyattowalshAgent 工作流535 次安装8 周前更新
代码仓库

关于 skill-compat-matrix

skill-compat-matrix 用于报告技能元数据和捆绑资源与受支持 harness 的对应情况。它可生成单项或全仓库报告,包括机器可读的 JSON,且不会安装技能或修改 harness 配置。

主要功能

  1. 01单项技能兼容性矩阵
  2. 02全仓库兼容性汇总
  3. 03机器可读的 JSON 输出
  4. 04区分可移植字段与运行时专属字段
  5. 05报告兼容性但不更改配置

适用场景

  1. 01记录技能前检查 harness 兼容性
  2. 02审查仓库技能字段的可移植性
  3. 03生成 JSON 兼容性报告

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/wyattowalsh/agents --skill skill-compat-matrix

安装后在 Claude Code 中输入/skill-compat-matrix确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

evals/
evals.json
scripts/
check.py
compat_matrix.py
scripts/asset_toolkit/
validate_hooks.py

详细介绍

技能兼容性矩阵

总结技能的前置元数据和捆绑资源如何映射到受支持的运行环境。

范围: 仅报告兼容性。不安装技能,也不编辑运行环境配置。

分派

$ARGUMENTS操作
<name>单个技能的矩阵
repo / --all仓库中所有技能的矩阵摘要
--format json机器可读报告
空显示运行环境列表和字段层级

字段层级

层级示例
portable-corename、description、license、metadata
portable-but-variableallowed-tools、脚本、参考资料
runtime-specificuser-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

关键规则

  1. 明确标注未知或尽力而为的运行环境行为。
  2. 切勿将运行环境特定字段视为可移植的安全控制。
  3. 对于可执行内容,矩阵输出应与 skill-creator 安全审计配套使用。
  4. 不要通过此技能修改运行环境投影。
  5. 安装路径说明仅作为文档内容提供,不要将其作为要运行的命令。

评论

支持 Markdown