任务控制中心——AI助手的任务管理平台

这是一个由您（AI助手）管理的看板式任务面板。用户通过网页仪表板创建并排定任务优先级；当任务被移至"进行中"状态时，您将自动执行这些任务。

🚀 快速开始

只需说出： "为我的工作区设置任务控制中心"

代理程序将：

1. 检查前置条件（Tailscale、gh命令行工具）
2. 复制仪表板文件到您的工作区
3. 创建配置文件（~/.clawdbot/mission-control.json）
4. 安装网络钩子转换器
5. 设置GitHub网络钩子
6. 推送至GitHub并启用页面功能

至此完成代理程序将处理所有流程

前置条件

开始设置前，您需要：

如果缺少任何组件，请告知代理——它将指导您完成安装。

工作原理

1. 仪表板— 托管在GitHub Pages上的Web界面，供用户管理任务
2. Webhook— 任务变更时，GitHub向Clawdbot发送推送事件
3. 转换— 比较新旧tasks.json，检测状态变化
4. 自动处理— 当任务移至“进行中”时，代理开始工作

流程

Human moves task → GitHub push → Webhook → Transform → Agent receives work order
      ↓                                                         ↓
   Dashboard                                              Executes task
      ↓                                                         ↓
Agent updates status ← Commits changes ← Marks subtasks done ←─┘

任务结构

任务存储于<workspace>/data/tasks.json：

{
  "id": "task_001",
  "title": "Implement feature X",
  "description": "Detailed context for the agent",
  "status": "backlog",
  "subtasks": [
    { "id": "sub_001", "title": "Research approach", "done": false },
    { "id": "sub_002", "title": "Write code", "done": false }
  ],
  "priority": "high",
  "dod": "Definition of Done - what success looks like",
  "comments": []
}

状态值

CLI命令

使用<skill>/scripts/mc-update.sh进行任务更新：

# Status changes
mc-update.sh status <task_id> review
mc-update.sh status <task_id> done

# Comments
mc-update.sh comment <task_id> "Progress update..."

# Subtasks
mc-update.sh subtask <task_id> sub_1 done

# Complete (moves to review + adds summary)
mc-update.sh complete <task_id> "Summary of what was done"

# Push to GitHub
mc-update.sh push "Commit message"

代理工作流程

当您收到任务（移至“进行中”）时：

1. 阅读— 检查标题、描述、子任务、完成标准
2. 标记为已开始—mc-update.sh start <task_id>
3. 执行— 处理子任务，逐一标记为完成
4. 记录— 添加进度评论
5. 完成—mc-update.sh complete <task_id> "摘要"

处理返工

如果一个已完成的任务被移回"进行中"并附有新评论：

1. 阅读反馈评论
2. 解决问题
3. 添加评论解释你所做的更改
4. 移回评审

EPICs

EPICs 是包含多个子任务单的父任务。当你收到一个 EPIC 时：

1. 子任务单列在子任务中（格式为：MC-XXX-001: 标题）
2. 按顺序处理它们（1 → 2 → 3...）
3. 处理完每个子任务后：评论结果，设置为“审查”状态，标记EPIC子任务为完成
4. 处理完最后一个子任务后：将EPIC设置为“审查”状态

心跳集成

添加到你的HEARTBEAT.md文件：

## Task Check

1. Check `data/tasks.json` for tasks in "in_progress"
2. Flag tasks with `processingStartedAt` but no recent activity
3. Check "review" tasks for new feedback comments

配置

配置文件位于~/.clawdbot/mission-control.json。参见assets/examples/CONFIG-REFERENCE.md了解所有选项。

最小配置（由代理在设置过程中配置）：

{
  "gateway": { "hookToken": "your-token" },
  "workspace": { "path": "/path/to/workspace" },
  "slack": { "botToken": "xoxb-...", "channel": "C0123456789" }
}

故障排除

参见docs/TROUBLESHOOTING.md了解常见问题：

• 仪表板显示示例数据 → 连接GitHub令牌
• Webhook未触发 → 检查Tailscale Funnel
• 更改未显示 → GitHub Pages缓存（等待1-2分钟）

安全性

Mission Control 是一个任务管理系统用于AI 智能体——其核心目的是将人工编写的任务描述传递给智能体来执行。这是设计使然，并非漏洞。

信任模型

• 单用户/可信用户设置：任务创建者与控制智能体的是同一批人。其信任边界等同于直接向您的助手输入消息。
• 多用户设置：如果多个用户可以在仪表板上创建任务，请将任务内容视为不可信的输入。使用 Clawdbot 的智能体沙箱和权限模型来限制智能体可以执行的操作。

缓解措施

• 输入净化： mc-update.sh在将输入传递给 Python 或 git 之前，会针对注入模式验证所有输入。
• 不存储凭据：仪表板不存储令牌或密钥——所有认证都由 Clawdbot 的配置处理。
• Webhook HMAC 验证：转换模块使用timingSafeEqual 来验证 webhook 签名为了防止篡改。
• 同步时的安全扫描：该sync-to-opensource.sh脚本会在发布前扫描泄露的凭据。

建议

• 如果您不希望他人看到您的任务数据，请将您的仪表板仓库设为私有
• 。
• 如果任务是由他人创建的，在将其移至“进行中”状态前，请先审阅任务描述。使用 Clawdbot 的groupPolicy和allowFrom

设置来限制可与代理交互的人员。