Project Watcher

- [ ] 分帧流水线（进度：0%）
  - 完成 criterion: 所有视频都能输出帧到 frames/
  - 依赖：无
  - 当前状态：等待素材

需要拆分的条目

• ❌ "做偏好模型" → ✅ 拆成：文献调研、adapter 架构设计、训练数据准备、训练脚本、评估方案
• ❌ "优化性能" → ✅ 拆成：profiling 定位瓶颈、制定优化方案、实施优化、验证效果

拆解由 agent 和商人共同完成，商人确认后再开工。

ROADMAP.md 格式

# [项目名称] Roadmap

## 当前版本 v0.x

### 进行中
- [ ] **功能名称**（进度：30%）
  - 完成标准：...
  - 依赖：功能A
  - 当前状态：正常推进

### 已完成
- [x] ~~已完成功能~~（v0.1）

## 下一步
- 调研方案（待确认）
- 功能B（依赖功能A完成后解锁）

## 技术债务
- 暂无

## 变更记录
- 2026-03-28：新增功能C（需求变更）

C. 项目推进流程（核心）

每次在项目目录推进工作时

触发条件：Agent 在项目目录执行 exec / spawn subagent / 调用工具后

Agent 行为：

1. 执行前：对照 roadmap，确认当前要做的是哪个条目
2. 执行后：判断是否有进展 → 更新对应条目的进度或状态

进度更新判断

更新后主动告知商人

✅ 已推进 [项目] — [条目名称]
  进度：30% → 45%
  做了什么：完成了人像过滤逻辑
  下一步：聚合函数设计

D. 变更同步

触发：项目中出现了 roadmap 没有记载的变化

原则：变更发生后立即更新，不要攒到会话结束。

E. 进度回顾

触发：商人询问 / 每次会话开始时在项目目录工作

Agent 主动报告：

📋 [项目] 进度 — v0.3
  进行中：人像检测回溯（45%）
  下一步：聚合函数设计
  计划外：新增了视频质量评估需求（新增）
  阻塞：等待标注数据

F. 与其他模块的关系

• post-commit hook：通知只负责通知，不触发 roadmap 更新
• roadmap 更新：由 agent 在推进项目时自然完成
• github skill：处理 GitHub Issues → 可作为 roadmap 条目来源

G. 配置

凭证和项目配置见对应文件：

• configs/feishu.json — 飞书凭证（首次使用需填写自己的 app_id 和 app_secret）
• configs/projects.yaml — 项目路径和部署配置（根据需要添加项目）