inbox-update

.omx/specs/deep-interview-scheduled-task-git-sync-gant.md

@@ -0,0 +1,85 @@
+# Spec: Deep Interview — scheduled-task-git-sync-gant
+
+## Metadata
+- **Profile:** Standard
+- **Rounds:** 12
+- **Final Ambiguity:** 0.16
+- **Threshold:** 0.20 (met)
+- **Type:** Brownfield
+- **Context Snapshot:** `.omx/context/scheduled-task-git-sync-gant-20260429T161523Z.md`
+
+## Clarity Breakdown
+
+| Dimension | Weight | Score | Notes |
+|-----------|--------|-------|-------|
+| Intent | 0.25 | 0.85 | InBox notes visible in Gantt chart without manual steps |
+| Outcome | 0.20 | 0.85 | New → added, deleted → removed, existing → de-duplicated |
+| Scope | 0.20 | 0.85 | PARA/InBox git only; "待看" type only; .md files only |
+| Constraints | 0.15 | 0.80 | Win Task Scheduler; gantt-app.exe; toast; abort on conflict; no logs |
+| Success | 0.10 | 0.80 | At 22:30, Gantt shows "待看:xxx" for all InBox .md files |
+| Context | 0.10 | 0.90 | Well-understood repo and tooling |
+| **Weighted** | | **0.84** | Ambiguity = 0.16 |
+
+## Intent
+用户希望每晚 22:30 自动将 InBox 中的待读笔记同步到甘特图软件中，消除手动搬运步骤。
+
+## Desired Outcome
+- 甘特图出现所有 InBox 中 `.md` 文件对应的 "待看:{文件名}" 任务
+- 已存在的不重复添加（更新）
+- InBox 中已删除的文件对应任务也从甘特图中移除
+- Git 自动拉取/提交/推送 PARA/ 和 InBox/ 目录
+
+## In-Scope
+1. 每晚 22:30 通过 Windows Task Scheduler 触发
+2. `git pull && git add PARA/ InBox/ && git commit -m "auto nightly sync" && git push`
+3. 扫描 InBox/*.md，为每个文件在甘特图创建/更新 "待看:{文件名}" 任务
+4. 检测甘特图中已存在的 "待看:xxx" 任务，若 InBox 中对应文件已删除则移除
+5. 去重：已在甘特图中的任务不重复创建，仅更新
+6. 脚本文件与 gantt-app.exe 放在同一目录
+
+## Out-of-Scope / Non-goals
+1. 不操作 PARA/ 和 InBox/ 之外的任何文件
+2. 不创建 "待看" 之外的甘特图任务类型
+3. 不处理非 `.md` 文件
+
+## Decision Boundaries (OMX 可自行决定)
+- 具体用哪个 Windows 通知 API（PowerShell toast / `msg` / 其他）
+- Git commit 消息的具体格式
+- 脚本语言选择（bash / PowerShell / 混合）
+- 甘特图 CLI 的 command/subcommand 细节（从 gant-cli skill 获取）
+
+## Constraints
+- **触发机制:** Windows Task Scheduler（非 Claude session 依赖）
+- **甘特图 CLI:** `gantt-app.exe`
+- **脚本位置:** 与 gantt-app.exe 同目录
+- **Git 冲突:** abort（保留本地）
+- **Push 失败:** Windows 右下角 toast 通知
+- **甘特图未运行:** 静默跳过，次日重试
+- **日志:** 不需要
+- **重名任务:** 更新而非跳过
+- **持久化:** 无 Claude session 依赖（系统级调度）
+
+## Testable Acceptance Criteria
+- [ ] 晚上 22:30，打开甘特图能看到所有 InBox/*.md 对应的 "待看:{文件名}" 任务
+- [ ] 在 InBox 中新增一个 .md 文件 → 下次执行后甘特图出现对应任务
+- [ ] 在 InBox 中删除一个 .md 文件 → 下次执行后甘特图移除对应任务
+- [ ] 非 .md 文件被忽略
+- [ ] PARA/ 和 InBox/ 外文件不受 git 影响
+- [ ] Git 冲突时 abort 不丢数据
+- [ ] 甘特图未运行时脚本不崩溃
+
+## Assumptions Exposed + Resolved
+1. **gantt-app.exe CLI 能力:** 假设支持 add/delete/list 操作 → 实现时通过 gant-cli skill 确认
+2. **Session-only vs durable:** 初始误解为 Claude session 调度 → 澄清为系统级 Windows Task Scheduler
+3. **文件处理后:** 最初未明确 → 澄清为保留文件、双向同步
+
+## Pressure-Pass Findings
+- Round 2 追问了具体格式（"到底长什么样"）→ 从模糊的"处理"收缩到 `待看:{标题}`
+- Round 8 追问了 session-only 假设 → 推翻了 CronCreate 方案，转向系统级 Task Scheduler
+- Round 11 追问了明确的 non-goals → 三条边界锁定
+
+## Handoff Contract
+This spec is the requirements source of truth. Downstream execution must preserve:
+- Intent, non-goals, decision boundaries, and acceptance criteria
+- The bidirectional mirror model (InBox ↔ Gantt)
+- System-level scheduling (not Claude session-dependent)