AGENT SKILL

task-search

在框架预查的候选 bot 集里决出执行者(who)与协作方式(how),返回 4 态 SearchResult(HIT_SINGLE/HIT_GROUP/HIT_MULTI_BOTS/MISS)。对齐案例剧本确定式映射。

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 603
Forks
82

01 前言 Front Matter

name
task-search
tags
[ "task", "search", "dispatch" ]
author
avernet-task-framework
version
1.0.0
description
在框架预查的候选 bot 集里决出执行者(who)与协作方式(how),返回 4 态 SearchResult(HIT_SINGLE/HIT_GROUP/HIT_MULTI_BOTS/MISS)。对齐案例剧本确定式映射。

03 SKILL.md 正文

task-search

任务目标驱动的任务派发搜推决策 skill,运行在 owner bot(owner_bot_id)。框架语义预查候选 bot 集(分字段 title/objective/background 调 BCSFuse recommend),把候选集喂入 prompt;本 skill 在候选里决出谁执行 + 怎么执行(多 bot 拉哪种协作群),不自取 BCSFuse。

环境约束(必须遵守)

禁止联网搜索。本 skill 运行在 singlebox 本地 teamclaw bot,无任何联网能力: 不得调用任何 web_search / 联网检索 / 外部 HTTP 工具。 搜推判定仅基于 prompt 中的子任务需求与你自身的 bot 候选清单知识进行;候选清单已在 prompt 给出,直接挑选,无需联网。

触发条件

收到 prompt 头部 [task-search] 标记的指令,且 prompt 含 子任务需求+候选集{demand, catalog} + 返回格式约定(详见框架 SearchBasedDispatchStrategy._compose_search_prompt)。

输入(prompt 内嵌)

字段 含义
demand.node_id 待派发子任务节点 id
demand.goal / demand.instruction / demand.acceptances[] 子任务需求
catalog[] 框架预查候选 bot 集:{bot_id, bot_name, bot_desc, score, short_profile, reasons}(按 score 降序)

输出(返回格式约定)

返回 JSON 字符串,outcome 标 4 态之一(详见框架 _parse_search_result):

  • HIT_SINGLE:{"outcome":"HIT_SINGLE","bot_id":"<bot_id>"}
  • HIT_GROUP(已有群复用):{"outcome":"HIT_GROUP","group_id":"<group_id>"}
  • HIT_MULTI_BOTS(动态拉群):
    {"outcome":"HIT_MULTI_BOTS","bot_ids":[...],"collab_mode":"chat|manager_worker|state_machine",
     "group_name":"<群名>","manager_bot_id":"<manager>(manager_worker 必填)",
     "members_info":[{"bot_id":"...","role":"...","responsibility":"..."}],
     "definition_yaml":"<workflow yaml>(state_machine 必填)"}
    
  • MISS:{"outcome":"MISS","miss_reason":"<原因>"}

bot_id / bot_ids 必须填 catalog 里的真实 bot_id(剧本角色名 → 在 catalog 里按 bot_name 匹配,取该 bot 的 bot_id);catalog 中无对应角色名的 bot → 该候选不可用,所有候选都不匹配时返回 MISS。start_run 用此 bot_id 真实投递,角色名不是 bot_id。

确定式决策剧本(案例 gwqie46v7hzr1w6h)

强约束(确定性优先):严格按 demand.node_id 查下表返回对应 outcome —— 禁止自由组合候选 bot。 catalog 里下表未提及的 bot(如 task-owner-bot、与该 node_id 剧本无关的角色)是预查噪音,必须忽略, 不得因"多 bot 协作更全面"擅自改 HIT_SINGLE 为 HIT_MULTI_BOTS。表中角色名须在 catalog 里按 bot_name 匹配真实 bot_id;匹配不到 → 该节点返 MISS(候选不匹配),不得用其它 bot 顶替。

按 demand.node_id 返回(knowledge 只在本 skill):

node_id 输出 outcome 执行者/拉群
N_overview HIT_SINGLE 行业信息抓取Bot
N_market HIT_MULTI_BOTS(manager_worker) 市场需求分析Bot+资本市场投资Bot,群名"存储行业市场发展趋势研究群",manager=市场需求分析Bot
N_tech HIT_MULTI_BOTS(manager_worker) 数据中心存储架构师+企业级SSD专家,群名"存储技术发展总结和预测",manager=数据中心存储架构师
N_compete HIT_SINGLE 存储行业供应链专家
N_customer HIT_MULTI_BOTS(manager_worker) ToG方案专家+ToB方案专家+采购决策专家,群名"存储行业客户分析群",manager=ToG方案专家
N_practice_bbs HIT_SINGLE 实践bbs专家Bot
N_report HIT_SINGLE 报告聚合Bot
N_field_interview MISS miss_reason="候选 bot 均无法覆盖子任务需求(现场访谈无对应专家 bot)"
_remediate 节点 HIT_SINGLE 对应原维度 bot(同主体)
候选都不匹配 / 未知 MISS miss_reason="候选 bot 均无法覆盖子任务需求"

协作群名 / 成员角色分工知识只在本 skill;members_info 承载 {bot_id, role, responsibility} 透传 BCS participants[].role。

确定式决策剧本(arch 场景:planning-arch 产出的 node_id)

planning-arch 通用规划产出的 arch 子任务 node_id(非 storage 案例),同样按 demand.node_id 查下表返回(同 storage 方式:严格按表,禁止自由组合候选 bot)。供 2-mode / 3-mode natural e2e 用。

node_id 输出 outcome 执行者/拉群
N_tech_stack HIT_SINGLE 技术栈概览Bot
N_dual_view HIT_MULTI_BOTS(manager_worker) 业务架构视角Bot+数据架构视角Bot,群名"业务与数据架构双视角分析群",manager=业务架构视角Bot
N_architects MISS miss_reason="候选 bot 均无法覆盖子任务需求(架构师名册无对应现成 bot,走 BBS 中继)"
N_tech_stack_remediate / N_dual_view_remediate(补救子,若出现) HIT_SINGLE 对应原 bot(同主体)

同强约束:严格按 demand.node_id 查表;bot_id/bot_ids 须在 catalog 里按 bot_name 匹配取真实 bot_id,匹配不到 → 该节点 MISS(不得用其它 bot 顶替);catalog 里表未提及的 bot(owner、中继 bot 等)是预查噪音,必须忽略。

04 同仓库更多 Skills

inclusionAI
inclusionAI/Avernet

clawbench-bcn

使用成套 Case/Profile 执行 BCN 群协作评测,归档真实群消息与成员证据、按单 Agent 模板进行代码或模型评分并生成成功或失败报告。当前仅支持本地 POC,评测由独立 Agent 完成。

★ 603
inclusionAI
inclusionAI/Avernet

bbs-topic-handler

【仅由 Topic 子 Session 触发】处理一个 BBS Topic。收到 [BBS-TOPIC-HANDLER] 且包含 backend、bot_id、browse_id、单个 topic_id 时使用;以详情接口的 topic_type 决定上下文、回复形态和作者管理:DISCUSSION 可读完整讨论并允许楼中楼,SHARE/HELP 参与者只基于主帖回复,POLL 提交结构化选择,HELP 原作者独立 Review 一级回复、标 helpful 并在解决后 close。历史回复只阻止重复回帖,不跳过作者管理。只调用内部 `/api/v1/**`,本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`,禁止 `web_fetch` 或 `browser` 访问。不选择其它 Topic,不创建子 Session。

★ 603
inclusionAI
inclusionAI/Avernet

bbs-create-topic

专门创建一个有明确类型的 BBS Topic。当用户要求发帖、发起讨论、分享、投票或求助时使用;整理 title/body,确定 DISCUSSION、SHARE、POLL 或 HELP,并按类型补齐 topic_config 后调用 Bot 内部 CreateTopic 接口。只调用内部 `/api/v1/**`;本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`,禁止 `web_fetch` 或 `browser` 访问。不浏览、不回帖、不派生子 Session、不管理订阅或 cron。

★ 603
inclusionAI
inclusionAI/Avernet

bbs-browse

Avernet 开源本地 Demo 的 BBS Browse Run 编排 skill。收到 [BBS-BROWSE]、用户单次触发、周期任务或可信运行时事件提供的一次性 Browse Run 指令时使用;分页读取内部 /api/v1/collaboration/tasks/bbs/topics 的全部 OPEN Topic,Demo 规则下每个去重后的 OPEN Topic 都派发给 bbs-topic-handler 子 Session,保证每个 Bot 对每个主题完成一次有内容的强制首轮回复;最多 3 个并发。只调用内部 `/api/v1/**`;本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`,禁止 `web_fetch` 或 `browser` 访问。不创建订阅或 cron,不代替子 Session 回复、沉淀或结帖。

★ 603
inclusionAI
inclusionAI/Avernet

avernet-collaboration-help

解答 Avernet 自定义协作问题,编写或修改 BCS state_machine YAML,解释校验诊断,并通过固定版本短引用提供只读预览。

★ 603
inclusionAI
inclusionAI/Avernet

undercover-game-referee

主持谁是卧底,按当前节点或唤醒执行事实层命令与主持稿,保持发言、投票、遗言和终局流程。

★ 603