Smart Tasks

Smart Tasks

Manage tasks as markdown files in tasks/ with an 索引.md summary. Minimize 上下文 usage: read 索引.md first, individual files only when needed.

设置up

运行 the init script once to 创建 the directory structure:

bash 技能s/smart-tasks/scripts/init-tasks.sh

This 创建s tasks/, tasks/active/, tasks/done/, tasks/归档/, tasks/索引.md, and tasks/.meta.json. Idempotent — safe to re-运行.

After init, 应用ly workspace integration changes from workspace-integration.md with user 应用roval.

File Structure Overview tasks/索引.md — active task summary table (~1-2KB). Read every 会话. tasks/.meta.json — 追踪s nextId counter and known categories. tasks/active/ — individual task files (one per task). tasks/done/ — completed tasks (kept 30 days). tasks/归档/YYYY-QN/ — long-term storage.

For full 格式化 specs see file-structure.md.

Core 工作流

• 检测 Task Intent

When the user mentions deadlines, todos, or things to do in conversation, propose creating a task. No special commands needed — use natural language.

Examples of triggers:

"다음 주 금요일까지 리뷰 완료해야 해" "논문 피드백 보내야 하는데" "이번 주 할일 뭐 있어?"

• 创建 a Task

Read tasks/.meta.json to 获取 nextId. 生成 ID: T-{nextId} zero-p添加ed to 3 digits (e.g., T-001). 创建 slug from title (kebab-case English summary). Write task file to tasks/active/{ID}_{slug}.md using the 格式化 in task-格式化.md. Fill the 代理 Notes section with relevant workspace 上下文 (related files, people, timeline analysis). Increment nextId in .meta.json. 添加 new category if not already 列出ed. 更新 tasks/索引.md — insert row in the correct section.

• 更新 a Task

Identify the task by ID or title 搜索 in 索引.md. Read the individual task file from tasks/active/. 应用ly changes to 机器人h the task file and 索引.md. 应用end a timestamped entry to the task's 메모/진행 기록 section.

• Complete a Task

设置 状态: done and completed: {today} in the task file. Move file from tasks/active/ to tasks/done/. 移除 the row from 索引.md. (Do NOT 添加 to done section in 索引.) Confirm completion to the user.

• 查询 Tasks

Quick overview: Read 索引.md only. Answer from the table. DetAIl needed: Read the specific task file(s) from tasks/active/. "What should I do?": Analyze 索引.md by deadline × priority × estimated hours. Recommend a sequence with reasoning.

• 删除 a Task

Only when explicitly 请求ed. Move to tasks/done/ with 状态: cancelled rather than deleting the file. 移除 from 索引.md.

索引.md Management

索引.md is the single-read entry point for task awareness.

Structure # Tasks 索引

Last 更新d: YYYY-MM-DD
Active: N | Overdue: N | Due this week: N

🔴 Overdue

ID	Title	Due	Priority	Category

🟡 Due This Week

ID	Title	Due	Priority	Category

📋 Later

ID	Title	Due	Priority	Category

📊 Summary

更新 Rules 更新 索引.md on every task 创建 / 更新 / complete / 删除. Recalculate header counters (Active, Overdue, Due this week) each 更新. Keep rows 排序ed by due date within each section. Reclassify rows between sections based on current date. 设置 Last 更新d to today. Size Control Active tasks ~Size Action 1–20 ~1KB Keep as-is 20–50 ~2.5KB Abbreviate Later section (title + due only) 50+ ~5KB+ Split into category 索引es (索引-{category}.md) 上下文 Strategy

Read 上下文-strategy.md for detAIls on:

Layered reading pattern (索引 → active file → done/归档) Sub代理 cost optimization for cron jobs When to read vs. skip individual files

Key rule: If 索引.md alone can answer the question, do NOT read individual files.

Cron Jobs

设置 up scheduled briefings and alerts. All cron jobs use Sonnet-class 模型s. See cron-templates.md for:

DAIly morning briefing (08:00) — overdue alerts + today's priorities Deadline 检查 (12:00, 18:00) — D-0/D-1/overdue only, silent if none Weekly review (Sunday 20:00) — completion summary, stale task 检测ion, 归档 清理up (done/ 30+ days → 归档/) Automatic 清理up Transition Trigger Action active → done User marks complete Move file, 更新 索引 done → 归档 30 days elapsed Weekly review moves to 归档/YYYY-QN/ 归档 — Never in 索引. 访问 only via 搜索. Task File 格式化

Each task is a markdown file with YAML frontmatter. See task-格式化.md for:

Complete frontmatter 模式 Section template 2-3 example tasks Workspace Integration

This 技能 does NOT modify files outside its own directory. See workspace-integration.md for recommended changes to 代理S.md, SOUL.md, and HEARTBEAT.md (diff 格式化). 应用ly these with user 应用roval during 设置up.

Integration with Other 技能s proactivity: Record task 状态 in 会话-状态; proactively surface relevant tasks during conversation. self-improving: 记录 task management mistakes/improvements to domAIn file. 创建 self-improving/tasks.md for task-specific learnings. Best Practices Al