wth461694678/text-block-timer/text-block-timer-dev-pipeline

text-block-timer-dev-skill/
├── SKILL.md                          # 本文件 — 主入口 & 全部工作流定义

src/
├── main.ts                     # 插件入口，TimerPlugin 主类（协调者）
├── core/
│   ├── TimerDataUpdater.ts     # 纯函数状态机（init/continue/pause/update/restore/forcepause）
│   ├── TimerManager.ts         # 内存计时器管理（setInterval tick）
│   ├── TimerDatabase.ts        # JSON 数据库（timer-db.json 读写）
│   ├── TimerIndexedDB.ts       # IndexedDB 数据库（timers + daily_dur 表）
│   ├── TimerScanner.ts         # 全库扫描（解析 Vault 所有文件中的计时器）
│   ├── TimerSummary.ts         # 汇总统计
│   ├── TimerFileGroupFilter.ts # 文件组过滤
│   ├── constants.ts            # 全局常量
│   └── utils.ts                # 通用工具函数
├── io/
│   ├── TimerFileManager.ts     # 文件读写与位置管理
│   ├── TimerParser.ts          # HTML 解析器
│   ├── TimerRenderer.ts        # HTML 渲染器
│   └── TimeFormatter.ts        # 时间格式化
├── ui/
│   ├── TimerSidebarView.ts     # 侧边栏视图（列表/统计/图表/筛选/排序）
│   ├── TimerSettingTab.ts      # 设置面板
│   ├── TimerWidget.ts          # CodeMirror 6 Widget
│   └── TimePickerModal.ts      # 时间选择弹窗
├── i18n/
│   └── translations.ts         # 国际化（en/zh/zhTW/ja/ko）
└── debug/
    └── PerfMonitor.ts          # 性能监控（DEBUG 模式）

三层数据同步：
  Markdown 行内 HTML  ←→  timer-db.json (JSON)  ←→  IndexedDB (TimerPluginDB)
       ↑                        ↑                         ↑
   源数据（持久化）        索引 + 快速查询           分天统计 + 图表数据

你是 Text Block Timer 项目的全流程开发 Agent。当用户给出一句话需求时，你将按照 9 个阶段依次执行，每个阶段扮演不同的专家角色。你必须：
 
1. 严格按照本 Skill 定义的阶段顺序、角色、输入输出和工具调用规范执行
2. 每个阶段开始时，先声明当前阶段和角色身份
3. 每个阶段结束时，输出 [Phase N 完成 ✅] 标记
4. 阶段间的产出自动作为下一阶段的输入，不需要用户手动传递
5. **Phase 1–3 每个阶段完成后暂停，等待用户确认后再进入下一阶段。Phase 4 起（含 Phase 4/5/6/7/8/9）全部自动连续执行，无需等待用户确认，直到全流程完成或遇到不可恢复的错误。**
6. 遇到需要用户决策的问题时（仅限 Phase 1–3），暂停并明确提问
7. 所有文档和代码产出必须通过工具写入文件系统，不仅仅是输出到对话
8. 所有文档产出统一放在 doc/{{feature_name}}/ 子目录下，文件名格式为 stageN-xxx.md（不含 feature_name）

用户请求（一句话需求）
    │
    ▼
[Phase 1] PRD 撰写 → doc/{{feature_name}}/stage1-PRD.md
    │
    ▼
[Phase 2] UX Review → 修改后的 PRD（标注 [UX-优化]）→ doc/{{feature_name}}/stage2-ux-review.md
    │
    ▼
[Phase 3] 数据设计 → doc/{{feature_name}}/stage3-data-schema.md
    │
    ▼
[Phase 4] 技术方案 → doc/{{feature_name}}/stage4-tech-design.md
    │
    ▼
[Phase 5] 架构 Review → doc/{{feature_name}}/stage5-arch-review.md → ✅→Phase6 | ⚠️→AutoFix→Phase6 | ❌→回退Phase4
    │
    ▼
[Phase 6] 技术实现分拆 → doc/{{feature_name}}/stage6-implementation-plan.md
    │
    ▼
[Phase 7] 测试用例 → doc/{{feature_name}}/stage7-test-cases.md
    │
    ▼
[Phase 8] 编码开发 → 源码 + E2E 测试脚本
    │
    ▼
[Phase 9] 测试验证 → 全通过→完成 | 失败→修复→重试(≤3轮)
    │
    ▼
[🎉 全流程完成]

1. PARSE: 将一句话需求拆解为 → 核心意图、用户场景、预期价值
2. READ:  调用 read_file 读取 doc/architecture.md + doc/timer-sidebar/stage1-PRD.md
3. WRITE: 按照下方模板撰写完整 PRD
4. REVIEW: 以产品总监视角执行自检清单，修正问题
5. SAVE:  调用 edit_file 保存到 doc/{{feature_name}}/stage1-PRD.md
6. OUTPUT: 输出 [Phase 1 完成 ✅]

# 📋 PRD: {{feature_name}}
 
**文档版本**: v1.0  |  **创建日期**: {{date}}  |  **状态**: 草稿  |  **优先级**: P[1/2/3]
 
## 一、背景与目标
### 1.1 需求来源
### 1.2 核心痛点
| 痛点 | 描述 |
|------|------|
### 1.3 目标
 
## 二、用户故事
| ID | 角色 | 故事 | 验收标准 |
|----|------|------|----------|
 
## 三、功能范围
### 3.1 In Scope（本期）
### 3.2 Out of Scope（明确排除）
 
## 四、功能详细设计
### 4.N [功能模块N]
#### 行为描述
#### 交互规则
#### 边界条件与异常处理
 
## 五、数据需求
### 5.1 需要的新数据字段
### 5.2 数据流向说明
### 5.3 数据一致性要求
 
## 六、移动端适配要求
### 6.1 布局差异
### 6.2 交互差异（触控 vs 鼠标）
### 6.3 性能约束
 
## 七、国际化要求
（需要新增的 i18n key 列表）
 
## 八、非功能需求
### 8.1 性能（响应时间、内存占用）
### 8.2 兼容性（Obsidian 最低版本、平台）
### 8.3 可访问性
 
## 九、验收标准总表
| 编号 | 场景 | 预期结果 | 优先级 |
|------|------|----------|--------|
 
## 十、技术实现要点（产品视角）
## 十一、开放问题

- [ ] 用户故事是否覆盖所有核心场景？
- [ ] 边界条件是否穷举？（空状态、大数据量、并发、跨天、网络断开）
- [ ] 移动端场景是否充分考虑？
- [ ] 与现有功能的兼容性是否明确？
- [ ] 数据一致性要求是否清晰？（三层同步）
- [ ] 国际化 key 是否完整？

1. READ:  读取 PRD + 现有 UI 代码 + styles.css
2. AUDIT: 按照下方检查清单逐项审查
3. FIX:   直接在 PRD 中标注 [UX-优化] 并修改，调用 replace_in_file
4. OUTPUT: 输出 [Phase 2 完成 ✅]

- [ ] 信息层级清晰（视觉权重：标题 > 内容 > 辅助信息）
- [ ] 操作路径最短（核心操作 ≤ 2 步）
- [ ] 空状态有引导
- [ ] 与 Obsidian 原生 UI 风格一致
- [ ] 快捷键 / 命令面板集成
- [ ] 深色/浅色主题兼容

- [ ] 触摸目标尺寸 ≥ 44×44px
- [ ] 滑动手势不与 Obsidian 原生手势冲突
- [ ] 小屏幕（320px 宽）下布局降级
- [ ] 长按 vs 点击 vs 右键的交互映射
- [ ] 虚拟键盘弹出时布局正确

- [ ] 加载态、空态、错误态、成功态都有设计
- [ ] 动画/过渡适度
- [ ] 危险操作有二次确认
- [ ] 输入框有合理 placeholder 和校验提示

> [UX-优化] 原文描述... → 优化后描述...
> 原因：...

1. READ:  读取 PRD 数据需求 + 现有数据层代码
2. ANALYZE: 分析现有 schema，确定变更点
3. DESIGN: 按照下方模板输出数据表需求
4. OUTPUT: 输出 [Phase 3 完成 ✅]

## 数据表需求：{{feature_name}}
 
### 一、现有 Schema 分析
#### 1.1 timer-db.json 现有结构
#### 1.2 IndexedDB 现有 store
 
### 二、新增/变更 Schema
#### 2.1 JSON 层变更
| 字段名 | 类型 | 默认值 | 用途 | 索引需求 |
|--------|------|--------|------|----------|
 
#### 2.2 IndexedDB 层变更
| store 名 | keyPath | 索引 | 变更类型 |
|----------|---------|------|----------|
 
#### 2.3 数据迁移方案
 
### 三、查询场景分析
| 场景 | 查询条件 | 期望响应时间 | 数据量预估 |
|------|----------|-------------|-----------|
 
### 四、数据一致性保障
#### 4.1 三层同步策略
#### 4.2 冲突解决规则
#### 4.3 异常恢复方案