Community연구 & 데이터 분석github.com

Material to Deliverable

散乱 자료를 자신의 지식 자산으로 정리합니다. 실제 자료를 재사용 가능한 문서, 요약 및 출처 색인으로 가공합니다.

Material to Deliverable란 무엇인가요?

이 스킬은 사용자가 제공한 실제 자료(예: 보고서, 회의록, 연구 자료)를 체계적으로 분석하여 신뢰할 수 있고 추적 가능한 최종 산출물로 변환하는 AI 에이전트 워크플로우입니다. 주로 Claude Code, Cursor 등 명령줄 또는 IDE 기반 AI 코딩 도구에서 사용되며, 주어진 프로젝트 디렉토리 내 `00_input/` 폴더의 자료를 기반으로 합니다. 이 스킬은 단순한 요약 생성기가 아닌, 자료의 출처를 명확히 하고, 개인 의견과 사실을 분리하며, 민감 정보를 안전하게 처리하는 엄격한 프로세스를 따릅니다. 작업 흐름은 프로젝트 초기화, 입력 검사 및 민감 정보 확인, 작업 명세서 작성, 자료 색인 및 격차 분석, 출처 기반 개요 작성, 최종 산출물 생성, 원본 자료 재검증, 최종 전달 패키지 정리 등 8단계로 구성됩니다. 사용자는 각 단계에서 확인을 수행하며, 중단 조건(예: 자료 부족, 민감 정보 미확인)이 발생하면 AI는 작업을 중단하고 이유를 설명합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add Lucian1u/material-to-deliverable

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

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

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

문서

자료를 산출물로

00_input/에 있는 실제 자료를 검증 가능하고, 추적 가능하며, 전달 가능한 텍스트 파일로 정리합니다.

시작 조건

다음 조건이 모두 충족될 때만 실행합니다.

  • 사용자가 로컬 프로젝트 디렉토리를 제공했거나 지정했습니다.
  • 00_input/에 최소 하나의 실제 자료가 있습니다.
  • 사용자가 보고서, 제안서, 회고, 조사 또는 강의 자료 중 하나를 원합니다.

디렉토리가 명확하지 않으면 프로젝트 디렉토리만 묻습니다. 전달 유형이 명확하지 않으면 전달 유형만 묻습니다. 실제 자료가 없으면 중단하고, 예시나 대체 자료를 생성하지 않습니다.

매번 읽어야 할 사항

처리를 시작하기 전에 전체를 읽습니다:

전달 유형이 확인된 후에는 전달 유형 규칙에서 해당 섹션을 읽습니다.

작업 흐름

1. 프로젝트 확인 및 초기화

프로젝트가 아직 초기화되지 않은 경우, 이 Skill의 설치 디렉토리에서 스크립트를 호출하고 명확한 프로젝트 경로를 전달합니다:

python3 <skill-directory>/scripts/init_project.py /absolute/path/to/project

사용자 프로젝트의 현재 디렉토리에 scripts/가 있다고 가정하지 마십시오. 먼저 이 파일의 위치를 기준으로 <skill-directory>를 확인한 후 스크립트를 실행합니다.

01_working/이 이미 존재하면 기존 상태를 읽고 계속 진행하며, 다시 초기화하지 않고 파일을 덮어쓰지 않습니다.

2. 입력 및 민감 정보 확인

00_input/의 모든 파일을 나열하고, 읽을 수 없거나 출처를 알 수 없는 파일을 기록합니다. 원본 자료를 수정, 이동 또는 이름을 바꾸지 마십시오.

먼저 민감 정보를 확인합니다. 이름, 개인 연락처, 계정, 고객 정보, 계약, 재정, 건강, 교육 기록, 증명서, 내부 경로 또는 기타 제한될 수 있는 정보가 발견되면:

  1. 02_material-index.md에 위험 유형과 파일 위치만 기록하고, 민감한 값을 복사하지 않습니다.
  2. 즉시 일시 중지합니다.
  3. 사용자에게 해당 자료를 처리할 권한이 있는지 확인하거나, 비식별화된 사본을 제공하도록 요청합니다.

사용자 확인 없이 개요 작성, 글쓰기 및 전달을 진행하지 않습니다.

3. 작업 명확화

한 번에 최종 산출물을 변경할 질문만 하나씩, 최대 일곱 개까지 합니다. 수신자, 사용 시나리오, 촉진하려는 결정, 마감일, 전달 유형, 반드시 포함해야 할 내용과 금지해야 할 내용을 우선 확인합니다.

사용자가 "모르겠습니다"라고 답하면, 확인해야 할 사항으로 기록하고 사용자를 대신하여 답변을 제공하지 않습니다. 결과를 01_task-brief.md에 작성하고, 요약을 표시한 후 사용자 확인을 기다립니다.

4. 자료 색인 및 격차 파악

자료별로 02_material-index.md를 작성하여 다음을 구분합니다:

  • 출처가 직접 뒷받침하는 사실
  • 당사자 또는 기관의 진술
  • 인터뷰, 피드백 또는 부분적 관찰
  • 사용자 본인의 판단
  • 확인이 필요한 정보

충돌, 누락, 읽을 수 없음, 비식별화 필요, 증거 부족인 내용을 03_gaps-and-conflicts.md에 작성합니다. 소량의 자료를 일반적인 결론으로 확대하지 않습니다.

차단적인 격차가 여전히 존재하면 계속 질문하거나 중단하고, 주요 산출물을 생성하지 않습니다.

5. 출처 기반 개요 생성

전달 유형에 따라 04_source-backed-outline.md를 생성합니다. 각 섹션은 답변해야 할 질문, 사용할 자료, 도출할 수 있는 결론, 사용자 판단, 확인 항목 및 검증 방식을 명확히 작성해야 합니다.

개요 요약과 출처 적용 현황을 표시하고 사용자 확인을 기다립니다. 확인되지 않으면 주요 산출물을 작성하지 않습니다.

6. 산출물 및 출처 색인 생성

확인된 개요에 따라 다음을 생성합니다:

  • 05_main-deliverable.md
  • 06_one-page-summary.md
  • 07_source-index.md

모든 핵심 사실은 출처 색인에서 특정 파일과 위치에 연결되어야 합니다. 자료에 없는 숫자, 인물, 사례, 인용문 또는 결과를 보충해서 작성하지 않습니다. 개인 판단은 출처 사실과 분리되어야 합니다.

7. 원본 자료 재검토

00_input/을 다시 읽고, 방금 생성한 산출물만 보고 자체 점검하지 않습니다. 사실, 범위, 논리, 개인 정보 보호, 작업 일관성 및 표현 문제를 08_audit-report.md에 기록합니다.

기존 자료로 명확히 수정할 수 있는 문제만 수정합니다. 사용자 판단이 필요한 내용은 확인 대기 상태로 유지합니다.

8. 전달 패키지 정리

감사에서 차단 문제가 없는 경우에만 통과된 내용을 다음에 씁니다:

02_delivery/
  main-deliverable.md
  one-page-summary.md
  source-index.md
  readme.md

02_delivery/에는 원본 자료, 프롬프트, 채팅 기록, 내부 초안 또는 민감한 값이 포함되어서는 안 됩니다. 마지막으로 이 Skill의 설치 디렉토리에서 다음을 실행합니다:

python3 <skill-directory>/scripts/validate_project.py /absolute/path/to/project --stage delivery

검증 스크립트가 통과된 후에도 사용자에게 최종 수동 승인을 요청해야 합니다. 스크립트는 파일 구조와 명백한 잔여물만 확인하며, 사실의 정확성을 증명하지 않습니다.

중단 조건

다음 중 하나라도 발생하면 중단하고 무엇이 부족한지 설명합니다.

  • 00_input/이 비어 있거나 자료를 읽을 수 없습니다.
  • 사용자가 민감한 자료를 계속 처리할 수 있다고 확인하지 않았습니다.
  • 수신자, 전달 유형 또는 핵심 목표가 여전히 명확하지 않습니다.
  • 현재 자료로 주요 결론을 뒷받침할 수 없습니다.
  • 사용자가 작업 명세서 또는 개요를 아직 확인하지 않았습니다.

허위 자료, 인터넷 검색 또는 상식 추론을 사용하여 중단 조건을 우회하지 마십시오. 단, 사용자가 새로운 자료 출처를 명시적으로 승인한 경우는 예외입니다.

출력 언어

기본적으로 사용자가 현재 사용하는 언어를 따릅니다. 파일 이름은 영어로 유지하여 여러 환경에서 사용할 수 있도록 하고, 파일 내용은 사용자 언어를 사용합니다.

관련 스킬