$npx -y skills add agentscope-ai/QwenPaw --skill make_plan-zh当需要向更强 Agent 请求执行计划时使用;用于获取分步骤、可落地的计划,并由你自己执行,而不是让对方代执行任务。
| 1 | # 制定计划 |
| 2 | |
| 3 | 当你需要向更强 Agent 发起一次**外部计划请求**时,使用本 Skill。 |
| 4 | |
| 5 | 本 Skill 的目标不是把任务外包出去,而是: |
| 6 | - 向更强 Agent 要一份计划 |
| 7 | - 这份计划必须是**明确的执行步骤** |
| 8 | - **由你自己按计划执行** |
| 9 | - 不要求被求助的 Agent 直接动手执行任务 |
| 10 | |
| 11 | 调用步骤: |
| 12 | 1) 使用 `list_agents()` 查可用 Agent 的 ID |
| 13 | - 可根据返回的描述信息选择最合适的 Agent 来求助 |
| 14 | - 如果找不到非常合适的 Agent,就选择 default |
| 15 | - 注意区分 Agent 的 ID 和 Name,后续调用需要的是 ID |
| 16 | |
| 17 | 2) 使用 `chat_with_agent(...)` 向更强 Agent 请求“制定计划” |
| 18 | - `to_agent` 传目标 Agent ID |
| 19 | - `text` 中明确给出提示**仅需给出可按步骤执行的计划,不要执行** |
| 20 | |
| 21 | 3) 收到回复后,记录对话的 `session_id`,并提炼出真正可执行的步骤,并由你自己执行 |
| 22 | - 如果有不清楚的地方可以继续追问细化计划,但仍然要强调**只补计划,不要代执行** |
| 23 | - 追问仍使用 `chat_with_agent(...)`,并传入记录的 `session_id` 以保持上下文 |
| 24 | |
| 25 | 推荐调用骨架: |
| 26 | |
| 27 | ```text |
| 28 | list_agents() |
| 29 | |
| 30 | chat_with_agent( |
| 31 | to_agent="stronger_agent", |
| 32 | text="[Agent <auto> requesting] 请帮我为下面任务制定执行计划。你不需要执行任务,只需要输出明确、可落地、按顺序排列的步骤。", |
| 33 | ) |
| 34 | ``` |
| 35 | |
| 36 | ## 适用场景 |
| 37 | |
| 38 | 以下场景适合直接发起外部计划请求: |
| 39 | - 任务需要多步拆解 |
| 40 | - 步骤之间有依赖关系 |
| 41 | - 需要明确先后顺序、检查点或验证点 |
| 42 | - 涉及多个模块、文件、系统或角色 |
| 43 | - 用户明确要求先给出计划 |
| 44 | - 你希望先拿到一份更完整、更稳妥的执行路径 |
| 45 | |
| 46 | ## 不要这样用 |
| 47 | |
| 48 | 以下情况不要用本 Skill: |
| 49 | - 你其实是想让对方直接替你做任务 |
| 50 | - 真正缺的是一个小事实,而不是计划 |
| 51 | - 真正需要的是架构判断或方案比较 |
| 52 | - 你连任务目标都没理解清楚 |
| 53 | |
| 54 | ## 向更强 Agent 要什么 |
| 55 | |
| 56 | 调用 `chat_with_agent(...)` 时要明确说明: |
| 57 | - **你需要的是计划,不是代执行** |
| 58 | - **步骤必须具体,不能只给抽象建议** |
| 59 | - **最好包含验证方式与完成标志** |
| 60 | |
| 61 | ## 求助模板 |
| 62 | |
| 63 | 请帮我为下面任务制定一份执行计划。 |
| 64 | 你**不需要执行任务本身**,只需要输出计划。 |
| 65 | |
| 66 | 任务: |
| 67 | [要做什么] |
| 68 | |
| 69 | 目标: |
| 70 | [最终想达到什么结果] |
| 71 | |
| 72 | 约束: |
| 73 | - [...] |
| 74 | - [...] |
| 75 | |
| 76 | 计划要求: |
| 77 | 1. 拆成明确、可执行的步骤 |
| 78 | 2. 标明推荐顺序 |
| 79 | 3. 必要时指出依赖、检查点或验证方式 |
| 80 | 4. 如果有明显风险,补充关键注意点 |
| 81 | |
| 82 | 输出格式: |
| 83 | [例如:输出 5-8 个编号步骤,每步 1-3 句] |
| 84 | |
| 85 | `chat_with_agent` 请求示例: |
| 86 | |
| 87 | ```text |
| 88 | chat_with_agent( |
| 89 | to_agent="strong_agent", |
| 90 | text=""" |
| 91 | 请帮我为下面任务制定一份执行计划。 |
| 92 | 你不需要执行任务本身,只需要输出计划。 |
| 93 | |
| 94 | 任务: |
| 95 | 修改一个多模块功能。 |
| 96 | |
| 97 | 目标: |
| 98 | 以较低风险完成改动,并避免遗漏联动点。 |
| 99 | |
| 100 | 约束: |
| 101 | - 尽量减少返工 |
| 102 | - 需要保留可验证的中间检查点 |
| 103 | |
| 104 | 计划要求: |
| 105 | 1. 拆成可落地的步骤 |
| 106 | 2. 标明推荐顺序 |
| 107 | 3. 标出关键依赖和检查点 |
| 108 | 4. 尽量包含验证方式 |
| 109 | |
| 110 | 输出格式: |
| 111 | 请输出 3-5 个编号步骤,每步尽量具体。 |
| 112 | """, |
| 113 | ) |
| 114 | ``` |
| 115 | |
| 116 | `chat_with_agent` 回复示例: |
| 117 | ```text |
| 118 | [SESSION: xxx] |
| 119 | |
| 120 | 下面是我为你制定的执行计划: |
| 121 | |
| 122 | 1. ... |
| 123 | 2. ... |
| 124 | ``` |
| 125 | - 其中 `xxx` 是本次对话的 `session_id`,你需要记录下来以便后续追问细化,一般是一个较长的字符串,例如 `local_agent:to:strong_agent:1776406127168:e11b08d8` |
| 126 | |
| 127 | |
| 128 | `chat_with_agent` 追问示例(假设你想让对方细化第 3 步): |
| 129 | |
| 130 | ```text |
| 131 | chat_with_agent( |
| 132 | to_agent="strong_agent", |
| 133 | text="请基于刚才的计划,再细化第 3 步。仍然只需要补计划,不需要代执行任务。", |
| 134 | session_id="xxx", |
| 135 | ) |
| 136 | ``` |
| 137 | |
| 138 | ## 收到计划后怎么用 |
| 139 | |
| 140 | 把更强 Agent 的回复当作“执行计划输入”,不是“任务已经完成”。 |
| 141 | |
| 142 | 你应该做的是: |
| 143 | 1. 提炼出真正可执行的步骤 |
| 144 | 2. 判断是否需要按你的环境做微调 |
| 145 | 3. 由你自己执行这些步骤 |
| 146 | 4. 遇到新不确定性时,再继续细化计划 |
| 147 | |
| 148 | 不要把计划原样当成结果交付给用户,除非用户要的就是计划本身。 |
| 149 | |
| 150 | ## 计划质量标准 |
| 151 | |
| 152 | 一份合格的计划,至少应满足: |
| 153 | - 有明确步骤,而不是泛泛建议 |
| 154 | - 步骤顺序清楚 |
| 155 | - 每步是可执行动作 |
| 156 | - 关键依赖被点明 |
| 157 | - 有必要的验证点 |
| 158 | - 没有把“执行任务”偷偷转交给被求助 Agent |
| 159 | |
| 160 | 如果拿到的是空泛建议,例如“先分析,再实现,再测试”,这不够,需要继续追问细化。 |
| 161 | |
| 162 | ## 行为护栏 |
| 163 | |
| 164 | - 不要把“请帮我规划”说成“请你直接做完” |
| 165 | - 不要请求对方代替你执行代码、命令或变更 |
| 166 | - 不要接受只有方向、没有步骤的回答 |
| 167 | - 不要在目标不清楚时直接求计划 |
| 168 | - 不要拿到计划后就停止思考,仍要结合当前环境判断 |
| 169 | |
| 170 | ## 最终口诀 |
| 171 | |
| 172 | 缺执行路径,就先要计划。 |
| 173 | 计划必须分步、具体、能落地。 |
| 174 | 被求助 Agent 负责出计划,不负责代执行。 |
| 175 | 拿到计划后,由求助发起者自己执行。 |