Taskboardai Skill

<skill>
  <name>taskboard</name>
  <description>
    Manage tasks and projects using the TaskBoardAI Kanban system.
    
    CRITICAL LIFECYCLE RULES:
    1. **Create**: When a new task is identified, create it in the 'To Do' column.
    2. **Execute**: IMMEDIATELY after creating a task (or when asked to work on one), move it to 'In Progress' (Doing). Do not leave active tasks in 'To Do'.
    3. **Block**: If a task cannot be completed (e.g., missing API key, network error), move it to 'Blocked' and note the reason in the content.
    4. **Complete**: When finished, update the card content with the FINAL RESULT/SUMMARY, then move it to 'Done'.
    
    NOTE: The main body/result of the card must be stored in the 'content' field (Markdown supported), not 'description'.
  </description>
  <mcp_server>
    <command>node</command>
    <args>
      <arg>/opt/homebrew/lib/node_modules/taskboardai/server/mcp/kanbanMcpServer.js</arg>
    </args>
  </mcp_server>
</skill>

# TaskBoard Skill for Clawdbot

这是一个为 **Clawdbot** 打造的 **TaskBoardAI** 集成技能。它允许 Clawdbot 通过 MCP (Model Context Protocol) 协议，直接在后台管理任务看板，实现“意图识别 -> 任务创建 -> 执行 -> 归档”的全自动化工作流。

## 核心功能

*   **全生命周期管理**：支持创建 (Todo)、执行 (Doing)、阻塞 (Blocked)、完成 (Done) 四种状态的自动流转。
*   **MCP 深度集成**：使用 stdio 模式与 TaskBoard 后端直接通信，无需维护额外的 HTTP 服务。
*   **内容自适应**：自动修复了 TaskBoard 前端渲染 `content` 字段而非 `description` 字段的问题。
*   **条件反射协议**：配合 `AGENTS.md`，实现通过关键字“【任务】”触发自动建卡。

## 安装与配置

### 1. 前置依赖
本技能依赖于 [TaskBoardAI](https://github.com/taskboardai/taskboardai)。请先全局安装：

```bash
npm install -g taskboardai
```

### 2. 安装 Skill
将本目录克隆至你的 Clawdbot 工作区：

```bash
cd ~/clawd/skills
git clone https://github.com/hyddd/taskboard_skill.git taskboard
```

### 3. 配置路径
检查 `SKILL.md` 中的 `<arg>` 路径是否指向你系统中真实的 `kanbanMcpServer.js` 位置：
```xml
<arg>/opt/homebrew/lib/node_modules/taskboardai/server/mcp/kanbanMcpServer.js</arg>
```

## 使用方法

在与 Clawdbot 的对话中：
*   **创建任务**：“【任务】调研量化框架”
*   **查询任务**：“现在有哪些进行中的任务？”
*   **更新状态**：“那个调研任务做完了，结论是...”

## 工作流协议 (AGENTS.md)

为了获得最佳体验，建议在你的 `AGENTS.md` 中添加以下协议：

```markdown
## Task Protocol (TaskBoard Integration)
**Trigger:** When user input contains "【任务】" (or you determine a task needs tracking):

### 1. Initiate (Create & Start)
1.  **Call `taskboard` skill** immediately.
2.  **Create Card:** In the "Todo" column.
    - Title: The core task name.
    - Content: Full context + "Owner: Clawdbot".
3.  **Start Execution:** Immediately move the card to the "Doing" (In Progress) column.
4.  **Announce:** "Task [Title] created and started."

### 2. Execute & Update
1.  **Perform the work:** Use available tools (web_search, etc.) to fulfill the task.
2.  **If Blocked:...