工作流

工作流1：主动提出计划

用户：我们来做 BTC 监控自动化吧
→ 思考：这是一个持续性任务，需要登记
→ 调用 --add BTC MACD实盘监控自动化 --tag btc_monitor --system --deadline 今天
→ 写监控脚本
→ 设置 cron
→ --done

工作流2：用户交代任务

用户：帮我验证 ETH 回测策略
→ 调用 --add 验证ETH回测策略 --tag research --deadline YYYY-MM-DD
→ 执行
→ --done
→ 告知用户完成

工作流3：晨间检查

会话开场
→ python3 scripts/todo_manager.py --check
→ 输出：
⚠️ 已过期:
[id] A股模拟账户持仓5只 (截止: 昨天)
📅 即将到期:
[id] 策略验证 (截止: 今天)
→ 主动报告给用户

工作流4：任务完成

任务完成后
→ --done
→ 同时更新相关状态文件
→ 告知用户已完成

文件结构

task-memory/
├── SKILL.md ← 本文件
├── scripts/
│ └── todo_manager.py ← 任务管理工具（Python）
└── references/
└── todo.json ← 任务数据库（运行时会创建）

todo.json 结构

json
{
version: 1.0,
updated: 2026-04-01T00:00:00+08:00,
items: [
{
id: c3436d4d,
title: A股模拟账户 - 持仓5只,
created: 2026-04-01T00:00:00+08:00,
deadline: 2026-04-01,
status: pending,
tag: paper_trading,
system: true,
notes: 每只10万，09:25买入,
completed_at: null
}
]
}

字段说明：

• - id: 唯一标识（8位 UUID）
• title: 任务描述
• deadline: ISO 格式截止日期（YYYY-MM-DD）
• status: pending / inprogress / completed / cancelled
• tag: 分类标签（见下表）
• system: true = agent 主动提出，false = 用户交代
• notes: 额外备注
• completedat: 完成时间（自动填充）

标签使用

知识库

详细版本历史、设计决策、已知局限、未来计划：
→ references/CHANGELOG.md

重要规则

1. 1. deadline 格式：必须是 ISO 格式（YYYY-MM-DD），否则 --check 无法识别过期
2. 过期不过期只看 deadline：status 字段不影响过期判断
3. todo.json 路径：默认保存在当前目录 references/todo.json，部署时可调整
4. system 标记：区分agent 主动提出的和用户交代的
5. 承诺即登记：任何计划在告诉用户的同时，必须完成 --add 登记

AGENTS.md 集成

在会话开场规则中加入 Todo 扫描：

markdown

1. 6. Todo 扫描: 运行 python3 scripts/todo_manager.py --check

在 HEARTBEAT.md 中加入心跳检查：

markdown

Todo 过期检查