# Actions

> Action Tracking — Obsidian 原生交互版 (v3)

- Skill: `zzyong24/actions` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add zzyong24/actions`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zzyong24/actions/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zzyong24 (https://skillmd.com/u/zzyong24)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zzyong24/actions

---

# Action Tracking — Obsidian 原生交互版 (v3)

## 概述

行动追踪系统 v3 采用 Obsidian 原生交互模式：

- **一次性待办**：写入 `todos.md`，用户在 Obsidian 中直接点击 checkbox 完成
- **习惯/每日打卡**：通过每日笔记模板 + Heatmap Calendar 热力图可视化
- **MCP 只负责写入**，不负责打卡/完成/查询（交互全在 Obsidian 中）

## 架构

```
AI 反思闭环 → MCP add_action() → 追加到 todos.md
用户打开 Obsidian → 点击 checkbox → 完成 ✅
每日笔记模板 → 习惯 checkbox → Dataview + Heatmap Calendar 可视化
```

## 文件清单

| 文件 | 作用 |
|------|------|
| `vault/space/crafted/actions/todos.md` | 一次性待办（Obsidian Tasks 格式） |
| `vault/space/crafted/actions/habits.md` | 习惯定义 + Dataview 聚合 + 热力图 |
| `vault/space/crafted/actions/daily-template.md` | Templater 日记模板（习惯打卡） |
| `vault/space/crafted/actions/actions.json` | 历史归档（只读，v2 遗留） |

## MCP 工具

| 工具 | 作用 |
|------|------|
| `add_action` | 添加一次性待办到 todos.md |
| `add_habit` | 添加习惯到 habits.md + daily-template.md |
| `list_actions` | 从 todos.md 读取并展示行动列表 |

## 依赖的 Obsidian 插件

| 插件 | 用途 |
|------|------|
| Obsidian Tasks | checkbox 交互、截止日期、重复任务 |
| Dataview | 查询聚合、看板视图、streak 计算 |
| Heatmap Calendar | GitHub 风格热力图可视化 |
| Templater | 每日笔记自动生成习惯打卡清单 |