clawlist

核心用法

Clawlist 是一个系统化的任务管理工作流框架，专为多步骤项目、长运行任务和无限监控场景设计。其核心工作流程包含四个阶段：首先通过 brainstorming 明确意图并探索可行方法；接着使用 write-plan 创建包含检查点的详细执行计划；然后通过 doing-tasks 以规范的 skill 纪律执行具体任务；最后借助 verify-task 确认任务完成质量。对于需要并行处理的复杂项目，可在 write-plan 与 doing-tasks 之间插入 dispatch-multiple-agents 实现多代理协同。

该 skill 特别设计了 ongoing-tasks.md 文件机制，位于 memory/tasks/ongoing-tasks.md，用于追踪所有长运行和无限任务。Heartbeat 系统会定期读取该文件，执行到期的无限任务、检测阻塞问题、更新健康状态（🟢🟡🔴），并在需要人工干预时通知用户。

显著优点

1. 方法论完备：将模糊的项目目标转化为可执行、可追踪的结构化流程，显著降低复杂任务的管理认知负担。

2. 场景覆盖全面：从分钟级的一次性修复（One-off），到数周的项目建设（Project），再到持续运行的监控任务（Long-running），乃至永久循环的社区运营（Infinite），均有对应的管理策略。

3. 与系统深度集成：无缝对接 Heartbeat 心跳机制，实现任务的自动化调度和健康监控，无需人工持续盯盘。

4. 零学习成本：完全依赖系统内置的标准 skills（brainstorming、write-plan 等），无需掌握新的工具或语法。

5. 可扩展性强：支持单线程顺序执行和并行多代理分发两种模式，灵活适配不同复杂度的项目需求。

潜在缺点与局限性

1. 本身无执行能力：Clawlist 仅为工作流指导文档，实际执行完全依赖引用的子 skills。若子 skills 表现不佳，整体效果会受影响。

2. 缺乏强制约束：作为纯文档型 skill，它对用户行为的约束力有限，实际遵循程度取决于使用者的自律性。

3. 状态管理依赖文件系统：ongoing-tasks.md 的可靠性受限于本地文件系统的稳定性，无内置的备份或冲突解决机制。

4. Heartbeat 耦合风险：长运行和无限任务的健康检查与执行高度依赖 Heartbeat 系统的可用性，若心跳服务中断，任务调度将停滞。

5. 复杂度门槛：对于极简单的单步任务，完整的四阶段流程可能显得冗余，存在过度工程化的可能。

适合的目标群体

• 项目经理与团队负责人：需要系统化管理多阶段、跨周期的复杂项目
• 运维与 SRE 工程师：负责长期监控、告警响应、基础设施巡检等持续性任务
• 社区运营与内容创作者：执行定时发布、互动监控、数据追踪等无限循环工作流
• 研究人员与学术工作者：管理周期较长的实验设计、数据收集、论文撰写项目
• 个人效率提升者：希望将 ad-hoc 的工作方式升级为可复用的系统化流程

使用风险

1. 依赖项风险：实际功能由 brainstorming、write-plan、doing-tasks、verify-task 等子 skills 实现，需确保这些 skills 的可用性和版本兼容性。

2. Heartbeat 单点故障：长运行和无限任务的自动化执行依赖 Heartbeat 服务，建议关注其运行状态并准备手动降级方案。

3. 文件系统可靠性：ongoing-tasks.md 作为核心状态存储，若发生文件损坏、误删或并发写入冲突，可能导致任务追踪丢失或重复执行。

4. 权限继承问题：虽然 Clawlist 本身无敏感权限需求，但其调用的子 skills 可能涉及文件读写、网络请求等操作，需单独审查子 skills 的权限范围。

5. 性能瓶颈：对于高频执行的无限任务（如每 30 分钟的社区互动），若任务累积或执行超时，可能引发 Heartbeat 队列堆积，影响整体系统响应。