AgentSkillsCN

ssot-backfill

SSOT 文档回填流程 — 确保实验结果正确写入权威文档

中文原作
SKILL.md
--- frontmatter
name: ssot-backfill
description: SSOT 文档回填流程 — 确保实验结果正确写入权威文档

SSOT Backfill Skill

当实验审核通过后,需要将结果回填到 SSOT (Single Source of Truth) 文档时使用。

触发条件

  • 审核报告结论为"通过"或"有条件通过"
  • 分析报告末尾有 SSOT 回填清单

前置检查 (A 模式约束)

开始回填前必须确认:

  1. ✅ 实施 Agent 无未 commit 的文档修改(向用户确认)
  2. ✅ 明确声明将要修改的文件清单
  3. ✅ 审核报告中的数值已验证正确

回填目标文档

按以下顺序逐个更新:

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 ProgressCompleted
  • 如果是新实验,按格式追加记录:
    • 实验 ID、日期、Split、目标
    • 搜索空间/参数
    • 最优结果 + 二优结果
    • 产物路径

4. docs/dapi_detection_design.md — 检测参数 SSOT (如适用)

操作 (仅检测相关实验):

  • 更新参数锁定状态 (如: "val 重调待执行" → "val 已完成,最优 edge_margin=20")
  • 将封板参数写入锁定值表
  • 更新相关章节状态

回填后

  1. 通知用户: "SSOT 回填完成,以下 N 个文件已更新: [列表]"
  2. 建议用户通知实施 Agent git pull
  3. 如有 docs/temp_reviews/ 里的审核报告已合并进 SSOT → 可标记为可删

常见错误防范

错误防范
声称回填但实际没改文件每个文件用 grep 验证关键词是否写入
数值与实验结果 JSON 不一致回填前重新读取 JSON 确认
漏改某个文档严格按 4 文档清单逐个执行
并发冲突回填前确认 A 模式前置条件