workspace-organizer

任务文件组织与记忆管理。创建时间戳文件夹，支持会话恢复。

任务优先文件组织。创建 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版本）