大模型应用
事后分析 Claude Code…
当需要验证某个已完成的 Claude Code 会话中技能、子代理、钩子和产物是否按 SKILL.md 预期执行时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
事后分析 Claude Code 会话日特定
解决思路
- 收集输入参数:必需的 sessionId(会话 UUID)、targetSkill(用于校验的 SKILL.md 路径),以及可选的 additionalRequirements(额外校验标准)。
- 定位会话文件:主会话日志位于 ~/.claude/projects/-{encoded-cwd}/{sessionId}.jsonl,调试日志位于 ~/.claude/debug/{sessionId}.txt,子代理记录位于 ~/.claude/projects/-{encoded-cwd}/agent-{agentId}.jsonl;可运行 ${baseDir}/scripts/find-session-files.sh {sessionId} 来定位。
- 在继续分析前确认所有必需文件存在;若调试日志缺失,则说明分析结果将受限。
- 解析目标 SKILL.md 的 YAML frontmatter,提取 hooks.PreToolUse、hooks.PostToolUse、hooks.Stop、hooks.SubagentStop 以及 allowed-tools。
- 解析 SKILL.md 的 Markdown 正文,识别其中提到的 SubAgents(Task(subagent_type="..."))、调用的 Skills(Skill("..."))、创建的产物(如 .dev-flow/drafts/、.dev-flow/plans/)以及工作流步骤与条件。
- 根据 SKILL.md 分析结果构建预期行为检查清单,覆盖 SubAgents、Hooks、Artifacts、Workflow 四类条目。
- 在调试日志中搜索 SubagentStart with query: {agent-name} 与 SubagentStop with query: {agent-id} 以提取子代理调用,可运行 ${baseDir}/scripts/extract-subagent-calls.sh {debug-log-path}。
- 在调试日志中搜索钩子事件模式(如 Getting matching hook commands for {HookEvent} with query: {tool-name}、Matched {N} unique hooks、Hooks: Processing prompt hook、Hooks: Prompt hook condition was met/not met、permissionDecision: allow/deny),可运行 ${baseDir}/scripts/extract-hook-events.sh {debug-log-path}。
- 在调试日志中搜索工具调用模式(如 executePreToolHooks called for tool: {tool-name}、File {path} written atomically)。
- 对基于 prompt 的钩子,查找模型响应 Hooks: Model response: { "ok": true/false, "reason": "..." }。
- 验证产物创建:对每个预期产物,在调试日志中搜索 FileHistory: Tracked file modification for {path} 与 File {path} written atomically,并核对当前文件系统状态。
- 验证产物删除:对应当删除的文件,在 Bash 调用中搜索 rm 命令,并确认文件已不在文件系统中。
- 构建预期与实际对比表,逐项列出 Component、Expected、Actual、Status。
- 标记所有偏差:缺失的组件调用、操作顺序错误、钩子失败、缺失产物、意外错误。
- 按报告模板生成报告,包含会话信息、预期行为、SubAgent/Hook 校验表、产物校验表、问题/缺陷表以及总体结论(PASS/FAIL)与 1-2 句总结。
适用边界 · 注意事项
- 会话仍在进行中或尚未完成时,无法进行事后分析。
- 调试日志缺失时分析能力受限,无法完整验证钩子与子代理行为。
- 没有可对照的 SKILL.md 规范时,无法构建预期行为检查清单。