AGENT SKILL

task-planning

计算任务 gap 并产出下一步可执行子任务 List[TaskSpec];gap 已闭返回空数组。对齐案例剧本 gwqie46v7hzr1w6h(存储行业尽调)确定式分解。

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

01 前言 Front Matter

name
task-planning
tags
[ "task", "planning", "decompose" ]
author
avernet-task-framework
version
1.0.0
description
计算任务 gap 并产出下一步可执行子任务 List[TaskSpec];gap 已闭返回空数组。对齐案例剧本 gwqie46v7hzr1w6h(存储行业尽调)确定式分解。

03 SKILL.md 正文

task-planning

任务目标驱动的任务规划 skill,运行在 owner bot(owner_bot_id)。框架投递 planning prompt(prompt 含 {goal, context, target_node, graph_snapshot, gaps} + 返回格式约定;详见框架 GapBasedPlanningStrategy._compose_planning_prompt),本 skill 读 prompt 中的目标节点 node_id,按案例剧本确定式产出下一批子任务。

环境约束(必须遵守)

禁止联网搜索。本 skill 运行在 singlebox 本地 teamclaw bot,无任何联网能力: 不得调用任何 web_search / 联网检索 / 外部 HTTP 工具;不得在 instruction 中要求子任务联网查资料。 一切判断基于 prompt 中已提供的 {goal, context, snapshot, done_children, gaps} 与你自身知识进行,缺数据用合理假设/占位补全并标注。

触发条件

收到 prompt 头部 [task-planning] 标记的指令,且 prompt 含 目标节点 node_id=... 与 任务态快照{...}。

输入(框架组装,prompt 内嵌)

字段 含义
node_id 当前计算 gap 的目标节点(node_id=... 形式)
goal.objective / goal.acceptances[] 节点自身目标与验收标准
context.background 任务背景
gaps 上一轮验收 FAIL 的 gaps(补救规划时非空)
graph_snapshot.loop_round 当前 BBS 上升轮次

输出(返回格式约定)

返回 JSON 字符串,结构为对象 {"tasks": List[TaskSpec], "has_gap": bool, "gap_detail": str}:

{"tasks": [{"metadata": {"task_id": "<子节点node_id>", "title": "<标题>", "instruction": "<指令>"},
             "context": {"background": "<背景>", "extend_props": {}},
             "goal": {"objective": "<目标>", "acceptances": [{"id": "<ac_id>", "description": "<描述>"}]}}],
 "has_gap": true,
 "gap_detail": ""}
  • tasks = 下一批可执行子任务;metadata.task_id 即子节点 node_id(须唯一,不与已存重复);
  • gap 已闭(验收通过)→ {"tasks": [], "has_gap": false, "gap_detail": "done"};
  • 有 gap 但无规划能力拆不出子 → {"tasks": [], "has_gap": true, "gap_detail": "<原因>"};
  • has_gap = 目标 - 已完成产出 是否仍有差距;done_children 已列出已 DONE 子节点及产出,据此产尚未完成的下一批(不重复产已 DONE 的);
  • 子任务 goal.acceptances 为该子任务自身的验收标准;无独立标准可继承父 goal。

确定式分解剧本(案例 gwqie46v7hzr1w6h)

框架二轮起 target 恒为根 t_case(根从初始规划后一直 PLANNING;任一子节点 PASS→触发根重新 plan, target 仍是 t_case)。按目标 node_id + 快照 done_children(已 DONE 子节点) 联合返回下一批:

目标 node_id done_children(已 DONE 子节点) 返回 children
t_case [](初始,无已完成子) [N_overview]
t_case [N_overview] [N_market, N_tech, N_compete, N_customer, N_field_interview]
t_case [N_overview, N_market, N_tech, N_compete, N_customer] [N_practice_bbs, N_report]
t_case […, N_practice_bbs] [N_report]
t_case […, N_report] [](根级终验 gap 闭)
FAIL+gaps 叶节点(target=该叶,补救规划) — [N_<叶>_remediate](按 gaps 描述产 1 个补救子)
其它/无可规划 — []

递进依据 = done_children 已出现的子节点(逐步补齐未覆盖维度,不重复产已 DONE 的); done_children[].output 含各子产出,可据此细化下一批子任务的 instruction / acceptances。 节点名由本 skill 决定,框架代码零 case 知识(框架 grep 不得出现这些字面量)。

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