Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-report

hyper-report

Verified

Use this skill when the user asks for a report as a finished document rather than a chat answer: a briefing, business or research report, proposal, status or analysis write-up, or one-page summary. It fixes audience and decision up front, keeps every number and claim traceable to a source, and renders one authored Markdown source into HTML, print PDF, per-page PNG/JPG images, DOCX, or Markdown, with tables and figures where they carry the reader. Do not use it for slide decks, spreadsheet workbooks, single generated images, or reports that only need to live in chat.

rules/authoring.ko.md

View on GitHub
# 보고서 작성

보고서는 분량만큼 제값을 해야 한다. 모든 절은 독자를 브리프의 결정 쪽으로 옮기거나 잘린다.

## 1. 브리프 블록

첫 문장 전에 다섯 가지를 고정한다. 이것들은 별도 기획 문서가 아니라 소스 파일의 도입부가 된다.

| 항목 | 답하는 질문 | 나쁜 답 | 좋은 답 |
|---|---|---|---|
| 결정 | 독자가 읽고 나서 무엇을 하는가? | "시장을 이해한다" | "8주 범위로 A안을 승인한다" |
| 독자 | 누가 읽고, 무엇을 이미 아는가? | "이해관계자" | "예산은 알지만 기술 제약은 모르는 CFO" |
| 그래서 무엇인가 | 독자가 믿으면 무엇이 바뀌는가? | "정보가 된다" | "B에 쓰는 지출을 멈추고 팀을 A로 옮긴다" |
| 근거 자료 | 실제로 무엇을 보여 줄 수 있는가? | "조사" | "벤더 견적 세 건, 우리 3분기 수치, 고객 인터뷰 두 건" |
| 분량 | 얼마나 길어도 되는가? | "필요한 만큼" | "A4 다섯 장, 부록 한 장" |

답할 수 없는 항목은 막는 요소가 아니라 발견이다. 최선의 답을 쓰고 가정으로 표시한 뒤 전달 메모에 그렇게 밝힌다.

## 2. 문서의 구조

```
표지             제목, 부제, 독자, 날짜, 작성자
결론             첫 장에, 평문 문장으로 쓴 답
핵심 수치        결론을 떠받치는 최대 네 개의 수치
본문             절마다 메시지 하나, 각 절은 자기 결론으로 시작
근거             표, 그림, 인용. 각각 해석하는 캡션을 붙임
위험과 한계      결론을 틀리게 만들 조건
다음 단계        독자가 취하는 단일 행동
출처             모든 표시가 여기로 풀림
```

### 결론 블록

세 문장에서 다섯 문장. 권고, 이유, 비용이나 조건을 밝힌다. 서론적 군더더기, 브리프의 되풀이, "이 보고서는 살펴본다" 같은 문장은 없다.

> 8주 범위로 A안을 택해야 한다. B안의 9억에 맞서 12억이 들지만 14주가 아니라 8주에 출시하며, 고객 인터뷰 두 건은 지연 비용이 가격 차이보다 크다고 말한다. 조건은 3주차까지 설계 동결이 유지되는 것이다.

이 단락은 거기서 읽기를 멈추는 독자에게 보고서 전체이며, 나머지 문서는 이 단락을 옹호하려고 존재한다. 도움이 되면 마지막에 쓰고, 그다음 맨 앞으로 옮긴다.

### 절의 구조

모든 절은 같은 패턴을 자기 규모로 되풀이한다.

1. **한 문장 주장**: 이 절이 세우는 것.
2. **근거**: 그것을 뒷받침하는 표, 그림, 인용.
3. **따르는 것**: 함의. 한두 문장.

따르는 것을 말하지 않고 발견만 보고하는 절은 데이터 덤프다. 결론을 되풀이하는 절은 군더더기다.

### 절의 순서

찾은 순서가 아니라 독자가 결정하는 데 필요한 순서로 배열한다. 시간 계획보다 비용 모델을 먼저 받아들여야 한다면, 시간 계획이 조사하기 더 쉬웠더라도 비용 모델이 먼저 온다.

## 3. 표

표는 독자가 같은 열 위에서 행을 비교할 때만 제값을 한다.

- 표마다 아이디어 하나. 구분 행을 넣은 표 하나보다 표 둘이 낫다.
- 비교하는 수량은 열에 둔다. 셀 안의 산문에는 절대 두지 않는다.
- 수치 열은 오른쪽으로 정렬한다. 파이프라인이 `---:` 구분자로 처리한다.
- 단위는 헤더에 둔다. 모든 셀에 두지 않는다. `1,200,000,000원`을 열한 번 쓰지 않고 `비용 (원)`으로 쓴다.
- 결정을 바꾸는 정밀도로 반올림한다. 유효 숫자 세 자리면 거의 항상 충분하다.
- 서로 무관한 행의 표에 합계 행을 넣지 않는다. 행이 합산된다면 그 합이 무엇을 뜻하는지 밝힌다.
- 열 둘, 행 넷짜리 표는 보통 한 문장이다.

## 4. 그림

그림은 데이터의 모양 자체가 요점일 때만 제값을 한다. 추세, 분포, 단절, 순위다.

- 모든 그림에는 해석하는 캡션이 붙는다. 무엇인지가 아니라 독자가 무엇을 보아야 하는지다. "온보딩이 4분 아래로 떨어지면 이탈이 급격히 줄어든다"가 "온보딩 시간별 이탈"보다 낫다.
- 그림마다 메시지 하나. 캡션에 "그리고"가 필요하면 그림을 나눈다.
- 표가 이미 주는 수치를 차트로 그리지 않는다. 아이디어마다 형식 하나를 고른다.
- 대체 텍스트는 보지 못하는 독자를 위해 그림을 설명한다. 캡션은 메시지를 밝힌다.
- 차트는 다른 곳에서 만들고 소스 옆에 이미지 파일로 둔다. 파이프라인은 그 파일을 넣을 뿐 차트를 그리지 않는다.

## 5. 한 장 요약

요약은 보고서를 정확히 한 장으로 압축한 것이며, 본문을 잘라낸 것이 아니라 따로 작성하는 파일이다.

```
결론             두세 문장
핵심 수치        수치 세 개, 그 이상은 없음
근거가 되는 것   근거를 지목하는 두세 개의 글머리표
다음에 할 일     한 문장
읽을 곳          중요한 세 절의 페이지 번호
```

내용이 한 장에 들어가지 않으면 내용을 줄인다. 글자를 줄이지 않는다. 7포인트 요약은 인쇄에서 읽을 수 없고 분량에 대해 정직하지 않다.

## 6. 잘라내는 것

전달 전에 다음을 하나씩 지운다.

- 독자가 이미 요청한 것을 되풀이하는 배경 절.
- 보고서가 자기 자신을 말하며 시작하는 문장.
- 근거가 뒷받침하는 주장을 무르게 만드는 부사, 근거가 뒷받침하지 못하는 주장을 숨기는 완곡어.
- 첫 예시가 이미 요점을 만들었을 때의 두 번째 예시.
- 출처 목록에도 없고 여기서 측정하지도 않은 본문의 모든 수치.
- 결론을 압축하지 않고 그대로 되풀이하는 요약.

## Sources

> Checked 2026-11-13.

| Claim | Source |
|---|---|
| 결론을 근거보다 먼저 두는 구조와 절마다 메시지 하나 | Barbara Minto, *The Pyramid Principle*. 배열 원리만 참조했고 본문은 복사하지 않음 |
| 수치 열 정렬과 헤더의 단위 배치 | <https://www.nngroup.com/articles/data-tables/> |
| 이름을 붙이지 않고 해석하는 그림 캡션 | <https://www.nngroup.com/articles/choosing-chart-types/> |
| 아이디어마다 형식 하나, 표가 이미 밝힌 것을 차트로 그리지 않기 | `rules/format-routes.md`에 밝힌 이 패키지의 계약 |
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 197kUpdated Claude CodeCodexVerifiedInstall