AI 에이전트가 서로 주고받는 메시지를 오해 없이 전달하는 문법 규칙
에이전트가 다른 에이전트의 출력을 읽을 때, 문장의 모호함 때문에 의도와 다른 행동을 할 수 있습니다. 이 저장소는 항공 정비 매뉴얼에 쓰이는 단순 기술 영어(STE) 규칙을 AI 에이전트 간 통신에 맞게 재구성한 도구입니다. 복잡한 문장을 짧고 명확한 문장으로 바꿔, 기계가 읽어도 오해의 여지가 없게 만듭니다.
왜 항공 정비 규칙을 AI에 쓰나
항공 정비 현장에서 지시문을 잘못 읽으면 인명 피해로 이어질 수 있어, 한 단어에 하나의 의미만 허용하고 수동태를 배제하는 엄격한 규칙을 만들었습니다. AI 에이전트도 다른 에이전트의 출력을 해석할 때 '이게 무슨 뜻이었지?'라고 되묻는 채널이 없습니다. 같은 원리가 적용되어, 모호한 표현을 제거하면 다운스트림 에이전트가 도구 설명이나 오류 메시지를 정확히 이해할 가능성이 높아집니다.
문장을 어떻게 고치는가
이 도구는 입력된 영어 텍스트를 분석해 규칙 위반을 문장 단위로 찾아냅니다. 모호한 단어 선택, 복잡한 시제, 행위자가 불분명한 수동태, 한 문장에 여러 지시가 섞인 경우 등을 지적합니다. 각 문장을 다시 쓰되, 원래의 사실이나 조건, 범위 한정어는 하나도 빠뜨리지 않습니다. 더 짧은 표현이 정밀도를 해친다면 긴 표현을 유지하고 그 이유를 명시합니다. 최종 출력은 재작성된 텍스트만 제공하며, 변경 사항 요약이나 서론은 붙이지 않습니다.
검증의 한계와 주의할 점
내장된 린터는 세미콜론, 특정 구어체 동사, 명사화, 마케팅용 형용사, 수동태, 현재완료, 긴 문장, 동의어 반복, 연결사 누락 등 구조적 패턴만 검사합니다. 명사 군집 길이나 목록 밖의 구어체 동사는 검사하지 않으며, 헤지 표현이나 모달 동사는 절대 지적하지 않습니다. 위반 건수가 0건이라는 것은 설정된 구조적 검사에서 문제가 발견되지 않았다는 뜻일 뿐, 원문과 재작성본의 의미 보존이나 요구 사항 강도 유지까지 검증한 것은 아닙니다. 또한 ASD 공식 사전의 약 900개 승인 단어 목록을 재현하지 않으며, 인증된 STE 문서가 필요할 때는 실제 표준을 사용해야 합니다.
설치와 사용 방법
프로젝트 루트에서 npx skills add danyuchn/asd-ste100-skill을 실행하면 현재 프로젝트에 설치됩니다. 모든 프로젝트에서 사용하려면 저장소를 ~/.claude/skills/asd-ste100 경로로 클론합니다. 사용 시 '이 도구 설명을 명확하게 해줘'나 '에이전트가 오해하지 않도록 이 오류 메시지를 다시 써줘'라고 요청하면 됩니다. 적용된 규칙을 확인하려면 '차이를 보여줘'나 '변경 사항을 설명해줘'라고 추가 요청하면 규칙별 비교 표를 제공합니다.
이 도구가 적합한 대상
에이전트 간 메시지, 도구 함수 설명, 오류 메시지, 시스템 프롬프트 등 사람이 개입하지 않고 기계나 비모국어 사용자가 해석해야 하는 영어 텍스트에 적합합니다. 창작 글이나 마케팅 카피처럼 목소리와 뉘앙스가 중요한 콘텐츠에는 적합하지 않습니다. 이 도구는 텍스트의 형태를 고칠 뿐 내용은 바꾸지 않습니다. 내용이 빈약한 문단은 짧고 깔끔해지지만 여전히 빈약한 상태로 남습니다. MIT 라이선스로 배포되며, 텔레메트리 전송은 DISABLE_TELEMETRY=1 환경 변수로 비활성화할 수 있습니다.