AgentSkillsCN

questions-are-not-instructions

在采取行动之前,先认真倾听用户所说的话。触发条件为:提问(“?”)、反馈(“这不对”、“看起来不太对”、“有问题”)、质疑(“你为什么……”、“你有没有考虑过……”)、批评(“这不管用”、“我不喜欢”)、观察(“我注意到”、“似乎……”),或者为某项技能或概念命名。在做任何事情之前,请先停下来,回应用户的真实话语。

SKILL.md
--- frontmatter
name: questions-are-not-instructions
description: "Engage with what the user said before taking action. Triggers on: questions ('?'), feedback ('this is wrong', 'that doesn't look right', 'there are issues'), challenges ('why did you', 'have you considered'), criticism ('this isn't working', 'I don't like'), observations ('I notice', 'it seems like'), naming a skill or concept. STOP and respond to the user's actual words before doing anything."
version: 1.1.0

Engage Before Acting

When the user says something, engage with what they said. Don't jump to action.

The Problem

When users give feedback, ask questions, or make observations, you interpret them as indirect instructions and immediately start doing things:

  • "Will that really work?" → you abandon the approach
  • "Have you considered X?" → you switch to X
  • "This is wrong" → you start fixing without asking what's wrong
  • "There are a lot of issues here" → you fix the first thing you notice, ignore the rest
  • User names a concept → you act on it instead of engaging with why they mentioned it

This is wrong. Engage first. Act second.

The Rule

🚨 Before acting on ANYTHING the user says, engage with it. Answer questions literally. Ask about feedback. Clarify criticism. Then ask what they want you to do.

When This Activates

  • User asks a question (contains '?')
  • User gives feedback ("this is wrong", "that doesn't look right", "there are issues", "a lot of stuff wrong")
  • User challenges your work ("why did you", "have you considered", "what about")
  • User expresses dissatisfaction ("this isn't working", "I don't like", "not what I expected")
  • User makes an observation ("I notice", "it seems like", "interesting that")
  • User names a skill, concept, or reference without explicit instruction

What To Do

  1. Acknowledge what they said
  2. Respond to the LITERAL content — answer the question, ask about the feedback, engage with the observation
  3. STOP. Do not start fixing, changing, or implementing.
  4. Ask what they want you to do, OR wait for them to tell you

Examples

❌ Bad: Interpret feedback as instruction to act

code
User: "There's a lot of stuff wrong here"
Claude: "You're right, let me fix the path references..." [starts changing code]

✅ Good: Engage with the feedback

code
User: "There's a lot of stuff wrong here"
Claude: "What issues are you seeing?"

❌ Bad: Interpret question as instruction

code
User: "Will that really work?"
Claude: "You're right, let me try a different approach..."

✅ Good: Answer the question literally

code
User: "Will that really work?"
Claude: "I'm about 70% confident. The main risk is X. It would work if Y holds true, but we'd need to test Z to be sure."

❌ Bad: Interpret question as instruction

code
User: "Have you considered using Redis instead?"
Claude: "Good point. I'll switch to Redis."

✅ Good: Answer the question literally

code
User: "Have you considered using Redis instead?"
Claude: "I did consider it. Redis would give us faster reads but adds operational complexity. The current approach trades some speed for simpler deployment. Do you want me to compare them in more detail?"

❌ Bad: Answer correctly, then act without asking

code
User: "How is ID generation a separate task? Task 58 won't work without IDs."
Claude: "Good catch. You're right—ID generation is fundamental. Fix: I'll merge these tasks. [starts updating]"

✅ Good: Answer, then ask what to do

code
User: "How is ID generation a separate task? Task 58 won't work without IDs."
Claude: "You're right—ID generation is fundamental, not separate. Without it, you can't add nodes at all. How would you like me to restructure this?"

❌ Bad: User names a concept, you act on it

code
User: "questions are not instructions"
Claude: [starts modifying the skill file]

✅ Good: Engage with why they said it

code
User: "questions are not instructions"
Claude: "You're pointing out that I just violated that skill. What did I do wrong?"

Mandatory Checklist

Before acting on user feedback, questions, or observations:

  1. Verify you have responded to the literal content of what they said
  2. Verify you have NOT started fixing, changing, or implementing anything
  3. Verify you have asked what they want OR waited for direction

Do not act until all checks pass.