Skill: hyddd/taskboardai-skill (version 1.0.1)

--- name: taskboard-skill description: Manage tasks and projects using the TaskBoardAI Kanban system. Includes MCP server integration. --- <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>

path: README.md
content: # 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:**
    - Move card to "Blocked" column.
    - Update Content: Add a section `**⚠️ BLOCKER:** [Reason]`.
    - Notify user of the blocker.
3.  **If Successful:**
    - Update Content: Append the **FINAL RESULT/SUMMARY** to the card content. This is crucial for future reference.
    - Move card to "Done" column.
    - Report completion to user with a brief summary.
```

---

# TaskBoard Skill for Clawdbot

This is a **TaskBoardAI** integration skill designed for **Clawdbot**. It enables Clawdbot to manage a Kanban board directly via the MCP (Model Context Protocol), achieving a fully automated workflow of "Intent Recognition -> Task Creation -> Execution -> Archiving".

## Core Features

*   **Full Lifecycle Management**: Supports automatic transitions between Todo, Doing, Blocked, and Done states.
*   **Deep MCP Integration**: Communicates directly with the TaskBoard backend using stdio mode, eliminating the need for extra HTTP services.
*   **Content Adaptation**: Automatically fixes the issue where the TaskBoard frontend renders the `content` field instead of `description`.
*   **Reflex Protocol**: Works with `AGENTS.md` to trigger automatic card creation via the keyword "【任务】" (Task).

## Installation & Configuration

### 1. Prerequisites
This skill depends on [TaskBoardAI](https://github.com/taskboardai/taskboardai). Please install it globally first:

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

### 2. Install Skill
Clone this directory into your Clawdbot workspace:

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

### 3. Configure Path
Check `SKILL.md` to ensure the `<arg>` path points to the actual `kanbanMcpServer.js` location on your system:
```xml
<arg>/opt/homebrew/lib/node_modules/taskboardai/server/mcp/kanbanMcpServer.js</arg>
```

## Usage

In your conversation with Clawdbot:
*   **Create Task**: "【任务】Research quantitative frameworks"
*   **Query Task**: "What tasks are currently in progress?"
*   **Update Status**: "The research task is done, the conclusion is..."

## Workflow Protocol (AGENTS.md)

For the best experience, it is recommended to add the following protocol to your `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:**
    - Move card to "Blocked" column.
    - Update Content: Add a section `**⚠️ BLOCKER:** [Reason]`.
    - Notify user of the blocker.
3.  **If Successful:**
    - Update Content: Append the **FINAL RESULT/SUMMARY** to the card content. This is crucial for future reference.
    - Move card to "Done" column.
    - Report completion to user with a brief summary.
```


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)