QClaw 结构化任务执行
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f8c4945a/a8125b81-4e91-11f1-a3d1-00155d4133b5。
技能介绍
问题背景
当用户让 Agent 完成「改多个文件」「分阶段上线」「跨模块协作」这类任务时,模型很容易一口气连推好几步、中途卡住却不说明原因,或在计划未对齐时就开始改代码。结果是进度不可见、用户无法插话纠偏,失败时也难以复盘是哪一步出了问题。
技能如何工作
本技能来自 QClaw 的多步骤任务执行规范,触发后覆盖默认行为,要求按三阶段强制执行:
- 启动:收到任务后必须先输出【执行计划】——分步编号、每步写清「动作 + 预期产出」、标明总步数。
- 执行:每完成一步要汇报「已完成/总步数」、简述本步结果、@用户 确认后再进入下一步;不得在未得到「继续/调整/终止」前推进下一步。
- 收尾:全部完成后输出【任务完成】总览、汇总产出,并询问是否需要补充。
异常场景有硬性表:卡住、逻辑循环、长时间无输出(>30 秒)、指令模糊时,必须停步并报告,不得擅自猜测或静默重试。执行前后还有自检清单,用于核对计划、确认与等待是否到位。
适用边界与注意点
- 适合:步骤多、跨文件/跨模块、需要持续对齐进度的长任务。
- 不适合:单步问答、只需一次工具调用的极简操作——强制分步反而拖慢节奏。
- 协作成本:每步都要用户确认;若你希望 Agent 自主跑完再审查,需在对话里明确放宽,否则技能会按「单步等待」执行。
技能说明写明:触发后不得跳过或合并步骤。
使用场景
- 用户要求按文件类型整理桌面或项目目录,需要先列出分类规则再逐步移动并每步确认
- 跨多个模块改接口与调用方,需要分阶段改代码、跑检查并在每步后等待是否继续
- 长时间重构任务(如统一命名或迁移配置),需要持续汇报「已完成步数/总步数」避免静默连推
- 用户指令涉及多动作但表述模糊时,Agent 必须先澄清或停步报告,而不是猜测执行
适合人员
- 负责分阶段上线功能的后端,需要在改库表、改服务、改前端之间逐步推进并随时叫停
- 维护单体或多包仓库的工程师,一次任务会动多个目录,希望每步看到产出再决定是否继续
- 用 Agent 做桌面或资料整理的个人用户,担心 AI 一口气删改文件,需要逐步确认每一步结果
- 带新人或外包协作的技术负责人,希望任务过程有编号计划与步骤留痕,便于复盘卡点