Agent Skills › spinabot/brigade › taskflow-inbox-triage

taskflow-inbox-triage

GitHub

展示TaskFlow收件箱分拣模式，根据意图分流消息：商务类发Slack并等待回复，个人类立即通知，其余汇总至日终摘要。提供状态管理、等待机制及运行时调用的完整代码示例。

skills/taskflow-inbox-triage/SKILL.md spinabot/brigade

Trigger Scenarios

需要按意图分类处理邮件或消息实现异步等待外部回复后继续流程构建基于TaskFlow的消息分拣工作流

Install

npx skills add spinabot/brigade --skill taskflow-inbox-triage -g -y

More Options

Use without installing

npx skills use spinabot/brigade@taskflow-inbox-triage

指定 Agent (Claude Code)

npx skills add spinabot/brigade --skill taskflow-inbox-triage -a claude-code -g -y

安装 repo 全部 skill

npx skills add spinabot/brigade --all -g -y

预览 repo 内 skill

npx skills add spinabot/brigade --list

SKILL.md

Frontmatter

{
    "name": "taskflow-inbox-triage",
    "metadata": {
        "brigade": {
            "emoji": "📥"
        }
    },
    "description": "Example TaskFlow authoring pattern for inbox triage. Use when messages need different treatment based on intent, with some routes notifying immediately, some waiting on outside answers, and others rolling into a later summary."
}

TaskFlow inbox triage

This is a concrete example of how to think about TaskFlow without turning the core runtime into a DSL.

Goal

Triage inbox items with one owner flow:

business → post to Slack and wait for reply
personal → notify the owner now
everything else → keep for end-of-day summary

Pattern

Create one flow for the inbox batch.
Run one detached task to classify new items.
Persist the routing state in stateJson.
Move to waiting only when an outside reply is required.
Resume the flow when classification or human input completes.
Finish when the batch has been routed.

Suggested `stateJson` shape

{
  "businessThreads": [],
  "personalItems": [],
  "eodSummary": []
}

Suggested waitJson when blocked on Slack:

{
  "kind": "reply",
  "channel": "slack",
  "threadKey": "slack:thread-1"
}

Minimal runtime calls

const taskFlow = api.runtime.tasks.flow.fromToolContext(ctx);

const created = taskFlow.createManaged({
  controllerId: "my-plugin/inbox-triage",
  goal: "triage inbox",
  currentStep: "classify",
  stateJson: {
    businessThreads: [],
    personalItems: [],
    eodSummary: [],
  },
});

const child = taskFlow.runTask({
  flowId: created.flowId,
  runtime: "acp",
  childSessionKey: "agent:main:subagent:classifier",
  task: "Classify inbox messages",
  status: "running",
  startedAt: Date.now(),
  lastEventAt: Date.now(),
});

if (!child.created) {
  throw new Error(child.reason);
}

const waiting = taskFlow.setWaiting({
  flowId: created.flowId,
  expectedRevision: created.revision,
  currentStep: "await_business_reply",
  stateJson: {
    businessThreads: ["slack:thread-1"],
    personalItems: [],
    eodSummary: [],
  },
  waitJson: {
    kind: "reply",
    channel: "slack",
    threadKey: "slack:thread-1",
  },
});

if (!waiting.applied) {
  throw new Error(waiting.code);
}

const resumed = taskFlow.resume({
  flowId: waiting.flow.flowId,
  expectedRevision: waiting.flow.revision,
  status: "running",
  currentStep: "route_items",
  stateJson: waiting.flow.stateJson,
});

if (!resumed.applied) {
  throw new Error(resumed.code);
}

taskFlow.finish({
  flowId: resumed.flow.flowId,
  expectedRevision: resumed.flow.revision,
  stateJson: resumed.flow.stateJson,
});