Agent Skills
返回列表
QClaw 结构化任务执行

QClaw 结构化任务执行

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f8c4945a/a8125b81-4e91-11f1-a3d1-00155d4133b5。

技能介绍

问题背景

当用户让 Agent 完成「改多个文件」「分阶段上线」「跨模块协作」这类任务时,模型很容易一口气连推好几步、中途卡住却不说明原因,或在计划未对齐时就开始改代码。结果是进度不可见、用户无法插话纠偏,失败时也难以复盘是哪一步出了问题。

技能如何工作

本技能来自 QClaw 的多步骤任务执行规范,触发后覆盖默认行为,要求按三阶段强制执行:

  1. 启动:收到任务后必须先输出【执行计划】——分步编号、每步写清「动作 + 预期产出」、标明总步数。
  2. 执行:每完成一步要汇报「已完成/总步数」、简述本步结果、@用户 确认后再进入下一步;不得在未得到「继续/调整/终止」前推进下一步。
  3. 收尾:全部完成后输出【任务完成】总览、汇总产出,并询问是否需要补充。

异常场景有硬性表:卡住、逻辑循环、长时间无输出(>30 秒)、指令模糊时,必须停步并报告,不得擅自猜测或静默重试。执行前后还有自检清单,用于核对计划、确认与等待是否到位。

适用边界与注意点

  • 适合:步骤多、跨文件/跨模块、需要持续对齐进度的长任务。
  • 不适合:单步问答、只需一次工具调用的极简操作——强制分步反而拖慢节奏。
  • 协作成本:每步都要用户确认;若你希望 Agent 自主跑完再审查,需在对话里明确放宽,否则技能会按「单步等待」执行。

技能说明写明:触发后不得跳过或合并步骤。

使用场景

  • 用户要求按文件类型整理桌面或项目目录,需要先列出分类规则再逐步移动并每步确认
  • 跨多个模块改接口与调用方,需要分阶段改代码、跑检查并在每步后等待是否继续
  • 长时间重构任务(如统一命名或迁移配置),需要持续汇报「已完成步数/总步数」避免静默连推
  • 用户指令涉及多动作但表述模糊时,Agent 必须先澄清或停步报告,而不是猜测执行

适合人员

  • 负责分阶段上线功能的后端,需要在改库表、改服务、改前端之间逐步推进并随时叫停
  • 维护单体或多包仓库的工程师,一次任务会动多个目录,希望每步看到产出再决定是否继续
  • 用 Agent 做桌面或资料整理的个人用户,担心 AI 一口气删改文件,需要逐步确认每一步结果
  • 带新人或外包协作的技术负责人,希望任务过程有编号计划与步骤留痕,便于复盘卡点