smarter-task-planner

【Smarter Task Planner】自动创建时间戳任务文件夹，支持步骤规划、检查点保存、中断恢复与进度追踪，确保任务可追溯、可恢复。适用于分析、调研、信息提取、文档生成等需要结构化步骤的任务场景。

Security Scan

这个技能的代码与运行说明与其“任务规划与检查点保存/恢复”描述一致——它在本地工作区读写任务目录与记忆文件，没有请求远程凭据或未经说明的网络外联。

Purpose & Capability

技能名、描述、运行说明和包含的脚本一致：创建 output/YYYY-MM-DD_任务/ 结构、写入每日记忆和长期 MEMORY.md、维护 .task-meta.json、扫描并恢复未完成任务。没有看到与描述不符的外部服务依赖或不相关权限需求。

Instruction Scope

SKILL.md 指示运行本地 Python/PowerShell 脚本、在工作区（~/.openclaw/workspace 或 APPDATA 下）内创建/扫描/写入文件。这些动作与技能目的直接相关。脚本会读取/写入 workspace 下的 output、memory、MEMORY.md 与 .task-meta.json，但未发现将数据发送到外部网络或访问与目的无关的系统位置。注意：脚本会访问环境变量（如 APPDATA、HOME）用于查找 workspace，这是合理的目录发现行为。

Install Mechanism

没有 install 规范或远程下载；所有代码文件随技能打包提供（Python/PowerShell 脚本）。没有从未经审查的 URL 提取或安装第三方二进制，因此安装风险低。

Credentials

技能不要求任何外部凭据或专用环境变量。脚本仅读取常见环境变量（APPDATA、HOME、USERPROFILE）用于查找 workspace，这与其功能（定位用户工作区）相符。没有发现请求 SECRET/TOKEN/PASSWORD 之类的敏感变量。

Persistence & Privilege

flags 中没有 always:true，技能不会强制保持常驻。HEARTBEAT 是可选说明（模板引导用户如何配置定期检查），并不会自动安装守护进程或修改其他技能配置。脚本可以按用户指示被调度，但不会自行植入系统计划任务。

Assessment

主要结论：此技能在本地读写用户的 .openclaw/workspace（output、memory、MEMORY.md、.task-meta.json），没有发现网络外联或凭据要求。建议在安装/运行前注意： - 在非关键/测试工作区先行试运行，确认脚本按预期只在目标 workspace 下创建/修改文件。脚本会尝试创建 output/<task-id> 目录并写入元数据与记忆文件。 - PowerShell 版本为 .txt 文本，运行前需手动重命名为 .ps1；检查这些文件以确认改名后行为符合你的预期。 - HEARTBEAT/定期检查需由你主动配置（复制模板并在计划任务/cron中调用）；技能本身不会自动注册计划任务。 - 虽然没有网络行为或凭据访问，但仍建议审阅 safe-writer.py、task-memory-manager.py、task-recovery-check.py 的实现（已打包提供），尤其是在将其用于包含敏感数据的工作区时。 如果你希望更高信心评估，可提供：你计划的 workspace 路径（以便验证路径解析逻辑）、以及是否允许将这些脚本被自动调度（heartbeat）；若需，我可以指出代码中具体的文件/行以便你审查更细节的写入/创建逻辑。

更好的任务规划 (Smarter Task Planner)

更高效的结构化任务执行与步骤规划。自动创建 YYYY-MM-DD_描述/01_步骤/ 文件夹结构，支持步骤规划、检查点保存、中断恢复与进度追踪。适用于分析、调研、信息提取、文档生成等多种任务场景，确保任务可规划、可追踪、可恢复。

核心规则

1. 路径基准

• 工作空间根目录 = .openclaw\workspace\
• 正确示例: output/2026-03-19_任务/
• 验证位置: pwd 应显示工作空间根目录

2. 检查点记忆保存

创建任务目录后立即保存检查点：

# Python可用时（推荐）
py scripts/safe-writer.py "开始任务: [描述]" --task-id "YYYY-MM-DD_描述" --step "01_开始"

# Python不可用时（备用方案）
# 如果需要PowerShell版本，将 safe-writer-ps1.txt 重命名为 safe-writer.ps1
# powershell scripts/safe-writer.ps1 "开始任务: [描述]" --task-id "YYYY-MM-DD_描述" --step "01_开始"

3. 规划-执行流程

1. 完整规划：明确所有步骤（01_步骤名、02_步骤名...）
2. 创建结构：output/YYYY-MM-DD_描述/01_步骤/
3. 保存检查点：立即执行检查点写入命令
4. 顺序执行：按步骤目录顺序工作，每阶段保存进展

AI工作流程

开始新任务

1. 规划步骤：分析任务，确定3-5个主要阶段
2. 验证位置：确保在工作空间根目录
3. 创建目录：output/YYYY-MM-DD_描述/ 及所有步骤子目录
4. 保存记忆：运行检查点写入命令记录任务开始
5. 执行工作：按步骤顺序进行，每个步骤强制输出内容文档，禁止写入空文件，定期保存进展

恢复任务

• 说"恢复上次任务"或运行 task-memory-manager.py recovery
• 系统显示未完成任务列表供选择

核心脚本

• safe-writer.py - Python版记忆写入（原子操作+双写保证，推荐使用）
• task-memory-manager.py - 任务扫描与恢复管理
• task-recovery-check.py - 自动检查未完成任务（Python版本）

备用脚本（如需PowerShell版本）

• safe-writer-ps1.txt - PowerShell备用版本（重命名为 .ps1 使用）
• task-recovery-check-ps1.txt - PowerShell包装器（重命名为 .ps1 使用）
• workspace-commands-ps1.txt - PowerShell快捷命令（重命名为 .ps1 使用）

环境检测

系统优先使用Python版本：

• Python可用 → 使用 safe-writer.py（功能完整，推荐）
• Python不可用 → 可将 safe-writer-ps1.txt 重命名为 safe-writer.ps1 使用（基础功能）

快速检查

# 验证当前位置
pwd

# 如有嵌套错误
cd ..

Heartbeat 自动检查

技能包含自动任务恢复检查功能：

1. 配置方法：查看 templates/HEARTBEAT-guide.md 文件
2. 执行频率：每2-4小时自动检查未完成任务
3. 行为：
   • 发现未完成任务 → 提醒用户恢复
   • 无未完成任务 → 静默通过
4. 手动检查：py scripts/task-recovery-check.py notify

关键命令速查

• safe-writer.py <内容> --task-id <ID> --step <步骤> - 保存记忆
• task-memory-manager.py recovery - 恢复界面
• task-memory-manager.py scan - 扫描任务
• task-recovery-check.py notify - 心跳检查（Python版本）