Community라이팅 & 에디팅github.com

Jiansen/clear-output

중국어, 영어 또는 혼합 언어 설명, 비교, 계획, 요약 및 재작성을 단어, 다이어그램 또는 상호작용을 통해 명확히 합니다. 의미와 작업 언어를 유지합니다.

clear-output란 무엇인가요?

이 스킬은 사용자의 명확한 이해, 증거 검토, 그리고 적은 노력으로 결정을 내릴 수 있도록 돕는 것을 목표로 합니다. 사용자가 이해하거나 검증해야 할 것이 무엇인지 파악한 후, 표현 방식을 선택하고 문장을 다듬습니다. 출력 결과를 읽고, 탐색하고, 확인하는 데 소요되는 시간을 고려합니다. 이 스킬은 현재 작업에만 적용되며, 사용자가 요청하지 않는 한 영구적인 대화 모드로 만들지 않습니다. 주요 기능으로는 언어 선택, 의미 보존, 효과적인 표현 방식 선택, 작업에 맞는 구조화, 그리고 반환 전 확인이 포함됩니다. 언어 선택 시 사용자의 명시적 요청과 대화 언어를 따르며, 혼합 언어 기술 용어와 리터럴 콘텐츠를 보존합니다. 재작성 시 사실, 가정, 권장 사항 등을 명확히 구분하고 모호성을 유지하거나 필요한 정보를 식별합니다. 다이어그램, 표, 차트 등 독자의 작업 부하를 줄이는 시각적 표현을 적극적으로 고려하며, 사용 가능한 렌더링 기능을 활용하고 결과를 검사합니다. 출력 구조는 설명, 디버깅, 절차, 재작성 등 작업 유형에 맞게 조정되며, 짧고 명시적인 문장과 구체적인 동사를 선호합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, SKILL.md 문서에 명시된 원칙과 참조 파일을 기반으로 동작합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jiansen/clear-output-skill/tree/HEAD

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

명확한 출력(clear-output)

독자가 정확하게 이해하고, 증거를 검토하며, 적은 노력으로 무엇을 해야 할지 결정할 수 있도록 돕습니다. 독자가 이해하거나 검증해야 할 것이 무엇인지 파악한 후, 표현 방식을 선택하고 문장을 다듬습니다. 출력 결과를 읽고, 탐색하고, 확인하는 데 소요되는 시간을 고려하세요. 이 스킬은 현재 작업에만 적용되며, 사용자가 요청하지 않는 한 영구적인 대화 모드로 만들지 마세요.

문장( wording)보다 앞서 언어( language)를 선택하세요

  • 사용자의 명시적인 언어 및 출력 형식 요구 사항을 따릅니다.
  • 기존 아티팩트를 편집할 때는 번역 요청이 없는 한 해당 언어를 유지합니다. 편집에 대한 설명은 대화 언어를 사용할 수 있습니다.
  • 그 외에는 현재 대화를 따릅니다. 사용자 요청 내의 명확한 언어 전환을 따릅니다. 인용 자료, 로그, 코드, 도구 결과 및 이 스킬의 언어 자체는 응답 언어를 전환하지 않습니다.
  • 혼합 언어 기술 용어와 리터럴 콘텐츠를 보존합니다. 이 스킬이 중국어를 지원한다는 이유만으로 영어 디버깅 대화를 중국어로 번역하지 마세요.
  • 사용자가 JSON, 코드 블록 또는 특정 템플릿을 요청하는 경우 해당 계약을 유지합니다. 스킬 공지나 상태 접두사를 추가하지 마세요.

의미 보존

재작성의 경우, 출처와 명시적으로 제공된 컨텍스트를 사실적 경계로 사용합니다. 다음을 보존합니다:

  • 행위자, 객체, 범위, 조건, 예외 및 순서(함께 발생해야 하는 작업 포함)
  • 값, 단위, 범위, 근사치, 날짜, 식별자 및 인과 관계
  • 사실, 가설, 권장 사항, 의무, 허가 및 능력의 차이

may를 will로, should를 must로, about 5 seconds를 5 seconds로, 尽快를 지어낸 마감일로 바꾸지 마세요. 근거 없이 모호한 경계나 대명사의 해석을 선택하지 마세요. 모호성을 그대로 드러내거나 정확히 어떤 정보가 누락되었는지 식별하세요. 이러한 구분을 보존하기 위해 재작성 결과가 더 길어질 수 있습니다.

새로운 설명의 경우, 관련 배경과 예제가 유용합니다. 가정은 확립된 사실과 분리하고, 필요한 경우 가상의 예제에 레이블을 지정하세요. 증거 없이 작업이나 테스트가 수행되었다고 암시하지 마세요.

코드, 명령어, 경로, 필드 이름, 로그, 오류 문자열 및 고정 인용문을 출력에 그대로 가져올 때는 정확하게 유지하세요. 작업에서 명시적으로 이들 중 하나를 편집하도록 요청하는 경우, 해당 범위 내에서 편집을 수행하세요. 산문 규칙이 추가 편집을 정당화하지는 않습니다.

유용한 작업을 수행하는 표현 방식 선택

독자가 관계를 재구성하거나, 여러 차원을 비교하거나, 변화하는 상태를 추적하거나, 변수를 탐색해야 할 때 시각적 표현을 적극적으로 고려하세요. 시각적 표현이 해당 작업을 실질적으로 더 쉽게 만든다면, 별도의 다이어그램 요청을 기다리지 말고 승인된 작업 내에서 생성하세요. 짧고 직접적인 답변은 이미 작업에 충분할 경우 산문 형식으로 유지하세요.

독자가 해야 할 일유용한 시작 형식
사실, 간단한 답변 또는 충실한 문장 편집 얻기텍스트
동일한 기준으로 옵션 비교하기표
분기, 종속성, 참가자 또는 메시지 순서 추적하기흐름도, 종속성 다이어그램 또는 시퀀스 다이어그램
공간적 배치 또는 가시적 특징 이해하기주석이 달린 이미지 또는 개략도
제공된 수치 데이터의 패턴 보기레이블, 단위 및 적절한 척도가 포함된 차트
입력이 결과를 어떻게 변경하는지 탐색하기의미 있는 컨트롤이 있는 작동하는 대화형 설명
움직임, 진화 또는 단계별 교육 시퀀스 따르기실현 가능하고 유용할 때 애니메이션 또는 설명 비디오

이것은 시작점일 뿐이며, 비디오가 항상 최고라는 순위가 아닙니다. 하나의 질문에 대해 작은 맞춤형 아티팩트도 가치가 있을 수 있습니다. 생성 시간, 탐색 및 상호 작용을 정당화할 만큼 독자의 작업을 줄이는 형식을 선호하세요. 일반 텍스트, JSON, 기존 파일 형식 또는 아티팩트 없음에 대한 명시적 요청을 존중하세요.

선택한 형식을 제공하고, 만들겠다는 제안만 하지 마세요. 사용 가능한 렌더링 기능을 사용하고 결과를 검사하며, 관련 상호 작용을 테스트하세요. 렌더링 또는 미디어 도구를 사용할 수 없는 경우, 사용 가능한 지원되는 대안을 제공하고 정확히 무엇이 생성되었는지 알려주세요. 다이어그램 소스, 스토리보드 및 렌더링된 비디오는 서로 다른 결과물입니다. 시각적 표현이 도움이 될 것이라는 이유만으로 특정 공급업체를 요구하거나, 게시, 업로드 또는 유료 서비스를 사용하지 마세요.

시각적 인코딩에서도 의미를 보존하세요: 분기와 화살표 의미에 레이블을 지정하고, 동시 작업을 동시에 유지하며, 가설과 누락된 데이터를 표시하고, 단위와 척도를 정직하게 유지하세요. 정교한 다이어그램이 뒷받침되지 않는 원인이나 완료된 테스트를 암시해서는 안 됩니다. 레이블을 읽기 쉽게 만들고, 색상에만 의존하지 마세요. 출력 계약이 허용하는 경우, 여러 형식으로 전체 설명을 반복하지 않고 간단한 핵심 내용이나 텍스트 등가물을 제공하세요.

다이어그램, 차트, 대화형 설명 또는 애니메이션의 경우 선택 및 검증 지침은 references/output-forms.md를 참조하세요.

작업에 맞게 구조화

  • 설명: 먼저 주요 질문에 답한 다음, 이를 이해하는 데 필요한 추론을 제공합니다. 유용한 예제, 인과 관계 및 미묘한 차이를 유지합니다.
  • 디버깅: 관찰, 가설, 검증 및 다음 조치를 구분합니다. 검사가 무엇을 확인했는지, 불확실성이 어디에 남아 있는지 설명합니다. 누락된 사실이 조치를 변경할 때 실제 질문을 하세요.
  • 절차: 영향을 받는 작업보다 먼저 필요한 조건을 제시합니다. 순서가 중요한 경우 번호가 매겨진 단계를 사용합니다. 인간의 행동과 자동 시스템 동작을 분리합니다. 동시적이거나 분리할 수 없는 작업을 함께 유지합니다. 누락된 운영 정보를 식별할 때는 수량, 단위, 측정 기준, 시작/중지 조건뿐만 아니라 어떤 객체나 행위자를 의미하는지도 확인하세요. 지침을 사용하는 데 필요한 것이 무엇인지 물어보고, 누락된 사실을 스스로 제공하지 마세요.
  • 재작성 또는 검토: 요청된 범위만 개선합니다. 이미 잘 작동하는 구절은 그대로 둡니다. 요청된 경우 또는 해결되지 않은 모호성이 독자의 주의가 필요할 때만 변경 설명을 제공합니다.

짧고 명시적인 문장, 구체적인 동사 및 동일한 개념에 대해 안정적인 이름을 선호합니다. 서로 다른 개념 간의 구분을 유지하세요. 闭环控制 또는 request validation과 같은 기술 용어의 일부에 단어 블랙리스트를 적용하지 마세요.

문장 길이, 수동태, 동의어 및 공손함은 자동 오류가 아닌 상황에 따른 선택입니다. 영어는 수동태나 완료 시제가 필요할 수 있습니다. 중국어는 행위자가 이미 명확할 때 주어가 생략될 수 있습니다. 정보를 전달할 때 可能, 建议, 约, may 및 approximately를 유지하세요.

반환 전 확인

재작성 결과를 출처와 비교하여 변경된 사실, 누락된 조건, 변경된 양상, 만들어진 정밀도 및 손상된 리터럴이 있는지 확인하세요. 시각적 표현이나 아티팩트의 경우 레이블, 가장자리, 상태 및 계산에서 동일한 사실을 확인하세요. 언어와 형식이 여전히 작업과 일치하는지, 그리고 주장된 결과물이 실제로 존재하는지 확인하세요. 그런 다음 정보를 추가하지 않는 반복을 제거하세요.

스타일 검사는 의미적 동등성을 증명할 수 없습니다. 텍스트가 인증되었거나 완전히 검증되었다고 선언하는 대신 구체적인 해결되지 않은 문제를 보고하세요.

양상, 언어 혼합 또는 누락된 사실과 관련된 까다로운 재작성의 경우 references/edge-cases.md를 참조하세요.

상당한 재작성, 명시적인 검증 요청 또는 제공된 프로젝트 용어집의 경우, 구체적인 오류를 잡을 수 있을 때 선택적으로 로컬 체커를 사용하세요. 입력 및 제한 사항은 references/checks.md를 참조하세요. 인용된 텍스트가 아닌 작업에서 en, zh 또는 mixed를 선택하세요. 충실한 재작성에 대해서만 출처를 제공하고, 작업에 필요한 경우에만 정확한 리터럴 또는 JSON 제약 조건을 인코딩하세요. 간단한 답변에는 스크립트가 필요하지 않습니다.

체커 결과를 제한된 범위의 증거로 취급하세요: 위반된 명시적 계약을 수정하고, 출처와 비교하여 의미 변경을 검토하며, 스타일 제안은 도움이 될 때만 사용하세요. 승인된 편집은 유지하세요. 모든 경고를 제거하기 위해 다시 작성하거나 빈 결과 목록을 동등성의 증거로 취급하지 마세요. 수정 후 영향을 받은 제약 조건을 다시 확인하고, 모호성이 남아 있으면 반복적으로 다시 작성하는 대신 이를 보고하세요. 요청된 JSON/코드 전용 응답에 진단 정보를 포함시키지 마세요.

사용자가 이 스킬의 버전이나 업데이트에 대해 물을 경우 references/updates.md를 참조하세요. 일반적인 쓰기 작업은 네트워크 업데이트 확인을 트리거하거나 설치된 스킬을 변경하지 않습니다.

관련 스킬