yx2601816404-sys-quest-board

可视化项目任务面板，维护 quest-board-registry.json 并生成交互式 HTML 看板。

## 概述（中文）

可视化项目任务面板，维护 quest-board-registry.json 并生成交互式 HTML 看板。

## 技能正文

# Quest Board — 智能体说明

你配备了 **Quest Board** 技能，一个可视化项目仪表板。

## 注册表文件

在工作区根目录维护 `quest-board-registry.json`。不要使用 `registry.json`（避免与其他工具冲突）。

## 何时更新注册表

完成任务或在项目上有重大进展后：

1. 更新 `quest-board-registry.json` 中对应项目条目
2. 按需设置 `status`、`progress`、`files`、`desc`
3. 将 `_meta.lastUpdated` 更新为当前 ISO 时间戳

## 何时构建面板

用户说以下任一内容时：
- "update board" / "refresh board" / "build board"
- "更新面板" / "刷新面板" / "构建面板"

运行：
```bash
bash skills/quest-board/src/build.sh
```

这会在工作区根目录生成 `quest-board.html`。

## 首次设置

若 `quest-board-registry.json` 不存在，运行：
```bash
bash skills/quest-board/src/init.sh
```

这会扫描工作区并生成骨架注册表供你完善。

## 注册表结构

```json
{
  "_meta": {
    "version": 1,
    "description": "Quest Board project registry",
    "lastUpdated": "ISO-8601 timestamp",
    "workspace": "/absolute/path/to/workspace/"
  },
  "projects": {
    "project-id": {
      "name": "Display Name",
      "status": "active",
      "priority": "P0",
      "progress": 50,
      "deadline": "2026-12-31",
      "desc": "Short description of the project",
      "files": ["relative/path/from/workspace.md"]
    }
  },
  "research": {
    "research-id": {
      "name": "Research Title",
      "file": "relative/path.md",
      "date": "2026-01-15",
      "desc": "What this research covers"
    }
  },
  "infra": {
    "infra-id": {
      "name": "Infrastructure Item",
      "status": "running",
      "desc": "Description"
    }
  }
}
```

### 状态值

| Status | 含义 | 面板分区 |
|--------|---------|---------------|
| `decision` | 需决策后才能继续 | 🎯 Main Quests |
| `active` | 正在进行 | 📋 Side Quests |
| `done` | 已完成 | ✅ Completed |
| `paused` | 暂停/冰柜 | 💤 Icebox |

基础设施项在 🔧 Infrastructure 下。
研究项在 📊 Research 下。

### 优先级

使用 `P0`（关键）、`P1`（重要）、`P2`（锦上添花），或省略表示无优先级。

### 进度

整数 0–100。不适用时可省略。

### 文件

相对于工作区根的路径数组。在面板中成为可点击链接，带复制路径与打开文件夹按钮。

## 环境变量

| Variable | Default | Description |
|----------|---------|-------------|
| `QUEST_BOARD_TITLE` | `Quest Board` | 面板页面标题 |