commit 801cc32968b7a5cd0e5883a6938c23fe536f5ed1 Author: qwenpaw-skills Date: Sun Aug 9 00:39:48 2026 +0000 Publish make_plan via gitea-publish skill diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..a73f148 --- /dev/null +++ b/SKILL.md @@ -0,0 +1,197 @@ +--- +name: make_plan +description: For external plan request scenarios, guides the Agent to request a clear, actionable, step-by-step plan from a stronger Agent via list_agents and chat_with_agent, emphasizing that the plan is executed by the requester, not by the consulted Agent. +metadata: + builtin_skill_version: "1.3" + qwenpaw: + emoji: "🗺️" +--- + +# Make Plan + +Use this Skill when you need to make an **external plan request** to a stronger Agent. + +The goal of this Skill is not to outsource a task, but rather to: +- Request a plan from a stronger Agent +- The plan must consist of **clear, actionable steps** +- **You execute the plan yourself** +- Do not ask the consulted Agent to execute the task directly + +How to invoke: +- Use `list_agents()` to check available Agents +- Use `chat_with_agent(...)` to request the stronger Agent to "make a plan" +- In `text`, explicitly include the prompt: **only provide a step-by-step executable plan, do not execute** +- To supplement or refine the original plan in a follow-up, pass `session_id` + +Recommended invocation skeleton: + +```text +list_agents() + +chat_with_agent( + to_agent="", + text="[Agent requesting] Please help me create an execution plan for the following task. You do not need to execute the task -- just output clear, actionable steps in order.", +) +``` + +## Core Rules + +This Skill handles one thing only: +1. Find a stronger Agent +2. Request that Agent to output an execution plan +3. Require the plan to be step-by-step, actionable, and in sequential order +4. You execute the plan yourself rather than asking the other Agent to do it for you + +If what you truly need is a "plan", use this Skill. +If what you need is a final answer, architectural judgment, review conclusion, or direct execution, do not misuse this Skill. + +## Applicable Scenarios + +The following scenarios are suitable for making an external plan request: +- The task requires multi-step decomposition +- Steps have dependencies between them +- A clear sequence, checkpoints, or verification points are needed +- Multiple modules, files, systems, or roles are involved +- The user explicitly requests a plan before execution +- You want to obtain a more complete and reliable execution path first + +## Do Not Use This Way + +Do not use this Skill in the following situations: +- You actually want the other Agent to do the task for you +- What you really lack is a small piece of factual information, not a plan +- What you truly need is an architectural judgment or solution comparison +- You have not yet clearly understood the task objective + +## What to Ask the Stronger Agent For + +When calling `chat_with_agent(...)`, clearly state: +- **You need a plan, not execution** +- **Steps must be concrete, not just abstract advice** +- **Preferably include verification methods and completion criteria** + +## Tool Invocation Rules + +Execute in this order by default: +1. Call `list_agents()` to confirm available stronger Agents +2. Select the most suitable target Agent for creating the plan +3. Call `chat_with_agent(...)` to request the generation of an execution plan +4. After receiving the plan, execute it yourself -- do not continue outsourcing the task to the other Agent + +When requesting the plan, explicitly state: +- Only the plan is needed, not execution +- Steps must be specific, not general advice +- Clearly request sequence, dependencies, checkpoints, and verification methods when needed + +Common parameters for `chat_with_agent`: +- `to_agent`: Target Agent ID +- `text`: Request content; must explicitly state "only output the plan, do not execute the task" +- `session_id`: Optional; pass this to continue an existing conversation + +Notes: +- `base_url` generally does not need to be provided; the tool will automatically resolve the current API address +- Not passing `session_id` will automatically create a new session + +## Request Template + +Please help me create an execution plan for the following task. +You **do not need to execute the task itself** -- just output the plan. + +Task: +[What needs to be done] + +Goal: +[What the final outcome should be] + +Constraints: +- [...] +- [...] + +Plan requirements: +1. Break it down into clear, executable steps +2. Indicate the recommended order +3. Point out dependencies, checkpoints, or verification methods where necessary +4. If there are obvious risks, include key points to watch out for + +Output format: +[e.g., Output 5-8 numbered steps, 1-3 sentences each] + +Example: + +```text +chat_with_agent( + to_agent="strong_reasoner", + text=""" +Please help me create an execution plan for the following task. +You do not need to execute the task itself -- just output the plan. + +Task: +Modify a multi-module feature. + +Goal: +Complete the change with low risk and avoid missing integration points. + +Constraints: +- Minimize rework +- Include verifiable intermediate checkpoints + +Plan requirements: +1. Break it down into actionable steps +2. Indicate the recommended order +3. Mark key dependencies and checkpoints +4. Include verification methods where possible + +Output format: +Please output 3-5 numbered steps, each as specific as possible. +""", +) +``` + +For follow-up conversations: + +```text +chat_with_agent( + to_agent="strong_reasoner", + text="Based on the previous plan, please further refine the checkpoints for steps 3 and 4. Still only provide the plan -- do not execute the task.", + session_id="", +) +``` + +## What to Do After Receiving the Plan + +Treat the stronger Agent's reply as "execution plan input", not as "the task is already done". + +What you should do: +1. Distill the truly executable steps +2. Determine whether adjustments are needed for your environment +3. Execute the steps yourself +4. If new uncertainties arise, continue refining the plan + +Do not deliver the plan as-is to the user as a final result, unless the user specifically asked for the plan itself. + +## Plan Quality Standards + +A qualified plan should at least meet the following criteria: +- Has clear steps, not vague advice +- Step order is clear +- Each step is an executable action +- Key dependencies are identified +- Necessary verification points are included +- Does not secretly delegate "task execution" to the consulted Agent + +If what you receive is vague advice such as "first analyze, then implement, then test", it is not sufficient -- follow up to request refinement. + +## Behavioral Guardrails + +- Do not turn "please help me plan" into "please do the whole thing for me" +- Do not request the other Agent to execute code, commands, or changes on your behalf +- Do not accept answers that only provide direction without steps +- Do not request a plan when the task objective is not yet clear +- Do not stop thinking after receiving the plan -- still evaluate it against your current environment + +## Final Principle + +When you lack an execution path, request a plan first. +The plan must be step-by-step, specific, and actionable. +The consulted Agent is responsible for producing the plan, not for executing it. +After receiving the plan, the requester executes it themselves.