개발자 "잘" 말하고 "잘" 쓰기 + 꿀팁 추가
AI가 대두되는 요즘, 개발자에게는 코딩 실력만으로는 부족합니다.
비즈니스를 이해하고 효과적으로 소통하는 능력이 더욱 중요해졌습니다.
이런 종합적인 역량은 불필요한 의사소통 비용을 줄이고 효율적인 개발로 이어져,
결국 회사와 개발자 본인의 가치를 높이는 핵심 요소가 됩니다.
현대 개발자는 기술과 비즈니스의 균형을 맞추며, 이를 명확히 전달할 수 있어야 합니다.
아래의 글들을 통해 자신의 능력을 올리는데 도움이 되었으면 좋겠습니다.
⬇️ 꿀팁은 맨아래
🌠 목차
✅ SCQA를 생각하자
✅ 조사를 제거하자
✅ 듣는이를 고려하자
SCQA를 생각하자
✅ 업무 커뮤니케이션의 기본 구조를 SCQA를 생각하고 말하자
SCQA란?
상황(Situation) - 현재 상황/배경 설명
- "AI 반환 실행 횟수 초과 에러 관련하여 문의 드립니다."
복잡성(Complication) - 문제점/이슈 설명
- "현재 개발팀 내부에서 해당 에러로 인한 노이즈가 있어..."
질문(Question) - 확인하고 싶은 내용
- "혹시 이 에러 현상을 모니터링하고 계신가요?"
행동(Action) - 제안/요청사항
- "비활성화를 고려 중입니다."
한 번 원본과 SCQA를 적용한 수정본을 봐보자.
SQCA 적용
원본:
"OO님 AI 결과값 반환 실행 횟수 초과 에러 보고 계신가요?
개발팀 내부에서 레시피 AI 반환 에러가 노이즈해서 끄고자 하는 니즈가 있어서 확인 차 말씀드립니다"
수정본:
"결과값 반환 실행 횟수 초과 에러 관련하여 문의 드립니다.
현재 개발팀 내부에서 해당 에러로 인한 노이즈가 있어 비활성화를 고려 중입니다.
혹시 이 에러 현상을 모니터링하고 계신가요?"
주요 차이점:
- 구조화
- 원본: 한 문장에 여러 내용이 혼재
- 수정본: 상황 설명 → 문제점 → 질문 순으로 구조화
- 전문성
- 원본: "니즈가 있어서", "노이즈해서" 등 구어체 사용
- 수정본: "비활성화를 고려 중입니다" 등 공식적인 표현 사용
- 명확성
- 원본: 의도가 간접적으로 표현됨
- 수정본: 문제 상황과 확인하고자 하는 내용이 명확히 구분됨
실제 적용 예시들:
- 단순 확인이 필요할 때:
OO 기능 배포 관련 문의드립니다.
현재 배포 가능한 상태인가요? - 문제 해결이 필요할 때:
[상황] 프로덕션 환경의 API 응답 지연이 발생하고 있습니다.
[복잡성] 현재 평균 응답시간이 2초를 초과하고 있으며, 사용자 불만이 접수되고 있습니다.
[잘문] 혹시 이 현상을 인지하고 계신가요?
[행동] 긴급 대응이 필요할 것 같아 회의를 제안드립니다.
이런 구조로 작성하면:
- 메시지의 목적이 명확해집니다
- 받는 사람이 빠르게 이해할 수 있습니다
- 필요한 액션을 쉽게 파악할 수 있습니다
조사를 제거하자
수정전
OO님 AI 결과값을 반환하기위해 실행 횟수 초과 에러를 보고 계신가요?
개발팀 내부에서 AI의 반환 에러가 노이즈해서 끄고자 하는 니즈가 있어서 확인 차 말씀드립니다
수정후
OO님 AI 결과값 반환 실행 횟수 초과 에러를 보고 계신가요?
개발팀 내부에서 AI 반환 에러가 노이즈해서 끄고자 하는 니즈가 있습니다.
듣는이를 고려하자
상대가 비개발직군이거나, 해당 도메인에 대한 지식이 없다고 할 때
개발자의 언어로 말을 한다면 1도 이해할 수 없는 상황에 놓이게 될 것입니다.
기술적 용어보다는 현재 발생하고, 해결하고자 하는 "모두가 알 수 있는 단어"로 설명합니다.
ex:
QA에서 API에러가 발생해서 안되나봐요
다음과 같이 고쳐봅시다.
테스트환경에서 백엔드에 문제가 있어서 안되나봐요
(보통 이정도는 이해하겠지라는 생각을 할까봐 극적인 예시를 가져왔습니다.)
1. QA가 누군가한테는 테스트 환경, 브랜치, 검수 과정으로 해석될 수 있습니다. 정확한 의미를 전달합시다.
2. API에서 에러가 어떻게 발생했고, 무엇이 문제인지 "관심 없는 경우가 많습니다." 그래서 말하고자 하는바가 무엇인지에 집중하세요.
말을 하거나 글이 어려운게 결론부터 말을 하고 시작할지, 상황을 먼저 말해야할지, 결론이 2개인것 같기도합니다.
이런 경우들을 기술이 포함되어 있는 경우는 더 말을 복잡하게 만듭니다.
SCQA 구조를 꼭 기억하셔서 회사 생활에 도움이 되었으면 좋겠습니다!
항상 자연스러운 문맥구조와 듣는이를 고려해서 말해봐요~!
⭐️ 꿀팁
내가 글 쓰는게 너무 어렵다! 싶으면
gpt, claud, 잼민아이에 "SCQA 구조로 변경해줘" 라고 하면 알아서 잘 해줍니다!
글 잼나게 보셨으면 좋아요 눌러주고 가세요
관심받는 거 좋아합니다
