Terminal-Native Markdown Task Engine & State Lifecycle

在以终端为单一画布（Single Canvas）与键盘流优先（Keyboard-Centric Flow）的工程工作流中，Markdown 任务管理的核心不在于复杂的图形界面或富文本看板，而在于零摩擦输入捕获（Zero-friction Capture）与确定性状态机循环（Deterministic State Machine Loop）。

依托现代终端编辑器（如 Neovim）与本地双链笔记架构（如 Obsidian 模式），任务追踪被下沉为底层的纯文本状态机驱动，消除开发者在 GUI 看板与编码界面之间的上下文切换损耗。

---

1. 核心架构原理：Smart Action 状态分发与事件分流

传统的纯文本列表操作往往依赖手工编辑 Markdown 符号，带来显著的操作心智负担。终端原生任务引擎通过快捷键（如 <CR> / Enter）的上下文感知（Context-Aware Dispatch），在不同编辑模式下执行分流策略：

flowchart TD
    Trigger["用户键入回车 (Enter / <CR>)"] --> ModeCheck{"当前编辑模式"}
    
    ModeCheck -->|"Normal 模式"| SmartAction["Smart Action 上下文裁决引擎"]
    ModeCheck -->|"Insert 模式"| FormatContinuation["文本引擎自动续行 (formatoptions + comments)"]
    
    SmartAction --> ItemType{"光标所在位置语法节点"}
    ItemType -->|"普通文本段落"| CreateCheck["注入前缀自动升级为任务项: - [ ]"]
    ItemType -->|"无复选框列表项 (- item)"| UpgradeCheck["升级列表项为复选框: - [ ] item"]
    ItemType -->|"任务复选框 (- [x])"| StateRotate["状态机环状轮转 (Next State Transition)"]
    ItemType -->|"维基双链 (Wiki-Link)"| FollowLink["解析索引并跳转关联目标"]
    ItemType -->|"标题或 Frontmatter"| FoldToggle["切换代码/段落折叠 (Fold Toggle)"]
    
    FormatContinuation -->|"已有 - [ ] 行尾回车"| AutoInherit["下一行自动继承任务前缀与缩进"]
    FormatContinuation -->|"连续空行回车"| ClearPrefix["自动清除任务标记并退回基线段落"]

---

2. 五态任务状态机规范 (Checkbox State Machine)

为满足工程开发中的复杂流转，任务复选框采用闭环环状状态机（Finite State Machine, FSM），覆盖从创建、分流、加急到终结的全生命周期：

标记符号	状态定义	语义与流转逻辑	典型应用场景
[ ]	待办 (Todo)	初始任务池，等待认领与排期	每日原子任务清单、未分配 Backlog
[~]	作废 (Cancelled)	经评估后废弃或不再具备可行性	需求变更、无效技术方案、去冗余任务
[!]	紧急 (Urgent/Blocker)	高优先级阻断项，需置顶处理	阻断性 Bug、关键面试/发布里程碑
[>]	顺延 (Rescheduled)	移入后续迭代或交接给第三方	跨日延期事项、依赖外部输入被动挂起
[x]	完成 (Done)	终态验收通过，核销归档	代码合入、单测跑通、任务验收完毕

流转拓扑：[ ] $\to$ [~] $\to$ [!] $\to$ [>] $\to$ [x] $\to$ 回环至 [ ]。
状态机的单键触发机制使得任务核销的认知开销压降至毫秒级，防止传统 TODO 工具因维护成本过高而导致的“任务破窗效应”。

---

3. 关联方法论与工程意义

1. 终端优先心智守恒：
   将任务管理与代码审查（Diffview）、智能体并发监控（Tmux Panes）整合在同一文本空间内，避免离开键盘操作流（terminal-first-agent-development）。
2. 原子化与确定性核销：
   结合 Vibe Coding 规范，长程任务被细拆为单屏可验证的微型 Checkbox 清单，配合 Quickfix 形成渐进式推进防线（synthesis-vibe-coding-master-protocol）。