shinka-inspect

Shinka Inspect Skill

从 Shinka 运行中提取最优秀的程序，并将其打包到编码 Agent 可直接加载的上下文文件中。

适用场景

在以下情况下使用此技能：

• 运行已生成结果目录和 SQLite 数据库
• 启动下一批任务前，想检查表现最佳的程序
• 想要一份精简的上下文文件，而不是手动浏览数据库

在以下情况下不要使用此技能：

• 仍需搭建任务脚手架（shinka-setup）
• 需要运行进化批次（shinka-run）

功能

• 使用 shinka.utils.load_programs_to_df 读取程序记录
• 按 combined_score 对程序排序
• 选出排名前 k 的正确程序（如果没有正确记录，则回退为整体排名前 k 的程序）
• 生成一个 Markdown 文件包，其中包含元数据、排名表、反馈和代码片段

工作流

1. 确认运行产物已存在

ls -la <results_dir>

2. 生成上下文文件包

python skills/shinka-inspect/scripts/inspect_best_programs.py \
  --results-dir <results_dir> \
  --k 5

3. 可选调节项

python skills/shinka-inspect/scripts/inspect_best_programs.py \
  --results-dir <results_dir> \
  --k 8 \
  --max-code-chars 5000 \
  --min-generation 10 \
  --out <results_dir>/inspect/top_programs.md

4. 将输出加载到 Agent 上下文中

• 默认输出路径：<results_dir>/shinka_inspect_context.md
• 将其用作规划下一步变更的上下文文件

CLI 参数

• --results-dir：运行目录路径（或直接指定 DB 文件路径）
• --k：要包含的程序数量（默认值为 5）
• --out：输出 Markdown 路径（默认位于结果目录下）
• --max-code-chars：每个程序的代码截断上限（默认值为 4000）
• --min-generation：可选的代数下限
• --include-feedback / --no-include-feedback：是否包含 text_feedback 块

备注

• 排名指标为 combined_score。
• 如果没有正确记录，脚本会回退到得分最高的记录，并在输出中标注回退情况。
• 脚本只读运行产物（仅写入 Markdown 文件包）。