empiricalwiki: Skill for Claude Code

/refine

通用多轮迭代改进循环，适用于任何研究制品（idea、proposal、experiment plan、paper draft）。 每轮调用 /review 获取结构化反馈 → 解析 actionable items → Claude 修复制品 → 更新 wiki 实体 → 重新 /review，直到评分达到目标分数或达到最大轮次。 输出改进历史和最终 review 评分。

Inputs

• artifact：要改进的制品，以下之一：
  • wiki 页面的 slug（从 ideas/experiments/claims/outputs/ 中查找）
  • 文件路径（如 wiki/outputs/paper-draft-v1.md）
• --max-rounds N（可选，默认 4）：最大迭代轮次
• --target-score N（可选，默认 8）：目标 review 评分（1-10），达到后停止
• --difficulty（可选，默认 hard）：传递给 /review 的难度级别
• --focus（可选）：传递给 /review 的审查焦点

Outputs

• 改进后的 artifact（wiki 页面或文件，原地更新）
• wiki 实体更新（若 review 发现 claim 需加强或 gap 被识别）
• REFINE_REPORT（输出到终端）：
  • 每轮的评分变化轨迹
  • 累计修复的 issues 列表
  • 最终 review 评分和 verdict
  • 未解决的 issues（若有）

Wiki Interaction

Reads

• wiki/ideas/*.md — 若 artifact 是 idea
• wiki/experiments/*.md — 若 artifact 是 experiment plan
• wiki/claims/*.md — review 引用的 claims
• wiki/papers/*.md — review 引用的 papers
• wiki/outputs/*.md — 若 artifact 是 paper draft 或 output
• wiki/graph/context_brief.md — 传递给 /review 的全局上下文
• wiki/graph/open_questions.md — 检查是否有新 gap 需要记录

Writes

• wiki/ideas/{slug}.md — 若 artifact 是 idea，修复 review 发现的问题
• wiki/experiments/{slug}.md — 若 artifact 是 experiment plan
• wiki/claims/{slug}.md — 若 review 发现 claim 需要更新（confidence 调整、evidence 补充说明）
• wiki/outputs/*.md — 若 artifact 是 paper draft 或 output
• wiki/graph/edges.jsonl — 若修复过程中发现新关系
• wiki/graph/context_brief.md — 每轮结束后重建（若 wiki 有变更）
• wiki/graph/open_questions.md — 每轮结束后重建（若 wiki 有变更）
• wiki/log.md — 追加操作日志

Graph edges created

• 视修复内容而定，可能添加：supports、addresses_gap、inspired_by 等

Workflow

前置：确认工作目录为 wiki 项目根（包含 wiki/、raw/、tools/ 的目录）。

Step 1: 初始化

1. 定位 artifact：
   • 若为 slug：按顺序在 wiki/ideas/、wiki/experiments/、wiki/claims/、wiki/outputs/、wiki/papers/ 中查找 {slug}.md
   • 若为文件路径：直接读取
   • 记录 artifact 类型和路径
2. 读取当前内容：加载 artifact 完整文本
3. 初始化追踪变量：
   • round = 0
   • score_history = []
   • fixed_issues = []
   • unresolved_issues = []
   • wiki_changes = []