用途:对已完成的 Claude Code 会话进行事后分析,验证技能实际行为是否符合 SKILL.md 规范。需要两个必填参数:sessionId(会话 UUID)和 targetSkill(对照的 SKILL.md 路径),可选 additionalRequirements 补充校验标准。
主要能力:一是解析目标 SKILL.md,从 YAML frontmatter 提取预期 hooks(PreToolUse、PostToolUse、Stop、SubagentStop)与 allowed-tools,从正文提取 SubAgents、Skill 调用、产物路径与工作流步骤,构建预期行为清单;二是分析调试日志,提取子代理调用、Hook 事件、工具调用与 Hook 结果;三是核验产物文件的创建与删除;四是生成预期与实际对照表,标记缺失调用、顺序错误、Hook 失败、缺失产物等偏差,最终给出 PASS 或 FAIL。
使用方式:会话文件位于 ~/.claude/ 下,主日志为 ~/.claude/projects/-{encoded-cwd}/{sessionId}.jsonl,调试日志为 ~/.claude/debug/{sessionId}.txt,子代理记录为 agent-{agentId}.jsonl。通过脚本执行:${baseDir}/scripts/find-session-files.sh {sessionId}、${baseDir}/scripts/extract-subagent-calls.sh {debug-log-path}、${baseDir}/scripts/extract-hook-events.sh {debug-log-path}。报告包含会话信息、预期行为、子代理/Hook 验证表、产物验证表、问题清单与总体结论。
适用场景:排查技能未按预期调用子代理或 Hook、产物未生成或未清理、流程顺序异常等。
限制:若调试日志缺失,分析将受限;依赖 ~/.claude/ 中日志的存在与格式;详细错误码、收费、平台支持等信息暂未提供。