task-planning-arch
计算任务 gap 并产出下一步可执行子任务 List[TaskSpec];gap 已闭返回空数组。对齐 arch 场景(架构师名册/技术栈概览/双视角分析)确定式分解——按根目标交付物集合 + done_children 查表(参照 task-planning storage 特例,非自由 LLM 分解)。
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 603
- Forks
- 82
01 前言 Front Matter
- name
- task-planning-arch
- tags
- [ "task", "planning", "decompose" ]
- author
- avernet-task-framework
- version
- 1.0.0
- description
- 计算任务 gap 并产出下一步可执行子任务 List[TaskSpec];gap 已闭返回空数组。对齐 arch 场景(架构师名册/技术栈概览/双视角分析)确定式分解——按根目标交付物集合 + done_children 查表(参照 task-planning storage 特例,非自由 LLM 分解)。
03 SKILL.md 正文
task-planning-arch
任务目标驱动的任务规划 skill,运行在 owner bot(owner_bot_id)。框架投递 planning prompt
(prompt 含 {goal, context, target_node, graph_snapshot, gaps} + 返回格式约定;详见框架
GapBasedPlanningStrategy._compose_planning_prompt),本 skill 读 prompt 中的目标节点 node_id,
按 arch 场景确定式剧本产出下一批子任务——参照 task-planning 的 storage 特例:**按根目标的验收交付物集合
done_children查表**,不靠自由 LLM 分解(避免拆子数/拆法飘忽)。
环境约束(必须遵守)
禁止联网搜索。本 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=... 形式;根 task_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": "<原因>"}; done_children已列出已 DONE 子节点及产出,据此不重复产已 DONE 的。
确定式分解剧本(arch 场景:按根目标交付物集合 + done_children)
框架二轮起 target 恒为根(根从初始规划后一直 PLANNING)。按根 goal.acceptances 的交付物集合 + 快照 done_children
(已 DONE 子节点 + 其 output 产出)联合返回下一批:
单一交付物:架构师名册(预期 MISS→升 BBS 中继)
| 目标 node_id | done_children | 返回 children |
|---|---|---|
| 根验收仅含架构师名册 | [](初始) |
[N_architects] <!-- 无 bot → MISS@MAX→升 BBS,金庸中继收口 --> |
| 根验收仅含架构师名册 | done 产出已含架构师名册(可能来自 run_mode=="bbs" 中继 scoped 节点) |
[](has_gap=false,gap 闭) |
| 根验收仅含架构师名册 | 仍缺架构师名册 | [](has_gap=true,gap_detail="缺架构师名册",等 BBS 中继) |
两份交付物:技术栈概览 + 架构师名册
| 目标 node_id | done_children | 返回 children |
|---|---|---|
| 根验收含技术栈概览 + 架构师名册 | [](初始) |
[N_tech_stack, N_architects] <!-- tech_stack 命中 bot(single_bot);architects MISS→BBS --> |
| 根验收含技术栈概览 + 架构师名册 | done 产出已含技术栈概览 + 架构师名册 | [](has_gap=false,gap 闭) |
| 根验收含技术栈概览 + 架构师名册 | 仍缺任一份 | [](has_gap=true,gap_detail="<缺哪份>") |
三份交付物:技术栈概览 + 业务/数据双视角分析 + 架构师名册
| 目标 node_id | done_children | 返回 children |
|---|---|---|
| 根验收含技术栈概览 + 双视角分析 + 架构师名册 | [](初始) |
[N_tech_stack, N_dual_view, N_architects] <!-- tech_stack single_bot;dual_view coop_group;architects MISS→BBS --> |
| 根验收含技术栈概览 + 双视角分析 + 架构师名册 | done 产出已含技术栈概览 + 双视角分析 + 架构师名册 | [](has_gap=false,gap 闭) |
| 根验收含技术栈概览 + 双视角分析 + 架构师名册 | 仍缺任一份 | [](has_gap=true,gap_detail="<缺哪份>") |
FAIL+gaps 叶补救 / 其它
| 情形 | 返回 |
|---|---|
target=FAIL 叶节点且 gaps 非空(补救规划) |
[N_<叶>_remediate](按 gaps 描述产 1 个补救子) |
| 其它 / 无可规划 | [] |
子任务规格(固定 node_id + task_spec)
[
{"metadata": {"task_id": "N_tech_stack", "title": "基础架构方向技术栈概览",
"instruction": "给出某某某公司基础架构方向的技术栈概览:列出计算/存储/网络等分层与每层核心组件,简要说明。基于自身知识即可,不联网。"},
"context": {"background": "某某某公司基础架构方向技术栈梳理", "extend_props": {}},
"goal": {"objective": "产出基础架构方向技术栈概览(分层+核心组件)",
"acceptances": [{"id": "ac_tech", "description": "给出基础架构方向技术栈概览(计算/存储/网络等层与核心组件)"}]}},
{"metadata": {"task_id": "N_dual_view", "title": "业务架构与数据架构双视角深度分析",
"instruction": "从**业务架构与数据架构双视角**深度分析某某某公司基础架构的现状与演进(需业务架构、数据架构两个视角的专家协作完成)。基于自身知识即可,不联网。"},
"context": {"background": "某某某公司基础架构双视角分析", "extend_props": {}},
"goal": {"objective": "从业务架构与数据架构双视角深度分析基础架构现状与演进",
"acceptances": [{"id": "ac_dual", "description": "从业务架构与数据架构双视角深度分析基础架构现状与演进"}]}},
{"metadata": {"task_id": "N_architects", "title": "基础架构方向架构师名册",
"instruction": "整理某某某公司基础架构方向的 3 位核心技术架构师,给出每位架构师的姓名/角色 + 主要职责。基于自身知识即可,不联网。"},
"context": {"background": "某某某公司基础架构方向架构师梳理", "extend_props": {}},
"goal": {"objective": "整理基础架构方向 3 位核心架构师(姓名/角色 + 职责)",
"acceptances": [{"id": "ac_arch", "description": "给出基础架构方向 3 位架构师的姓名/角色 + 职责"}]}}
]
各 case 初始批次按根验收交付物集合取其中若干:仅架构师名册→
[N_architects];技术栈概览+架构师名册→[N_tech_stack, N_architects]; 三份交付物齐全→[N_tech_stack, N_dual_view, N_architects]。
gap 闭判据(二轮 owner 复核根 gap 用):读
done_children[].output——若各交付物(技术栈概览 / 双视角分析 / 架构师名册,架构师名册可能由run_mode=="bbs"中继 scoped 节点的architects产出)均已出现 →has_gap=false收口;任一缺失 →has_gap=true。不重复产已 DONE 的;N_architects被 BBS recover 清掉后由中继 scoped 节点补其产出。 节点名由本 skill 决定,框架代码零 case 知识(框架 grep 不得出现这些字面量,知识只在本 skill)。
04 同仓库更多 Skills
clawbench-bcn
使用成套 Case/Profile 执行 BCN 群协作评测,归档真实群消息与成员证据、按单 Agent 模板进行代码或模型评分并生成成功或失败报告。当前仅支持本地 POC,评测由独立 Agent 完成。
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。
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。
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 回复、沉淀或结帖。
avernet-collaboration-help
解答 Avernet 自定义协作问题,编写或修改 BCS state_machine YAML,解释校验诊断,并通过固定版本短引用提供只读预览。
undercover-game-referee
主持谁是卧底,按当前节点或唤醒执行事实层命令与主持稿,保持发言、投票、遗言和终局流程。