Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
中文简介正在准备中。当前显示原文说明。
Navigate difficult conversations and deliver constructive feedback using structured frameworks. Covers the Preparation-Delivery-Follow-up model and Situation-Behavior-Impact (SBI) feedback technique. Use when preparing for difficult conversations, giving feedback, or managing conflicts.
中文简介正在准备中。当前显示原文说明。
查看安装方法安装前可以查看交给 AI 代理的指令内容。
This skill provides frameworks for navigating difficult workplace conversations and delivering effective feedback. Whether you're addressing performance issues, resolving conflicts, or giving constructive feedback, these structured approaches lead to better outcomes.
Core insight: Research shows that employees who approach difficult conversations with preparation and a clear framework are 60% more likely to reach a positive resolution than those who engage without a plan.
Use this skill when:
Keywords: feedback, difficult conversation, 1:1, one-on-one, performance, conflict, expectations, behavior, confrontation
A three-part structure for difficult conversations:
| Phase | Focus | Key Questions |
|---|---|---|
| Preparation | Understand the issue, define goals, manage emotions | What's the problem? What outcome do I want? Am I calm? |
| Delivery | Open neutrally, use facts not blame, encourage dialogue | How do I start? What evidence do I have? How do I involve them? |
| Follow-up | Document actions, set check-ins, provide support | What did we agree to? When will we check in? How do I support? |
Situation-Behavior-Impact (SBI) structures feedback to be specific, objective, and actionable:
| Component | Description | Example |
|---|---|---|
| Situation | Describe the specific context | "During yesterday's code review..." |
| Behavior | State the observable action (not interpretation) | "...you interrupted Sarah three times while she was explaining her approach..." |
| Impact | Explain the effect on team/project/person | "...which made her hesitate to share ideas and slowed down our discussion." |
Why it works: SBI removes assumptions and focuses on observable facts, reducing defensiveness.
Ask yourself:
Before the conversation, clarify what you're seeking:
| Goal Type | Example |
|---|---|
| Behavior change | "I want them to submit code reviews on time" |
| Mutual understanding | "I want to understand what's blocking them" |
| Expectation setting | "I want to clarify what 'done' means for features" |
| Problem solving | "I want to find a solution together" |
Tip: Use if-then statements to clarify stakes:
"If this behavior continues, then the project timeline will suffer, leading to missed deliverables."
High emotional intensity reduces cognitive processing by 30%. Before the conversation:
Reframing technique:
| Accusatory | Constructive |
|---|---|
| "You always miss deadlines and it slows everyone down" | "I've noticed some recent delays and want to understand any challenges you're facing" |
| "You never test your code properly" | "I've seen a few bugs slip through recently. Let's talk about our testing process" |
| Context | Opening |
|---|---|
| General | "I want to talk about something important to our team's success, and I'd love to hear your perspective." |
| Performance | "I've noticed some patterns I'd like to discuss. My goal is to support you, not criticize." |
| Conflict | "I sense there might be some tension, and I'd like to understand what's happening from your side." |
| Expectations | "I want to make sure we're aligned on expectations. Can we talk through how this project is going?" |
| Blaming | Factual |
|---|---|
| "You're not committed to this project" | "I've noticed your updates have been brief in our last three meetings. Is something affecting your workload?" |
| "You don't care about code quality" | "This PR had 12 bugs caught in QA. Let's talk about what happened and how we can improve" |
| "You're always late" | "The standup started at 9:00 and you joined at 9:15 the last three days. What's going on?" |
Key principles:
After stating your observation, shift to collaboration:
| Situation | Dialogue Prompt |
|---|---|
| Understanding barriers | "What's been challenging about this?" |
| Seeking their view | "How do you see the situation?" |
| Finding solutions | "What would help you succeed here?" |
| Checking alignment | "Does this match your understanding of what happened?" |
Even successful conversations need follow-through to create lasting change.
Hi [Name],
Thanks for the conversation yesterday. I appreciated your openness.
**What we agreed to:**
- [Action item 1] - [Timeline]
- [Action item 2] - [Timeline]
**Check-in:** Let's reconnect [date] to see how things are going.
I'm here if you need any support. Thanks for working through this with me.
Best,
[Your name]
Code Review:
Situation: "During Tuesday's code review for the authentication module..." Behavior: "...you provided detailed comments on potential security vulnerabilities and suggested efficient fixes..." Impact: "...which strengthened our security posture and saved the team hours of debugging later."
Collaboration:
Situation: "In yesterday's architecture discussion..." Behavior: "...you asked clarifying questions and built on others' ideas instead of pushing your own solution..." Impact: "...which helped us reach consensus faster and made everyone feel heard."
Missed Deadlines:
Situation: "When we were finalizing the API deployment last Thursday..." Behavior: "...your testing results came in two hours after our agreed cutoff..." Impact: "...which delayed the release, risked our SLA, and caused the QA team to work overtime."
Meeting Behavior:
Situation: "In our sprint planning yesterday..." Behavior: "...you were on your phone for most of the discussion and didn't contribute when we asked for estimates..." Impact: "...which left the team without your expertise on the backend stories and made others feel their time wasn't valued."
For more examples: See references/feedback-sbi-model.md
Situation: A developer consistently delivers code with bugs.
Approach:
Situation: Two engineers disagree on technical approach and it's affecting the team.
Approach:
Situation: Leadership wants a feature in half the time needed.
Approach:
For detailed scripts: See references/difficult-conversation-scripts.md
When you're on the receiving end:
references/feedback-sbi-model.md - Full SBI framework with more examplesreferences/difficult-conversation-scripts.md - Opening lines and responsesreferences/expectation-alignment.md - Managing stakeholder expectations还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
中文简介正在准备中。当前显示原文说明。
Create API handoff documentation for frontend developers. Use when backend work is complete and needs to be documented for frontend integration, or user says 'create handoff', 'document API', 'frontend handoff', or 'API documentation'.
中文简介正在准备中。当前显示原文说明。
Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize software structure, create C4 diagrams, or generate context/container/component/deployment diagrams. Triggers include "architecture diagram", "C4 diagram", "system context", "container diagram", "component diagram", "deployment diagram", "document architecture", "visualize architecture".
中文简介正在准备中。当前显示原文说明。
Use when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing. Uses GPT-5.2 by default for state-of-the-art software engineering.
中文简介正在准备中。当前显示原文说明。
This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable command. Essential for creating optimized, agent-executable slash commands with proper structure and best practices.
中文简介正在准备中。当前显示原文说明。
Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits). Use when the user asks to commit, craft a commit message, stage changes, or split work into multiple commits.
中文简介正在准备中。当前显示原文说明。