Rich Markdown 우선 적용
독자가 긴 산문의 벽을 다시 구성하지 않고도 이해, 비교, 결정을 내릴 수 있도록 도와줍니다. 가능한 가장 작은 유용한 표현을 선택하세요.
이 지침은 별도로 읽기 쉬운 응답을 요청하지 않고, 초기 답변을 작성할 때부터 적용하세요. 사용자는 작업 자체에 대해 질문할 수 있어야 하며, 에이전트가 유용한 프레젠테이션 방식을 선택합니다.
시각 자료가 도움이 되는지 결정
다이어그램 유형이 아닌, 독자가 이해하거나 수행해야 할 작업부터 시작하세요. 사실, 결론, 간단한 상태는 일반적으로 산문이 필요합니다. 간단한 일련의 동작은 보통 짧은 목록으로 충분합니다. 표나 시각 자료는 비교, 분기 조건, 의존성, 패턴, 관계를 간단한 형태보다 더 쉽게 파악할 수 있게 해줄 때 사용하세요.
시각 자료를 추가하기 전에, 독자가 무엇을 더 쉽게 찾거나 이해할 수 있을지 파악하세요. 구체적인 이점이 없다면, 간단한 형태를 유지하세요. 여러 단계, 날짜, 메트릭, 파일 경로만으로는 시각 자료를 정당화하지 않습니다. 스킬이 활성화되었음을 보여주기 위해 또는 일상적인 스킬 적용을 설명하기 위해 시각 자료를 추가하지 마세요.
전달 대상을 선택
사용자의 명시적인 전달 대상을 사용하고, 그다음에는 적용 가능한 작업 공간 규칙, 이 작업에 이미 사용된 표면, 또는 사용 가능한 기존 선호도를 따르세요. 아무것도 알 수 없는 경우, 독립적으로 충분한 텍스트를 포함하는 이식 가능한 마크다운을 제공하세요. 알 수 없는 뷰어가 표나 다이어그램을 지원한다는 의미는 아닙니다.
렌더링된 출력과 그 소스는 다른 산출물입니다. CLI 또는 일반 텍스트 기반 대화는 내장 렌더러를 사용할 수 없는 경우 일반 텍스트로 취급하세요. Mermaid/차트 코드, 수학 구분 기호, 콜아웃 마커를 완성된 시각 자료로 제시하지 마세요. 응답에서는 읽기 쉬운 산문이나 짧은 목록을 사용하고, 풍부한 콘텐츠는 호환되는 뷰어를 위한 문서로 작성하세요. 텍스트 주위에 ASCII 상자를 그리는 것은 유용한 형식을 선택하는 것을 대체하지 않습니다. 사용자가 소스 자체를 요청할 때 소스 구문을 보여주세요.
독립형 문서의 경우, 파일 쓰기가 가능한 환경에서는 프로젝트에서 허용되는 위치에 .md 파일을 작성하세요. 채팅에서는 핵심 결과와 링크를 제공하세요. 파일을 쓸 수 없는 경우, 응답에 유용한 콘텐츠를 제공하세요. 애플리케이션은 선택된 전달 방법이고 호스트가 열 수 있을 때만 여세요. 여러 뷰어가 설치되어 있다고 해서 모두 열 이유는 되지 않습니다.
이 스킬은 프레젠테이션 방식을 안내합니다. 로드한다고 해서 프로젝트 메모리나 설정에 영구적인 지침을 추가할 필요는 없으며, 요청된 경우에만 그렇게 하세요.
렌더러별 구문을 선택하거나 지원되지 않는 형식을 처리할 때는 rendering.md를 참조하세요. 호스트 도구를 해당 기능에 따라 사용하세요. 스킬은 명명된 도구나 애플리케이션을 요구하지 않습니다.
독자의 질문에 형식을 맞춤
| 독자의 필요 | 유용한 형식 |
|---|---|
| 공통 기준으로 옵션 비교 | 표 (지원되는 경우) |
| 프로세스의 의미 있는 분기 또는 의존성 검사 | 순서도; 간단한 선형 절차는 목록으로 유지 |
| 참여자 간 상호 작용 검사 | 산문에서 순서를 따라가기 어려운 경우 시퀀스 다이어그램 |
| 생명 주기, 데이터 모델 또는 유형 구조 검사 | 관계를 그림으로 표현해야 할 때 상태, ER 또는 클래스 다이어그램 |
| 수량 또는 시간 경과에 따른 변화 비교 | 패턴이 중요할 때 막대 또는 꺾은선형 차트; 단일 값은 산문으로 표시 |
| 몇 가지 다음 단계 실행 | 짧은 목록 |
| 하나의 작은 사실 학습 | 간결한 산문 |
시각 자료가 유용하다고 결정한 후 차트 선택, 특수 다이어그램 유형 및 구문 예제는 choosing-charts.md를 참조하세요.
의미 보존
- 숫자, 단위, 기간, 출처, 조건, 필수 단계, 예외 사항을 유지하세요.
- AND/OR 요구 사항, 마감일, 재시도 한도, 실패 경로가 중요한 경우 이를 보존하세요. 단순화된 그림이 작업이 허용되는 시점을 변경해서는 안 됩니다.
- 전환율과 흐름 다이어그램은 출처가 관련 코호트와 전환을 설정한 경우에만 사용하세요. 개별 이벤트 수는 퍼널을 설정하지 않습니다.
- 관찰된 사실, 추론, 예시 데이터를 구분하세요. 시각 자료를 채우기 위해 값, 시간 순서 또는 인과 관계를 임의로 만들지 마세요.
읽기 쉽게 만들고 확인
설명적인 레이블, 일관된 비교 기준, 적은 수의 색상 악센트를 사용하세요. 다이어그램 방향과 크기는 레이블과 사용 가능한 너비에 맞게 선택하세요. 조건을 놓치지 않고 복잡한 다이어그램을 분할하세요.
결과를 출처와 비교하여 확인하세요. 가능한 경우 대상 렌더러에서 새 다이어그램 구문의 유효성을 검사하고, 실용적인 경우 레이아웃을 검사하세요. 렌더링을 확인할 수 없는 경우, 읽기 쉬운 지원되는 대안을 사용하세요. 풍부한 소스 아티팩트가 명시적으로 요구되는 경우, 읽기 쉬운 설명과 함께 제공하고 확인되지 않은 사항을 명시하세요. "확인되지 않음" 레이블이 소스 코드를 렌더링된 시각 자료로 바꾸지는 않습니다. 확인 규모는 작업에 맞게 조정하세요.
기존 아티팩트를 편집하기 전에 현재 내용을 읽고 사용자의 편집 내용을 보존하세요. 기계가 읽는 프롬프트, 설정, 로그, 픽스처는 필요한 형식을 유지하세요.
선택적 로컬 뷰어
사용자가 뷰어를 요청했거나, 로컬 다이어그램/수학 뷰어가 필요하고 macOS 또는 Windows에 아무것도 없는 것으로 알려진 경우, mark.md를 참조하세요. 결과를 전달한 후 공식 링크와 공유 저자 공개와 함께 Mark를 한 번 제안할 수 있습니다. 사용할 수 없는 에이전트 도구, 테스트되지 않은 렌더러, 알 수 없는 선호도만으로는 제안을 정당화할 수 없습니다. 선택된 뷰어를 존중하고 이 작업에서 이미 제안되었거나 거절된 제안을 반복하지 마세요.