Agent Skills › jazzyalex/agent-sessions › agent-support-matrix

agent-support-matrix

GitHub

维护Agent会话格式兼容性矩阵，通过运行检测脚本和收集证据来验证上游版本变更，确保解析器测试通过后方可更新最大支持版本及文档。

skills/agent-support-matrix/SKILL.md jazzyalex/agent-sessions

触发场景

检查上游Agent发布版的会话格式变更更新agent-support-matrix.yml中的最大已验证版本修复JSON/JSONL解析兼容性问题

安装

npx skills add jazzyalex/agent-sessions --skill agent-support-matrix -g -y

更多选项

不安装直接使用

npx skills use jazzyalex/agent-sessions@agent-support-matrix

指定 Agent (Claude Code)

npx skills add jazzyalex/agent-sessions --skill agent-support-matrix -a claude-code -g -y

安装 repo 全部 skill

npx skills add jazzyalex/agent-sessions --all -g -y

预览 repo 内 skill

npx skills add jazzyalex/agent-sessions --list

SKILL.md

Frontmatter

{
    "name": "agent-support-matrix",
    "description": "Maintain Agent Sessions agent support matrix and JSON\/JSONL parsing compatibility. Use when checking upstream agent releases for session format changes, updating max verified versions in docs\/agent-support\/agent-support-matrix.yml, or updating docs\/agent-json-tracking.md and fixtures\/tests."
}

Agent Support Matrix

Overview

Keep the support matrix and memory bank accurate, and gate updates with evidence so parsing regressions are avoided.

Quick Start

Read docs/agent-support/workflow.md.
Run the session-format check and read results.<agent>.compatibility.
Compare latest available agent versions to docs/agent-support/agent-support-matrix.yml.
If gaps exist, run an impact scan, collect evidence, and update fixtures/tests before bumping max_verified_version.

Workflow

Determine the current Agent Sessions version from AgentSessions.xcodeproj/project.pbxproj MARKETING_VERSION.
Run ./scripts/agent_watch.py --mode weekly and use compatibility.verdict as the support answer. severity and recommendation are legacy escalation fields, not support claims.
Use references/impact-scan.md to inspect upstream releases for format changes.
Follow references/update-checklist.md before updating docs or fixtures.

Guardrails

Do not bump max_verified_version without fixtures or sample logs plus passing parser tests.
Do not bump max_verified_version unless results.<agent>.compatibility.verdict is supports_latest, or the update explicitly records a narrower scope such as supports_installed_only with a blocker and follow-up.
If an agent does not log a version, keep max_verified_version: "unknown" and document verification scope in docs/agent-json-tracking.md.

References

references/matrix-schema.md for matrix fields and update rules.
references/impact-scan.md for format change detection heuristics.
references/update-checklist.md for the evidence checklist.

Related Skills

agent-session-format-check — detection and evidence collection for session format drift, usage/limits tracking changes, OpenCode storage backend shifts, and discovery path contract failures. Use that skill for monitoring and diagnosis; use this skill for recording and gating version bumps.