SSOT Backfill Skill
当实验审核通过后,需要将结果回填到 SSOT (Single Source of Truth) 文档时使用。
触发条件
- •审核报告结论为"通过"或"有条件通过"
- •分析报告末尾有 SSOT 回填清单
前置检查 (A 模式约束)
开始回填前必须确认:
- •✅ 实施 Agent 无未 commit 的文档修改(向用户确认)
- •✅ 明确声明将要修改的文件清单
- •✅ 审核报告中的数值已验证正确
回填目标文档
按以下顺序逐个更新:
1. claude.md — 项目状态仪表板
更新位置: Phase 进度清单 (通常 L280+)
操作:
- •将对应 Step 从
[/]或[ ]改为[x] - •追加一行结果摘要 (如:
已完成: test(73) DAPI F1=0.8033) - •如有新关键指标,更新仪表板数值
示例:
markdown
- [x] **Step 4.5: 检测参数锁定 (DAPI/Adaptive)**
已完成: test(73) 单次封板完成,DAPI F1=0.8033 > Adaptive F1=0.7502
2. docs/task_backlog.md — 任务勾选
操作:
- •将对应任务标题追加
✅ Completed (YYYY-MM-DD) - •勾选所有完成标准
[x] - •追加
- 结果:字段写入关键数值
3. docs/experiments_log.md — 实验流水账
操作:
- •更新实验状态从
In Progress→Completed - •如果是新实验,按格式追加记录:
- •实验 ID、日期、Split、目标
- •搜索空间/参数
- •最优结果 + 二优结果
- •产物路径
4. docs/dapi_detection_design.md — 检测参数 SSOT (如适用)
操作 (仅检测相关实验):
- •更新参数锁定状态 (如: "val 重调待执行" → "val 已完成,最优 edge_margin=20")
- •将封板参数写入锁定值表
- •更新相关章节状态
回填后
- •通知用户: "SSOT 回填完成,以下 N 个文件已更新: [列表]"
- •建议用户通知实施 Agent
git pull - •如有
docs/temp_reviews/里的审核报告已合并进 SSOT → 可标记为可删
常见错误防范
| 错误 | 防范 |
|---|---|
| 声称回填但实际没改文件 | 每个文件用 grep 验证关键词是否写入 |
| 数值与实验结果 JSON 不一致 | 回填前重新读取 JSON 确认 |
| 漏改某个文档 | 严格按 4 文档清单逐个执行 |
| 并发冲突 | 回填前确认 A 模式前置条件 |