workflow-tracker

Workflow & Experiment Tracker

自动拆解为 Phase → Task → Experiment 三级结构。识别项目类型后输出对应格式。

触发

检测到以下任一信号即静默记录，不打断用户：

• 看到数字变化（"精度从X变到Y"、"loss降到Z"、"F1从A变到B"）
• 用户口述实验结论（"试了X"/"不行"/"有效"/"放弃"）
• 运行脚本后看到结果输出
• 参数变更（"把A改成B"、"新增了C"）
• 用户说"记录"/"保存"/"更新日志"

不必等到用户说"记录"才行动。在回复中自然地追加一条记录即可。

项目类型识别

首次进入项目时，扫描目录+用户对话，判定类型：

信号	类型	存储
含 tex/、manuscript、figures/、投稿、论文、ablation	论文	CHANGELOG.md + experiment_log.md
含 data/train/、models/、train.py、pipeline、main.py	工程	workflow.json + workflow.md
用户说"部署"/"产品"/"上线"/"API"	工程	workflow.json + workflow.md
无法判断	默认工程	workflow.json + workflow.md

论文模式

直接追加两个 Markdown 文件，不建 JSON：

CHANGELOG.md

按时间线累积。每条格式：

## 2026-06-14 — 简短标题

### 背景
（1-2句说明为什么做这个改动）

### 改动
| 参数 | 旧值 | 新值 | 原因 |
|------|------|------|------|

### 效果
（关键数字变化）

experiment_log.md

每次实验一条，可独立阅读：

## 2026-06-14 — 实验标题

- **假设**: ...
- **方法**: ...
- **参数**: ...
- **结果**: 基线X → 新Y (delta)
- **结论**: SUCCESS / FAILED / PARTIAL
- **备注**: ...

工程模式

维护 .claude/workflow/workflow.json + 自动导出 .claude/workflow/workflow.md。

JSON 最小结构

{
  "project": "项目名",
  "updated": "2026-06-14T14:30",
  "phases": [{
    "name": "Phase 1: XXX",
    "status": "in_progress",
    "tasks": [{
      "name": "Task 1.1: XXX",
      "status": "completed",
      "experiments": [{
        "date": "2026-06-14",
        "title": "实验标题",
        "method": "一句话方法",
        "params": {"old_lr": 0.001, "new_lr": 0.0002},
        "results": {"baseline": 93.75, "new": 94.79, "delta": 1.04},
        "conclusion": "SUCCESS",
        "tags": ["classifier", "svm"]
      }]
    }]
  }]
}

字段说明：

• title/method/results/conclusion 必填，其他可选
• params 用 old_xxx / new_xxx 格式记录变更
• results.delta 统一用 pp（百分点）或绝对值
• tags 至少一个分类标签
• conclusion 取值: SUCCESS | FAILED | PARTIAL | INCONCLUSIVE

workflow.md 自动导出

每次更新 JSON 后同步重写。格式：