名称： mission-control
描述： 面向 AI 助手的看板式任务管理面板。可通过 CLI 或仪表板 UI 管理任务。当用户提及任务、看板、任务板、任务控制或希望使用状态列（待办、进行中、审核、完成）跟踪工作项时使用。
主页： https://github.com/rdsthomas/mission-control
元数据： {"clawdbot": {"emoji": "🎛️"}}

Mission Control — AI 助手任务管理系统

一个由你（AI 助手）管理的看板式任务板。你的用户通过 Web 仪表板创建和确定任务优先级；当任务被移动到“进行中”时，你将自动执行它们。

🚀 快速开始

只需说： “为我的工作区设置 Mission Control”

助手将：
1. 检查先决条件（Tailscale, gh CLI）
2. 将仪表板文件复制到你的工作区
3. 创建配置文件 (~/.clawdbot/mission-control.json)
4. 安装 Webhook 转换器
5. 设置 GitHub Webhook
6. 推送到 GitHub 并启用 Pages

就这么简单。 助手会处理所有事情。

先决条件

在设置之前，你需要：

如果缺少任何一项，请告诉助手——它会指导你完成安装。

工作原理

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

工作流程

用户移动任务 → GitHub 推送 → Webhook → 转换器 → 助手接收工作指令
      ↓                                                         ↓
   仪表板                                                执行任务
      ↓                                                         ↓
助手更新状态 ← 提交更改 ← 标记子任务完成 ←─┘

任务结构

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

{
  "id": "task_001",
  "title": "实现功能 X",
  "description": "给助手的详细上下文",
  "status": "backlog",
  "subtasks": [
    { "id": "sub_001", "title": "研究方法", "done": false },
    { "id": "sub_002", "title": "编写代码", "done": false }
  ],
  "priority": "high",
  "dod": "完成的定义 - 成功标准",
  "comments": []
}

状态值

CLI 命令

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

# 状态变更
mc-update.sh status <task_id> review
mc-update.sh status <task_id> done

# 添加评论
mc-update.sh comment <task_id> "进度更新..."

# 子任务
mc-update.sh subtask <task_id> sub_1 done

# 完成任务（移动到 review 并添加摘要）
mc-update.sh complete <task_id> "所做工作的摘要"

# 推送到 GitHub
mc-update.sh push "提交信息"

助手工作流程

当你收到一个任务（移动到“进行中”）时：

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

处理返工

如果一个已完成的任务被移回“进行中”并附有新评论：
1. 阅读反馈评论
2. 解决问题
3. 添加评论解释你的更改
4. 移回“审核”

EPIC（史诗任务）

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

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

心跳集成

添加到你的 HEARTBEAT.md 中：

## 任务检查

1.  检查 `data/tasks.json` 中状态为“in_progress”的任务
2.  标记有 `processingStartedAt` 但近期无活动的任务
3.  检查“review”状态的任务是否有新的反馈评论

配置

配置位于 ~/.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 token
• 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 设置来限制可以与助手交互的人员。

文件说明