SKILL.md — project-watcher
项目规划与进度追踪。维护 roadmap，让每个行动都能对应到规划条目。
核心原则
- 规划先行：新项目必须先有 roadmap 再开工，没有规划就开工是无效推进
- 条目可追踪：每个 roadmap 条目必须能回答"怎么算完成了"
- 进度有感知：推进项目后主动更新 roadmap，不等待商人询问
- 变更即更新：计划外的事项立即入 roadmap，不搁置
A. 项目初始化
触发：在非 workspace 根目录检测到 .git（首次进入项目目录工作）
流程：
- 询问商人项目目标和技术栈
- 和商人一起拆解 roadmap（参考"拆解标准"）
- 创建
project.md和ROADMAP.md
B. Roadmap 条目设计规范
可接受的条目
- [ ] 分帧流水线（进度：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 行为：
- 执行前：对照 roadmap，确认当前要做的是哪个条目
- 执行后：判断是否有进展 → 更新对应条目的进度或状态
进度更新判断
| 情况 | 操作 |
|---|---|
| 条目完成 | [ ] → [x]，进度标 100%，移至已完成区 |
| 部分进展 | 更新进度 %，注明做了什么 |
| 遇到障碍 | 更新"当前状态"，告知商人卡点 |
| 发现新需求 | 新增条目，标注"计划外" |
| 依赖变更 | 更新依赖关系，告知商人 |
更新后主动告知商人
✅ 已推进 [项目] — [条目名称]
进度：30% → 45%
做了什么：完成了人像过滤逻辑
下一步：聚合函数设计
D. 变更同步
触发：项目中出现了 roadmap 没有记载的变化
| 变化类型 | 处理 |
|---|---|
| 需求变更（商人提出） | 立即更新 roadmap，标注变更原因和日期 |
| 技术方案调整 | 更新条目描述，说明原因 |
| 发现新任务 | 新增条目，初始进度 0% |
| 某条目取消 | 移到"变更记录"，注明取消原因 |
原则：变更发生后立即更新，不要攒到会话结束。
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— 项目路径和部署配置（根据需要添加项目）