에이전트 기반 보고은(는) 무엇을 하나요?

최신 작업 상태를 독자가 결과, 증거, 경계, 그리고 유용한 다음 조치를 찾을 수 있는 가장 짧은 구조로 제시합니다. 이 스킬은 표현을 관장합니다. 작업 사실을 변경하거나 도메인별 검증을 대체하지 않습니다.

양보할 수 없는 우선순위

명시적인 경우 사용자가 요청한 표면, 스키마, 길이 및 순서를 따릅니다. 그런 다음 호스트 지시를 따릅니다. 이 프레임워크는 지정되지 않은 선택 사항을 채우는 데만 사용합니다. 증거, 테스트, 인용, 지표, 파일, 책임자, 날짜 또는 완료를 절대 만들어내지 않습니다.

시작-종료 워크플로우

청중, 표면, 증거 경계 및 정확히 하나의 기본 모드별로 핸드오프를 분류합니다. 연구 작업의 경우 최대 하나의 도메인 프로필을 선택합니다. 불확실한 경우 list 또는 route를 사용합니다.
작업에 맞게 절차를 조정합니다. 짧은 단일 세션 답변의 경우 체크포인트, 초안 파일 또는 스크립트 감사를 생성하지 말고 라우팅된 모드의 구조를 직접 적용하고 필수 의미를 자체 점검한 후 전달합니다. 4-6단계의 파일 기반 절차는 길고, 다중 세션이거나, 다중 에이전트이거나, 지속적인 아티팩트 작업을 위한 것입니다. 길고, 다중 에이전트이거나, 다중 세션 작업의 경우 시작 부분에 컴팩트한 체크포인트를 저장합니다. 짧은 작업의 경우 보고 경계까지 라우팅을 연기합니다.
실제 작업을 완료하고 확인합니다. 작업 실행은 보고 스타일과 독립적으로 유지합니다.
실질적인 업데이트 또는 최종 답변 직전에 하나의 경계 번들을 검색합니다. 하나의 디스플레이 모듈을 선호합니다. 기본 모드와 첫 번째 모듈이 이미 다루지 않는 별도의 필요가 있는 경우에만 두 번째 모듈을 추가합니다. 선택한 모드가 이미 지정한 의미를 요청된 출력이 명명했다고 해서 모듈을 로드하지 마십시오:

<skill-dir>을 이 SKILL.md가 포함된 디렉토리로 확인하십시오. 호출자의 작업 디렉토리가 스킬 디렉토리라고 가정하지 마십시오.
```
python3 <skill-dir>/scripts/reportctl.py bundle \
  --task "<전달해야 할 것>" --mode <모드> --surface <표면> \
  [--profile <프로필>] [--module <모듈>] [--module <모듈>] \
  --max-chars 16000
```
긴 작업을 재개하는 경우 메모리에서 경로를 재구성하는 대신 --checkpoint <경로>를 전달합니다. --max-chars는 독립적인 컨텍스트 예산입니다. 두 개의 큰 모듈이 있는 유효한 체크포인트는 명시적으로 더 큰 값이 필요할 수 있습니다. 모든 모드, 모듈 또는 템플릿을 읽지 마십시오.
선택한 표면에 대해 네이티브하게 초안을 작성합니다. 경로가 정확한 자산을 권장하는 경우 저렴한 레지스트리를 검사하고 하나의 자산만 검색합니다:
```
python3 <skill-dir>/scripts/reportctl.py template --list
python3 <skill-dir>/scripts/reportctl.py template <template-id> \
  --output <대상>
```
하나의 기본 전달 아티팩트를 사용합니다. 요청하지 않는 한 병렬 Markdown, HTML, PPTX 및 PDF 버전을 만들지 마십시오. 복사된 템플릿은 시작 아티팩트일 뿐이며 자리 표시자, 시각 자료 또는 주장이 정확하다는 증거가 아닙니다.

내용이 완료된 후 산문에 AI 톤 제거 패스를 적용합니다: natural-tone 모듈의 충실도 계약에 따라 아첨하는 시작 문구, 과시적인 요약, 부풀려진 전문 용어 및 템플릿 수사법을 제거합니다. 톤 편집은 사실, 관계, 범위 또는 숫자를 변경하지 않습니다. 감사의 ai-tone-boilerplate 경고는 가장 정밀한 잔여물만 포착합니다.

연구 모드(experiment-report, academic-synthesis, research-idea)에서는 모든 성공률이 k/n 및 이항 구간을 포함하고, 모든 유의미한이 같은 문장에 검정 및 효과 크기를 포함하며, 어떤 동사도 시스템에 대한 이해나 의도를 귀속시키지 않는지 확인합니다. 감사의 success-rate-without-denominator, significance-without-statistic 및 anthropomorphic-claim 경고는 기계적 잔여물을 포착합니다. 프로필과 결론 모듈에는 전체 규칙이 포함됩니다. 숫자 표시에는 동일한 모드에서 고유한 잔여물 검사가 있습니다: unlabeled-uncertainty (SD, SEM 또는 CI를 명시하지 않은 ±), threshold-p-value (p < 0.05, n.s.), p-value-without-effect-size, null-result-without-interval, significance-euphemism (유의미함에 근접함), up-to-without-central-tendency 및 best-of-n-runs.
장기 작업 또는 지속적인 아티팩트 최종본 전에 파일 기반 초안을 감사합니다. 긴 작업은 동일한 체크포인트를 사용해야 합니다. 체크포인트가 없는 지속적인 아티팩트는 선택한 모드를 사용합니다:
```
python3 <skill-dir>/scripts/reportctl.py audit \
  --file <draft.md> --checkpoint <checkpoint-경로>
# 짧고 체크포인트되지 않은 경로:
python3 <skill-dir>/scripts/reportctl.py audit --file <draft.md> --mode <모드>
```
체크포인트는 모드를 파생합니다. 동일한 명시적 모드를 제공하는 것은 허용됩니다. 충돌하는 모드는 입력 오류입니다. 감사 오류를 수정합니다. 경고는 판단하여 해결합니다. 발견적 방법을 충족시키기 위해 지원되지 않는 내용을 절대 추가하지 마십시오. 저장소의 docs/AUDIT-CODES.md에는 각 코드와 트리거 및 수정 사항이 나열됩니다. --json을 사용하면 감사 페이로드에는 컨트롤러 바인딩을 위한 정확한 보고서 바이트 수/SHA-256 및 구문 분석된 체크포인트 의도 지문이 포함됩니다.
최신 상태, 과학적 또는 기술적 주장, 숫자, 증거 링크, 불확실성, 시각적 해석 및 사용자 지정 형식을 수동으로 확인합니다.

최종 전달

사용자가 볼 수 있는 최종 응답에는 보고서 자체가 포함되어야 합니다. 저장된 초안, 체크포인트 또는 감사 영수증에 대한 경로, 링크 또는 포인터는 전달 대상이 아닙니다. 체크포인트 기반 감사가 통과한 후 감사된 초안 내용을 응답으로 전달합니다. 사용자가 명시적으로 파일을 요청한 경우에도 결과를 인라인으로 먼저 제시합니다. 독자 대상 응답에 로컬 절대 경로, 스크래치 디렉토리 또는 체크포인트 위치를 절대 노출하지 마십시오.

모드 및 모듈 선택

식별자를 보려면 python3 <skill-dir>/scripts/reportctl.py list를 사용하십시오. 적용 가능한 모든 레이블이 아닌 기본 서술 줄기를 선택하십시오. 혼합 작업의 경우 사용자의 주요 결정 또는 질문에 답하는 모드를 선택하고 그 안에 보조 사실을 포함시킵니다.

concise-answer: 지원 구조가 거의 없는 직접적인 답변에 사용합니다.
implementation-handoff: 구축되거나 변경된 아티팩트에 사용합니다.
status-update: 활성 인시던트가 아닌 프로젝트 진행 상황에 사용합니다.
investigation-report: 진단 또는 소스 기반 조사에 사용합니다.
experiment-report: 통제된 평가 및 경험적 비교에 사용합니다.
decision-brief 또는 risk-report: 선택 또는 노출이 주요 사항일 때 사용합니다.
academic-synthesis: 논문 또는 문헌 제시에 사용합니다.
research-idea: 가설, 참신성, 결정적 실험, 위험 및 중단 기준이 명시적으로 남아 있어야 하는 논문 아이디어 또는 제안에 사용합니다.
review-report: 아티팩트 또는 표준에 대한 결과에 사용합니다.
incident-update: 영향이 활성 상태인 동안 사용합니다. 복구 후에는 postmortem을 사용합니다.

그림, 표, 결론, 증거 세부 사항 및 학술적 표시는 직교 모듈이며 여러 모드를 병합하는 이유가 아닙니다. 시각적 자료는 관계 또는 아티팩트를 실질적으로 이해하기 쉽게 만들어야 합니다. 장식은 유효한 이유가 아닙니다. experiment-report에는 이미 결과 해석, 불확실성 경계 및 보정된 결론이 포함되어 있습니다. 요청이 결론을 요청한다는 이유만으로 해당 모드에 conclusions를 추가하지 마십시오. 별도의 결정 또는 권장 정책이 실제로 필요한 경우에만 명시적으로 추가하십시오.

연구 프로필 및 프레젠테이션 표면

프로필은 추가 기본 모드가 아닌 하나의 경계가 있는 도메인 오버레이입니다:

reinforcement-learning: 실행 회계, 튜닝 패리티, 학습 곡선, 구간 추정 및 다중 작업 종합 평가.
embodied-ai: 구현, 센서/액션, 시뮬레이션 대 실제 프로토콜, 성공 규칙, 개입, 일반화 및 실패.
world-models: 모델/데이터 카드 및 개방 루프, 폐쇄 루프, 스케일링 및 전이 증거 분리.
vla: 데이터 혼합, 형태 및 액션 인터페이스, 적응 체제, 롤아웃 회계, 지연 시간, 일반화 및 안전.

자동 선택은 연구 지향 모드에만 사용할 수 있습니다. schema-v2 체크포인트는 새로운 프로필 필드를 저장하지 않습니다. 프로필은 지문이 찍힌 작업 텍스트에서 다시 파생됩니다. 따라서 긴 작업에 대해 프로필을 명시적으로 선택하는 경우 최종 검색이 재현 가능하도록 체크포인트 작업에 도메인을 지정하십시오.

--surface slide의 경우 라우팅된 슬라이드 가이드를 읽으십시오. 가이드는 논문 발표, 연구 진행, 실험 검토 및 아이디어 피치 내러티브를 제공합니다. 사용자가 여러 형식을 요청하지 않는 한 종속성이 없는 HTML/PPT 스타일 데크 또는 Quarto Reveal.js 소스 중 하나만 검색하십시오.

긴 컨텍스트 지속성

전체 보고 번들을 작업 컨텍스트에 유지하지 마십시오. 체크포인트만 저장하십시오:

python3 <skill-dir>/scripts/reportctl.py checkpoint \
  --task "<핸드오프 목표>" --mode <모드> --surface <표면> \
  --must-show "<짧은 안정적인 텍스트 앵커>" \
  --output <개인-스크래치>/agent-report.json

Schema-v2 --must-show 값은 의미 요구 사항이 아닌 정규화된 리터럴 앵커입니다. 감사는 NFC 정규화, 대소문자 접기 및 공백 축소를 적용한 다음 빈 줄로 구분되고, 열이 0이며, 일반 최상위 Markdown 산문 단락에서만 리터럴 하위 문자열 존재를 확인합니다. 제목, 인용문, 목록, 테이블, 링크/참조, 이미지, 코드 또는 원시 HTML을 포함하는 단락은 적격하지 않습니다. 첫 번째 마스크 해제된 원시 HTML 태그 이후에는 이후 단락이 평가되지 않습니다. 프록시가 단락 간 DOM 또는 CSS 상태를 모델링하지 않기 때문입니다. 원시 HTML은 또한 구조적 감사 오류입니다. 각 앵커는 하나의 적격 단락 내에서 일치해야 합니다. 해당 단락 내의 소프트 줄 바꿈은 공백으로 축소되지만 빈 줄 단락 경계는 절대 축소되지 않습니다.

정규화 전에 보고서 프록시는 공유 스캐너가 지원하는 세미콜론으로 종료되는 CommonMark 엔터티 하위 집합의 한 라운드를 디코딩하지만, 엔터티의 &가 홀수 길이의 백슬래시 실행으로 이스케이프되지 않은 경우에만 해당됩니다. 결과 제어 또는 유니코드 비렌더링 문자는 게이트를 실패하게 만듭니다. V2 앵커는 정확한 렌더링된 일반 텍스트를 사용해야 하며 Markdown 구분 기호 형식을 거부해야 합니다. 각 짧은 앵커를 원시 HTML 앞에 독립적인 일반 결론 문장에 배치하십시오. 이 프록시는 텍스트의 의미, 누가 주장했는지 또는 그것이 사실인지 확인하지 않습니다. 각 앵커는 최대 120자이며 이스케이프된 영수증(구분 기호 포함)은 최대 240자입니다.

체크포인트 기반 감사는 최대 1MiB의 보고서를 허용하므로 산문 프록시는 리소스 바운드 상태를 유지합니다. 4,096자 이상이거나 64개 이상의 연속 유니코드 마크 문자가 있는 적격 일반 산문 단락은 오류이며 NFC 및 앵커 일치 전에 건너뜁니다. 레거시 모드 전용 감사는 최대 4MiB로 유지됩니다. 이 더 큰 제한은 --checkpoint가 있을 때 적용되지 않습니다. 바운드된 JSON 입력은 변환 전에 128자 이상의 정수 또는 부동 소수점 토큰을 거부합니다.

체크포인트는 목표, 청중, 표면, 모듈 및 앵커를 있는 그대로 저장하고 라우팅 메타데이터 및 키가 없는 체크섬도 저장합니다. 체크섬은 우발적인 드리프트를 감지합니다. 파일을 인증하지 않습니다. 비밀 또는 불필요한 개인 데이터를 필드에 넣지 마십시오. 버전 관리 외부의 개인 스크래치 경로를 사용하고 route/bundle이 체크포인트 텍스트를 stdout으로 재생할 수 있음을 기억하며 재개가 더 이상 필요하지 않을 때 파일을 제거하십시오. 원자적 생성은 POSIX에서 제한적인 파일 권한을 사용하지만 허용적인 상위 디렉토리, 로그, 백업 또는 커밋된 파일을 보호할 수 없습니다.

최종 경계에서 bundle --checkpoint <checkpoint-경로>로 다시 로드하고 audit --file <draft.md> --checkpoint <checkpoint-경로>를 실행하십시오. Schema-v1 체크포인트는 route 및 bundle에서 계속 읽을 수 있지만 이 최종 게이트를 구동할 수 없습니다. checkpoint --checkpoint <v1-경로> --output <new-v2-경로>로 유효한 v1 파일을 재생성하거나 업그레이드하십시오. 호스트가 인식하는 마이크로 계약은 두 시작-종료를 모두 프롬프트하기 위한 것입니다. 그것이나 체크포인트 모두 임의의 에이전트가 준수하도록 강제할 수 없습니다.

지속적인 보고서를 위한 엄격 모드

래퍼, 배치 워크플로우 또는 공식 보고서에 더 강력한 구조적 일관성이 필요한 경우 assets/templates/report-spec.json에서 시작하여 validate-spec으로 검증하고 render로 Markdown을 결정론적으로 렌더링하십시오. JSON을 단일 프레젠테이션 소스로 취급하지만 모든 사실을 원본 증거와 대조하여 확인하십시오. 모든 주장은 하나 이상의 의미 roles를 선언합니다. 검증은 증거, 지표, 불확실성, 조치 및 제한 사항에서 나머지 범위를 파생시킨 다음 프로토콜 카탈로그에서 선택한 모드의 현재 required_semantics를 적용합니다. 번들 JSON Schema는 휴대용 구조적 사전 점검일 뿐 validate-spec을 대체하지 않습니다. CLI만이 ID 고유성, 교차 레코드 참조 및 현재 프로토콜 카탈로그를 함께 적용합니다.

python3 <skill-dir>/scripts/reportctl.py validate-spec --file report.json
python3 <skill-dir>/scripts/reportctl.py render --file report.json --output report.md
python3 <skill-dir>/scripts/reportctl.py audit \
  --file report.md --checkpoint <checkpoint-경로> --strict

체크포인트가 없는 짧은 작업인 경우 대신 --mode <모드>를 사용하십시오. 일반적인 짧은 채팅 응답에 대해 구조화된 경로를 요구하지 마십시오.

스크립트를 사용할 수 없는 경우의 폴백

설치된 스킬 내에서 references/core-contract.md, references/modes/ 아래의 일치하는 파일 하나, references/profiles/ 아래의 최대 하나의 일치하는 파일, references/modules/ 아래의 최대 두 개의 일치하는 파일, 그리고 필요한 경우에만 하나의 표면 가이드를 읽으십시오. 하나의 정확한 자산을 별도로 검색하십시오. 링크 전용 저장소 사용의 경우 저장소 루트에서 dist/agent-index.md를 여십시오. URL만 제공된 경우 준수를 최선의 노력으로 처리하십시오. 링크는 저장소 지침을 설치하거나 승격시키지 않습니다.

에이전트 기반 보고