Deck Tracker v1.0.0

在 NextCloud Deck 看板上跟踪任务。

看板结构

本技能假定看板包含 4 个栈（列）：

配置

设置以下环境变量（例如在 .bashrc 或 OpenClaw 配置中）：

export DECK_URL="https://your-nextcloud.com/index.php/apps/deck/api/v1.0"
export DECK_USER="your_username"
export DECK_PASS="your_app_password" # 请使用应用密码（App Password）！
export BOARD_ID=1

若你的栈 ID 与默认值（1、2、3、4）不同，请覆盖它们：

export STACK_QUEUE=10
export STACK_PROGRESS=11
export STACK_WAITING=12
export STACK_DONE=13

命令

列出看板上所有卡片

deck list

向 Queue 添加新任务

deck add "任务标题" "可选描述"

选项：

• --progress：自动将新建卡片立即移至 “In Progress” 栈。
• --stack ：在指定栈 ID 中创建卡片（默认为 Queue）。

启用自动启动的示例：

deck add "紧急修复" "修复生产环境 Bug" --progress

将卡片移至其他栈

deck move  

获取卡片详情

deck get 

更新卡片标题或描述

deck update  [--title "新标题"] [--description "新描述"]

向卡片记录状态更新日志

deck log   "消息"

支持的状态： progress、success、error、warning、info。

启动自动化心跳监控

deck monitor  [target_id]

启动一个后台进程，每 60 秒追加一条 “Still working...” 日志条目；此外，每 120 秒向指定的 target_id（默认为 Skander）发送一条聊天通知。当该卡片从 “In Progress” 栈移出（进入 Done 或 Waiting）时，进程将自动终止。适用于预计耗时超过 2 分钟的任务。

以 JSON 格式导出所有已完成任务

deck dump-done

输出 “Done Today” 栈中所有卡片的 JSON 负载。适用于记忆合成（memory synthesis）。

归档所有已完成卡片

deck archive-done

将 “Done Today” 栈中的所有卡片移至已归档状态。适用于通过 cron 执行的日常清理。

删除一张卡片

deck delete 

工作流与记忆协议

1. 新任务到达 → 执行 deck add "标题" "详尽的初始描述"（如需立即开始，可添加 --progress 参数）。
2. 详尽描述规范： 描述应以 Objective、Plan 和 Constraints 开头。
3. 记录更新日志 → 执行 deck log progress "完成步骤 1"。
4. 关闭任务： 使用 deck update --description "详尽总结" 更新描述，其中应包含 Technical Summary、Operations Performed 和 Outcome。
5. 记忆合成： 归档前，执行 deck dump-done 解析当日工作内容，强化长期记忆。
6. 每日清理 → 执行 deck archive-done。

🚨 AI 协议：复杂描述处理

当使用多行 Markdown 描述更新卡片时，务必采用 临时文件法（temp file method），以避免 Shell 展开错误：

# 1. 将详尽描述写入临时文件
cat > /tmp/deck_desc_.txt << 'EOF'
[Rich Markdown]
EOF

# 2. 使用临时文件更新卡片
deck update  --description "$(cat /tmp/deck_desc_.txt)"