使用 Markdown 文件管理 7,600 个任务的系统

Source: Dev.to

概述

每个任务对应一个文件夹，文件夹内部包含 index.md 文件。使用 YAML frontmatter 记录元数据，文件夹结构充当分类作用。文件系统本身即充当数据库，无需额外的 DB。

当前 7,655个 任务，完成率 94%，正在运行中。

hq/
├── 公司A/
├── 公司B/
├── 个人/
└── inbox/

任务结构

部署-流程-改进/
└── index.md

frontmatter (YAML)

date: 2026-02-07
estimation: 2h
focus_time: 1h 30m
priority: P1
done: false
recurrence: weekly

正文中自由书写详细内容、备注、产出等。

frontmatter 字段

重复任务命名规则

同名任务出现时在名称后加 ___数字。例如：周会, 周会___2, 周会___3。

Claude Code Skills 集成

通过 Claude Code 的 Skills 系统，将自然语言指令映射为任务操作。

• 开始：在 ~/.focus_session.json 中记录开始时间
• 完成：计算经过时间并累计到 focus_time

专注会话示例

🎯 专注开始!
   任务: index.md
   开始: 2026-02-07T12:24:53

✅ 专注结束!
   任务: index.md
   用时: 56m

同一时间只能有一个会话。

重复任务自动生成

带有 recurrence 字段的任务完成后，会自动生成下一日期的任务。done 初始化为 false，focus_time 置空。

• weekly → +7 天
• daily → +1 天

“今天的任务”脚本示例

说出 "今天的任务" 时，Python 脚本会扫描全部文件。

📅 今天的任务 (2026-02-07)

📋 今天 (2个)
  ⬜ [P1] 博客_写作 (2026-02-07) 🔄
  ⬜ [P1] 代码_评审 (2026-02-07)

⚡ 高优先级未分配 (1个)
  ⬜ [P1] 系统_改进

同时会显示已过期未完成的任务以及没有日期的 P0/P1 任务。

集成对象

系统流程

1. 用户（开始、完成、今天的任务）
2. Claude Code Hook（关键词检测）
3. Skill（执行 Python 脚本）
4. Markdown 文件（更新 frontmatter）
5. Git（版本管理、推送）

任务生命周期

• 创建 → 分配日期/优先级 → 开始专注 → 完成 →（若为重复）自动生成下一个任务