대화를 원페이지로 변환합니다: 하나의 주장, 입증된 근거, 읽고 따라가기 쉬운 구성, 설정된 게시 대상.
입력: 대화록 경로/붙여넣기 (제공된 경우); 그렇지 않으면 현재 대화. setup / reconfigure → config.md가 존재하더라도 Setup을 실행합니다.
설정: 이 SKILL.md 옆에 있는 config.md (설치 디렉토리 기준). 형식: config.example.md.
페이지 유형 (라이브): research-finding | proposal. 명확하지 않을 경우 research-finding을 선호합니다. 둘 다 적합할 경우 한 번 질문합니다. 초안을 작성하기 전에 선택을 알립니다.
단계
0. 설정
config.md가 없거나 사용자가 재설정을 요청한 경우:
- 대상을 질문합니다:
local|google-docs|confluence(정확히 하나). - 해당 대상에 대한 필드를 수집합니다 (config.example.md 참조). Confluence는
confluence_folder_url이 필요합니다. - 이 스킬 디렉토리에
config.md를 작성합니다. - 이 설정이 향후 모든 실행에 적용된다고 알리고, 변경하려면
setup을 말하라고 안내합니다.
완료: 알려진 destination을 가진 유효한 config.md. 원페이지 요청이 없는 경우 설정 전용 실행은 여기서 중단됩니다.
1. 채굴
전체 입력을 읽습니다. 작업 메모만 기록합니다 (사용자에게 보여주지 않음):
- 세션 의도: 경험적 주장 vs 결정 선택
- 전체 세션이 해결하려고 한 질문 또는 문제
- 테스트된 가정 (수정 사항 / 변경된 내용을 먼저 제시)
- 입증된 사실 (출처 있음) vs 출처 없는 주장 (중간 신뢰도)
- 방법, 한계, 미해결 질문, 다음 조치 (제품/연구 결정, 로컬 실행 설명서 제외)
의도가 research-finding에 가까운 경우, 다음도 캡처:
- 설명 메커니즘 (수치 포함: 지배적 신호, FP 패턴, 반사실)
- 사용자가 강조한 결과 ("주요 결과에 포함")
- 실험? 세션이 N개 조건 (캡, 모드, 범위, 설정, A/B군)에서 동일한 측정을 비교하는 경우, 각 조건과 결정적 증거 테이블 (스코어카드, 차이 구성, 동등성 검사)을 나열합니다.
fill: experiment플래그를 지정합니다.
의도가 proposal에 가까운 경우, 다음도 캡처:
- 문제 / 누가 피해를 보는지, 권장 사항, 왜 지금인지, 접근 방식, 대안 (출처가 있을 경우 포함), 위험
- 세션에서 논의된 단기 다음 단계
완료: 의도 신호, 수정 사항, 출처 있는 사실, 분기별 메모가 캡처됨. 아직 해석하지 않음.
2. 경로 설정
아래 카탈로그에서 정확히 하나의 페이지 유형을 선택합니다. 공지합니다: 페이지 유형: ....
| 페이지 유형 | 사용 시기 | 다른 것을 선호할 때 |
|---|---|---|
research-finding | 증거가 "무엇이 사실인가?"에 답할 때 | 세션이 주로 새로운 증거 없이 결정인 경우 |
proposal | 세션이 결정을 구성할 때 (문제, 경로, 이유, 방법) | 세션이 권장 변경 없이 순수 측정인 경우 |
검증 및 아키텍처는 나중으로 미룹니다. 세션이 해당 형태만 있는 경우, 가장 가까운 라이브 유형을 묻거나 중단합니다.
완료: 하나의 페이지 유형이 선택되고 공지됨.
3. 압축
경로 설정된 유형에 대한 템플릿을 로드합니다 (컨텍스트 포인터 — 해당 파일만 읽음):
research-finding→ templates/research-finding.mdproposal→ templates/proposal.md
쉬운 가독성을 위해 골격을 채웁니다: 콜드 리더가 몇 초 안에 주장을 파악하고 각 섹션에서 하나의 흐름을 따라갈 수 있어야 합니다.
research-finding 채우기 경로
- 기본값: 가정 → 결과 → 주요 결과 (템플릿 기본 골격).
- 실험 (채굴에서
fill: experiment플래그가 지정된 경우): 템플릿 실험 스파인을 사용합니다. 공지합니다:채우기 경로: 실험.- 결과 사다리: 중첩 글머리 기호 (조건당 하나의 판결) + 선택적 최종 결론; N개 조건을 하나의 거대한 문장으로 압축하지 마십시오.
- 조건 이전 컨텍스트 (선택 사항): 답변 이후, 비교의 측면과 혼동하기 쉬운 용어 (예: 유형 vs 인스턴스 수)를 설명하는 짧은 블록을 추가하여 테이블이 잘못 읽히지 않도록 합니다. 질문만으로 충분하지 않을 때만 사용합니다. 이 문서를 읽는 방법과 같은 일반 제목을 선호합니다. 불필요할 때는 생략합니다. 필수 섹션 이름을 임의로 만들지 마십시오.
- 조건 섹션: 조건당 하나의 최상위 섹션; 각 섹션은 판결 다음 분석입니다. 원시 노브(“MaxMessages = 100”)가 아닌 공정성 또는 결과 (예: “공정한 A/B: 캡 제거됨”)로 섹션 제목을 지정합니다. 공유 가능한 증거는 분석에 넣습니다 (스코어카드 및/또는 동일 결론 / 차이 구성 표).
- 복제: 결정적/공정한 조건 아래에 중첩 (예: 다중 세션 확인); 반복을 위해 최상위 조건 섹션을 추가하지 마십시오.
- N-조건 실험을 가정 → 결과 → 주요 결과로 평탄화하지 마십시오.
가독성 (모든 페이지)
- 구체적인 내용으로 시작: 제목과 결과는 숫자, 판결 또는 결정으로 시작합니다. 컨텍스트는 뒤따릅니다. 페이지를 열지 않습니다. 실험의 경우 결과가 글머리 기호 사다리를 담고 있다면 제목이 비교를 명명할 수 있습니다.
- 예시 후 설명: 결과, 주요 결과, 분석 및 방법에서 측정된 결과 또는 선택한 경로를 먼저 진술한 다음, 필요한 경우 한 줄의 컨텍스트를 추가합니다.
- 섹션당 하나의 작업: 각 제목은 하나의 작업을 수행합니다. 섹션이 두 가지를 주장하는 경우 분할하거나 삭제합니다.
- 답변 콜드 리더가 페이지 유형에 상관없이 사용할 수 있어야 함: 결과 (TLDR) / 신뢰도 / 그래서 무엇?
- 제목은 주장입니다 (대화록에 측정된 숫자가 있으면 포함; 실험은 숫자를 결과에 넣을 수 있음)
- 권장 사항: 세션에서 논의된 조치만 포함합니다. 세션이 질문에만 답변한 경우 (폐쇄된 연구, 제품 결정 없음), 없음 (또는 "연구 완료, 후속 조치 없음")을 작성합니다. 다음 단계, 문서 TODO, 검토자 숙제 또는 "~1주" 계획을 임의로 만들지 마십시오.
- 헤더: 소유자, 자세히 알아보기
- 검토 섹션이 있어야 함
소유자: 실제 사람을 확인합니다. Confluence 대상인 경우 게시 시 Atlassian 멘션을 사용합니다 (publish.md). 그렇지 않으면 표시 이름을 사용합니다. 알 수 없으면 질문합니다. 연기된 경우에만 TBD.
완료: 경로 설정된 골격이 채워짐 (기본값 또는 실험); 크롬 완료; 소유자가 확인되거나 명시적 TBD; 제목과 결과가 구체적인 주장으로 시작함.
4. 검증
모든 검사가 통과할 때까지 실패하고 편집합니다. 이 단계는 품질의 단일 진실 공급원입니다 (템플릿은 이러한 규칙을 다시 명시하지 않음).
모든 페이지
- 모든 사실 셀/글머리 기호는 대화록에서 추적 가능해야 함
- 측정되지 않은 크기 없음
- 콜드 리더 답변이 페이지 유형을 읽지 않고 작동해야 함; 결과는 TLDR이며 구체적인 주장으로 시작해야 함 (실험 결과는 글머리 기호 사다리일 수 있음)
- 제목은 주장으로 시작해야 함 (주제나 부드러운 헤더가 아님); 실험은 결과가 지분/숫자를 담고 있다면 제목에 비교를 명명할 수 있음
- 본문은 경로 설정된 페이지 유형과 일치해야 함 (혼합 스파인 금지)
- 섹션당 하나의 작업; 설명과 권장을 동시에 하는 섹션 없음
- 크롬 완료 (소유자, 자세히 알아보기)
- 자세히 알아보기 / 권장 사항은 로컬 실행 설명서의 내용을 포함하지 않아야 함
- 신뢰도는 증거와 일치해야 함; 제목은 측정된 숫자와 일치해야 함 (또는 실험 사다리의 경우 결과가 일치)
- 한 페이지 분량 예산: 약 600 단어의 산문; 초과 시 가장 덜 중요한 아이디어를 삭제합니다 (글꼴 크기를 줄이거나 부록을 채우지 마십시오). 예외: 실험 결정적 증거 테이블 (스코어카드, 차이 구성, 동등성 검사)은 예산을 맞추기 위해 삭제하지 않습니다. 대신 주변 글머리 기호를 줄입니다.
- 답변 + 권장 사항에 대한 명확한 통과: 능동태, 짧은 단어, 불필요한 단어와 전문 용어 제거
- 템플릿 연결구 없음: "오늘날의 환경에서", "게임 체인저", "이것이 중요한 이유는 다음과 같습니다" 또는 참여를 위해 추가된 닫는 질문과 같은 문구 제거
- 부드러운 요약 없음: 권장 사항은 결과를 다시 표현하지 않음
- 임의의 후속 조치 없음: 다음 단계는 대화록에서 논의된 경우에만 포함; 그렇지 않으면 권장 사항은 없음 / 연구 완료
- 모든 섹션은 새로운 내용을 추가해야 함; 이전 섹션을 다시 설명하는 채우기 삭제
연구 결과 (research finding) 전용
- 결론 섹션은 신뢰도 및 후속 실험을 위한 질문을 포함해야 함; 잘못된 가설을 반복하지 않음 (가정 섹션에서 이미 다룸)
- 실험: 실험 스파인 사용 시 조건당 하나의 판결; 공정한 비교를 위한 컨텍스트 및 가독성을 위한 용어 설명 포함; 분석은 공유 가능한 증거를 제공해야 함
- 비실험 연구 결과: 하나의 결론; 차이 구성과 같은 예비 탐색 분석 포함 가능
제안 (proposal) 전용
- 결정은 문제에 의해 동기 부여되어야 함 (기술적 기회가 아님); 제안은 누구에게, 왜 지금인지 명시
- 대안은 출처가 있을 때 포함
- 권장 사항은 다음 조치를 포함할 수 있지만 로컬 실행 설명서가 아님
- "~1주" 계획과 같은 임의의 일정 없음
- 검증 전략 존재하는 경우에만 포함; 임의로 만들지 않음
완료: 모든 검사 통과. 필터가 통과하지 않은 텍스트를 걸러냄. 페이지는 게시 준비 완료.
5. 게시
대상에 따라 게시합니다 – 구현 세부 사항은 publish.md 참조.
완료: 문서가 게시됨. 성공 메시지 및 게시된 위치에 대한 간략한 정보 (예: Confluence Cloud 페이지의 경우 URL)를 사용자에게 보여줍니다. 원본 링크도 포함합니다.