ASD-STE100 표준을 활용한 Claude Code 스킬: 모호한 영어를 간결하고 기술적인 영어로 재작성

Claude Code 스킬 중 하나로, 밀도가 높고 모호한 영어 문장을 ASD-STE100 Simplified Technical English (STE) — 항공우주 및 방위 산업에서 항공기 정비 지침이 오독되는 것을 막기 위해 구축된 통제 언어 표준 — 로 재작성합니다.

이 스킬은 동일한 규율을 다른 독자, 즉 또 다른 에이전트의 출력을 파싱하는 AI 에이전트에게 적용합니다. 이는 도구 설명서, 오류 메시지 또는 에이전트 간 지침일 수 있으며, 모호성을 해결해 줄 인간 개입자가 없습니다.

STE는 항공기에서 오독된 지침 하나가 사람을 죽일 수 있기 때문에 존재하며, 원래 의도했던 독자들은 종종 명확히 할 작가를 부를 수 없는 비원어민들이었습니다. 이 표준의 해결책은 다음과 같습니다: 단어당 하나의 의미, 능동태(active voice), 단순 시제(simple tenses), 문장당 하나의 지침, 짧은 문장, 누락된 단어 없음.

또 다른 에이전트의 출력을 파싱하는 LLM 에이전트는 놀라울 정도로 유사한 위치에 있습니다. 즉, 백채널(back-channel)이 없고

examples/before-after.md에 공식 STE 규칙 자체의 예시를 포함하여 더 많은 예시가 있습니다.

• 모드를 선택합니다.
  Strict: 절차(procedures), 오류 메시지 및 도구 설명(tool descriptions)을 다룹니다.
  STE-flavored: README, PR 설명 및 설명적 산문(explanatory prose)을 다룹니다. STE-flavored는 문장 규율은 유지하지만 고정 어휘(fixed-vocabulary lockdown)를 강제하지 않습니다.
• 입력된 영어 텍스트의 의미를 읽습니다.
• 모든 규칙 위반 문장을 문장별로 표시합니다: 모호한 단어 선택, 현재 완료/복잡 시제(present-perfect/complex tense), 불분명한 행위자(unclear actor)를 가진 수동태, 다중 지침 문장, 과도한 명사구(oversized noun clusters), 누락된 단어(dropped words), 길이 초과 문장, 구동사(phrasal verbs), 명사화된 동작(nominalized actions), 세미콜론(semicolons), 완곡 표현(hedge stacks), 마케팅 형용사(marketing adjectives) 등.
• 각 표시된 문장을 다시 작성합니다 — 원본의 사실, 조건 또는 범위 한정자(scope qualifier)를 어느 것도 누락하지 않고. 만약 더 짧은 구문이 필요한 정밀도를 잃게 한다면, 조용히 단순화하는 대신 더 긴 구문을 유지하고 그 트레이드오프를 표시합니다.
• 재작성된 텍스트만 자체적으로 출력합니다 — 서두(preamble), 모드 공지, 변경 요약 없음 — 그리고 의도적으로 단순화하지 않은 경우 한 줄의 Kept as-is:

메모를 추가합니다.

추론을 요청하면(

결정론적 린터는 세미콜론, 소수의 구동사(soft phrasal verbs) 목록(spin up, reach out, dive into, kick off, circle back, touch base), 명사화(nominalizations), 마케팅 형용사, 수동태(passive voice), 현재완료형(present-perfect forms)(예: "has run"과 같은 불규칙 분사 포함), 긴 문장, 동의어 반복 사용, 지원되는 목록 항목 내의 매달린 접속사(dangling conjunctions)를 검사합니다. 이 린터는 명사구 클러스터 길이(이는 품사 태깅이 필요함)는 검사하지 않으며, 자체 목록에 없는 구동사는 알지 못하므로 "take off the panel"은 통과됩니다. 또한 완곡어법이나 양태(modality)를 절대 플래그 지정하지 않습니다.

저장소 자체의 산문도 깨끗하게 린트되지 않습니다: 규칙 테이블에는 금지하는 패턴이 인용되어 있으며, 일부 문장은 너무 길게 이어집니다. python scripts/ste-lint.py --baseline 41 SKILL.md로 린트하고 그 결과를 결함(defects)이 아닌 예시(examples)로 읽으십시오.

매달린 접속사 규칙은 줄의 시작 부분에 있으며, 선행 공백이 0개에서 3개이고 마커 뒤에 ASCII 공백이 있는 목록 마커를 검사합니다. 이 규칙은 순서가 없는 마커인 -, *, +와 끝이 . 또는 )인 순서가 있는 숫자 마커(예: 1. 또는 1))를 지원합니다. 이는 최종 의미 있는 줄까지 들여쓰기된 계속되는 줄을 검사합니다. 블록 인용구 내부, 게으른 연속 처리(lazy continuation), 또는 전체 중첩 목록 시맨틱스(nested-list semantics)의 목록 구문은 파싱하지 않습니다. 선행 공백이 4개 이상인 독립적인 줄은 목록 마커로 취급되지 않습니다. 활성 목록 항목 내에서 계산된 콘텐츠 열에서의 들여쓰기는 계속되는 텍스트로 처리됩니다. 구분선 감지(Fence detection)는 기존의 간단한 규칙을 따릅니다: 백틱 세 개 또는 물결표 세 개로 시작하는 제거된 줄은 구분선 상태를 토글합니다.

의도적으로 유효하지 않은 예시/린터 경계 사례 파일인 examples/linter-edge-cases.md는 불완전한 Markdown 목록 항목을 보여줍니다. python scripts/ste-lint.py examples/linter-edge-cases.md를 실행하여 린터가 예상되는 두 가지 결과를 보고하는지 확인하십시오. 이 파일은 테스트용 장치(test fixture)이며, 준수된 STE 산문으로 사용되어서는 안 됩니다.

이는 ASD의 공식 ~900단어 승인 사전을 재현하지 않습니다. 이 표준은 얻는 것은 자유롭지만 재배포하는 것은 자유롭지 않습니다: Issue 9는 ASD의 서면 권한이 있거나 본 프로젝트가 속하지 않은 여덟 가지 명시된 범주의 조직에 의해서만 복제가 허용합니다. 이 스킬은 고정된 단어 목록과 대조하는 대신, 근본적인 원칙(사용 가능한 가장 쉬운 단어, 매번 같은 방식으로 사용)을 적용합니다. 인증된 STE 준수 문서의 경우 실제 표준을 사용하십시오.

전체 규칙 요약 및 인용: references/writing-rules.md

.

이 스킬을 설치하는 가장 빠른 방법은 skills CLI입니다. 클론이나 경로 설정이 필요 없습니다. 프로젝트 루트에서 실행하세요:

npx skills add danyuchn/asd-ste100-skill

이렇게 하면 GitHub 리포지토리에서 스킬을 가져와 현재 프로젝트에 설치합니다. CLI는 skills.sh 리더보드에서 스킬 순위를 매기는 데 도움이 되도록 익명 설치 텔레메트리(스킬 이름 및 타임스탬프, 개인 또는 장치 정보 없음)를 전송합니다. 제외하려면 DISABLE_TELEMETRY=1을 설정하세요.

나중에 npx skills update로 업데이트할 수 있습니다.

.

git clone https://github.com/danyuchn/asd-ste100-skill ~/.claude/skills/asd-ste100

이렇게 하면 리포지토리를 ~/.claude/skills/에 클론하여 모든 Claude Code 프로젝트에서 스킬을 사용할 수 있게 합니다. 기여자나 git pull로 업데이트되는 라이브 체크아웃이 필요한 사람에게 가장 좋습니다.

다음과 같이 요청하여 영어 텍스트를 단순화하거나 명확하게 만드세요:

Disambiguate this tool description
Rewrite this error message so an agent can't misparse it
Apply ASD-STE100 to this instruction

또는 텍스트를 붙여넣고 Claude에게

다음 청크를 이어서 번역해주세요. 용어와 톤은 직전 청크와 일관되게 유지하세요.

⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.

Not built for: creative writing, marketing copy, or anything where voice and nuance are the point — STE is deliberately flat and literal by design.

One limit worth stating up front: this fixes the form of a text, not its substance. A paragraph with nothing to say comes out short, clean, and still empty.

• ASD-STE100 official site
• ASD-STE100 — About STE
• ASD Europe — Simplified Technical English
• Simplified Technical English — Wikipedia
• TechScribe — ASD-STE100 Simplified Technical English

MIT — see LICENSE.