Setup
On first use, read setup.md for activation boundaries, continuity rules, and how to introduce the system without turning it into a form.
When to Use
User wants to manage a task list by talking naturally instead of filling a UI. The agent should capture tasks, clarify them into clean next actions, and maintain stable views like Inbox, Today, Upcoming, Anytime, Someday, and Waiting.
Use this when the user wants Things or Todoist behavior from conversation: quick capture, predictable sorting, recurring work, project structure, and weekly review without silent changes.
Architecture
Memory lives in ~/task-list/. If the user wants continuity and ~/task-list/ does not exist, run setup.md. See memory-template.md for the durable context file and workspace-format.md for the local file layout.
CODEBLOCK0
Quick Reference
| Topic | File |
|---|
| First-use behavior | INLINECODE6 |
| Durable memory |
memory-template.md |
| Local workspace files |
workspace-format.md |
| Capture and clarification |
capture-and-clarify.md |
| Views and sorting rules |
views-and-sorting.md |
| Dates, recurrence, and waiting |
recurrence-and-waiting.md |
| Daily and weekly review loops |
review-rhythm.md |
Core Rules
1. Capture first, clarify second
- - Never block raw capture on missing metadata.
- If the user brain-dumps multiple items, capture them all first, then clarify only the fields that materially change execution.
- Default ambiguous items to
Inbox instead of pretending certainty. - Use
capture-and-clarify.md to decide what to infer versus what to ask.
2. Preserve task semantics exactly
- - Keep due date, start or defer date, recurrence rule, completion time, and waiting state as separate concepts.
- "Due Friday" is different from "show me this Friday" and different again from "snooze until Friday."
- If a date phrase could change the outcome, ask once and record the clarified meaning.
- Use
recurrence-and-waiting.md for exact date and repeat behavior.
3. One task equals one visible next action
- - Rewrite vague items into a task title that starts with a verb and can be advanced in one focused work block.
- If the user names an outcome with multiple steps, create a project plus the next visible action instead of one bloated task.
- Preserve important original wording in notes or context when rewriting could hide nuance.
- Use
workspace-format.md for the project and task record shape.
4. Keep views stable and predictable
- - The same task should land in the same view every time given the same fields.
- Sort by bucket first, then date, then urgency, then intentional manual order.
- INLINECODE17 is for work that should be seen now, not for every overdue item in the system.
- Use
views-and-sorting.md whenever listing or re-listing tasks.
5. Separate projects, areas, and waiting work
- - Projects are finite outcomes with a defined done condition.
- Areas are ongoing responsibilities such as finance, health, hiring, or household operations.
- Waiting work must keep owner, blocker, last follow-up, and next chase date visible so delegated tasks do not disappear.
- Never collapse all of this into one flat list.
6. Make every structural change explicit
- - Confirm destructive or high-trust changes: delete, archive, mark done, recur, reschedule, or bulk move.
- When you change a task, say what changed in plain language.
- Never silently merge duplicates, invent deadlines, or mark something completed without the user's intent.
- Use the logging patterns from
workspace-format.md for meaningful changes only, not noisy chatter.
7. Review ruthlessly to keep trust
- - Run lightweight daily triage to empty
Inbox, refresh Today, and surface real blockers. - Run a weekly reset to prune stale tasks, expose overcommitment, and ensure every active project has a next action.
- Suggest defer, drop, delegate, or Someday when the list exceeds realistic capacity.
- Use
review-rhythm.md for the minimum review loop.
Common Traps
- - Turning every conversation into a questionnaire -> capture becomes slower than opening a task app.
- Mixing due dates and start dates -> tasks appear too early, too late, or in the wrong view.
- Treating projects and areas as the same thing -> review quality collapses as the list grows.
- Hiding delegated work inside generic blocked tasks -> follow-up risk becomes invisible.
- Keeping everything in
Today -> the user stops trusting the list and avoids it. - Rewriting task meaning too aggressively -> clean titles look nice but destroy intent.
- Auto-completing or auto-rescheduling without saying so -> trust is lost immediately.
Security & Privacy
Data that leaves your machine:
Data that stays local:
- - Task records and preferences under
~/task-list/ if the user wants continuity.
This skill does NOT:
- - Access files outside
~/task-list/ for storage. - Make undeclared network requests.
- Send reminders or run automations without explicit user approval.
- Modify its own skill instructions.
Related Skills
Install with
clawhub install <slug> if user confirms:
- -
assistant - Chief-of-staff style execution across tasks, messages, and follow-through. - INLINECODE28 - Turn tasks into a realistic day plan with protected focus blocks.
- INLINECODE29 - Keep durable context when the user wants broader long-term recall.
- INLINECODE30 - Build structured plans when a task grows into a multi-step initiative.
- INLINECODE31 - Manage deeper project tracking beyond a simple task list.
Feedback
- - If useful: INLINECODE32
- Stay updated: INLINECODE33
设置
首次使用时,请阅读 setup.md 了解激活边界、连续性规则,以及如何在不将其变成表单的情况下引入该系统。
使用时机
用户希望通过自然对话而非填写界面来管理任务列表。智能体应能捕获任务,将其梳理为清晰的下一步行动,并维护收件箱、今日、即将到来、随时、某天和等待中这些稳定的视图。
当用户希望从对话中获得类似 Things 或 Todoist 的行为时使用此功能:快速捕获、可预测的分类、重复性工作、项目结构以及无静默变更的每周回顾。
架构
记忆存储在 ~/task-list/ 中。如果用户需要连续性且 ~/task-list/ 不存在,请运行 setup.md。持久化上下文文件请参见 memory-template.md,本地文件布局请参见 workspace-format.md。
~/task-list/
├── memory.md # 持久化偏好和激活边界
├── inbox.md # 仍需梳理的原始捕获内容
├── tasks.md # 今日、即将到来、随时、某天中的活跃任务
├── projects.md # 具有下一步行动和截止日期的有限成果
├── areas.md # 无结束日期的持续责任
├── recurring.md # 重复规则和重新生成行为
├── waiting.md # 已委派或受阻的工作,附带跟进日期
└── log.md # 最近完成、放弃或重大字段变更
快速参考
memory-template.md |
| 本地工作区文件 | workspace-format.md |
| 捕获与梳理 | capture-and-clarify.md |
| 视图与排序规则 | views-and-sorting.md |
| 日期、重复与等待 | recurrence-and-waiting.md |
| 每日与每周回顾循环 | review-rhythm.md |
核心规则
1. 先捕获,后梳理
- - 切勿因缺少元数据而阻止原始捕获。
- 如果用户一次性抛出多个事项,先全部捕获,然后仅梳理那些会实质改变执行的字段。
- 将模糊项默认归入收件箱,而非假装确定。
- 使用 capture-and-clarify.md 决定哪些需要推断,哪些需要询问。
2. 精确保留任务语义
- - 将截止日期、开始或推迟日期、重复规则、完成时间和等待状态作为独立概念处理。
- 周五截止不同于这周五显示给我,也不同于暂停到周五。
- 如果日期短语可能改变结果,询问一次并记录梳理后的含义。
- 使用 recurrence-and-waiting.md 获取精确的日期和重复行为。
3. 一个任务等于一个可见的下一步行动
- - 将模糊事项重写为以动词开头、可在一次专注工作块中推进的任务标题。
- 如果用户提到包含多个步骤的成果,创建一个项目加上可见的下一步行动,而非一个臃肿的任务。
- 在重写可能隐藏细微差别时,在备注或上下文中保留重要的原始措辞。
- 使用 workspace-format.md 了解项目和任务记录的格式。
4. 保持视图稳定且可预测
- - 给定相同字段,同一任务每次应出现在同一视图中。
- 先按分类排序,然后按日期,再按紧急程度,最后按有意的手动顺序。
- 今日用于现在应该看到的工作,而非系统中每个逾期事项。
- 在列出或重新列出任务时使用 views-and-sorting.md。
5. 区分项目、领域和等待工作
- - 项目是具有明确完成条件的有限成果。
- 领域是持续的责任,如财务、健康、招聘或家庭运营。
- 等待工作必须保持所有者、阻碍因素、上次跟进和下次跟进日期可见,以确保委派的任务不会消失。
- 切勿将所有内容合并为一个扁平列表。
6. 每次结构性变更都要明确告知
- - 确认破坏性或高信任度的变更:删除、归档、标记完成、重复、重新安排或批量移动。
- 当更改任务时,用通俗语言说明更改了什么。
- 切勿在未经用户意图的情况下静默合并重复项、虚构截止日期或标记某事项为已完成。
- 仅对有意义的变化使用 workspace-format.md 中的日志记录模式,而非嘈杂的闲聊。
7. 严格回顾以保持信任
- - 运行轻量级每日分类,清空收件箱,刷新今日,并暴露真正的阻碍因素。
- 运行每周重置,清理过时任务,暴露过度承诺,确保每个活跃项目都有下一步行动。
- 当列表超出实际容量时,建议推迟、放弃、委派或移至某天。
- 使用 review-rhythm.md 了解最低限度的回顾循环。
常见陷阱
- - 将每次对话变成问卷调查 -> 捕获速度比打开任务应用还慢。
- 混淆截止日期和开始日期 -> 任务出现得过早、过晚或出现在错误视图中。
- 将项目和领域视为同一事物 -> 随着列表增长,回顾质量下降。
- 将委派工作隐藏在通用受阻任务中 -> 跟进风险变得不可见。
- 将所有内容保留在今日中 -> 用户不再信任列表并避免使用它。
- 过于激进地重写任务含义 -> 干净的标题看起来不错,但破坏了意图。
- 未经说明自动完成或自动重新安排 -> 信任立即丧失。
安全与隐私
离开您机器的数据:
保持在本地数据:
- - 如果用户需要连续性,任务记录和偏好存储在 ~/task-list/ 下。
此技能不会:
- - 访问 ~/task-list/ 之外的文件进行存储。
- 发出未声明的网络请求。
- 未经用户明确批准发送提醒或运行自动化。
- 修改自身的技能指令。
相关技能
在用户确认后使用 clawhub install 安装:
- - assistant - 跨任务、消息和跟进执行的幕僚长风格操作。
- daily-planner - 将任务转化为包含受保护专注块的现实日计划。
- memory - 当用户需要更广泛的长期回忆时保持持久化上下文。
- plan - 当任务发展为多步骤计划时构建结构化方案。
- projects - 管理比简单任务列表更深入的项目跟踪。
反馈
- - 如果有用:clawhub star task-list
- 保持更新:clawhub sync