用途:分析编码智能体会话记录,据此改进已有技能或创建新技能,支持 Claude Code、Pi、Codex 三种智能体的会话文件。
主要能力:提供 extract-session.cjs 脚本,可自动检测智能体并提取当前会话,也可指定 --agent claude|pi|codex、--cwd 工作目录或直接传入具体会话文件。会话文件位置:Claude Code 为 ~/.claude/projects/<encoded-cwd>/.jsonl,Pi 为 ~/.pi/agent/sessions/<encoded-cwd>/.jsonl,Codex 为 ~/.codex/sessions/YYYY/MM/DD/*.jsonl。
使用方式:改进已有技能时,先运行 ./scripts/extract-session.cjs > /tmp/session-transcript.txt 提取记录,在 ~/.codex/skills/<skill-name>/SKILL.md、~/.claude/skills/<skill-name>/SKILL.md 或 ~/.pi/agent/skills/<skill-name>/SKILL.md 中找到技能,再按提供的提示词模板把技能路径与会话记录粘贴到新会话中,让新会话分析使用困难、缺失信息、缺失示例等问题并改写原技能。创建新技能时同样先提取记录,再用创建提示词模板,要求提取核心工作流、关键命令与模式、常见陷阱和典型示例,写入 ~/.codex/skills/<skill-name>/SKILL.md,采用 YAML front matter 加各能力分节格式。
建议使用单独会话:可节省 token、让分析不受当前任务干扰,并保证提示词自包含、可复用。分析时重点关注困惑重试点、缺失示例、临时变通、错误及解决方式、成功模式,并保持技能简洁。
限制:资料未提供脚本的实现细节、依赖环境、错误处理、支持的会话格式版本及许可证等信息。