abhishekkumar541/pre-ai-writing

Pre-AI 글쓰기

문서들이 단어 수준의 교정으로는 고칠 수 없는 구조적 이유로 LLM 출력물처럼 읽히는 경우가 있습니다.

• 문장 시작 레이블 ("답은 한 줄로.")
• 읽기 안내
• 모든 사실에 붙는 상태 태그
• 모든 섹션의 반대 의견
• 모든 것을 위한 표
• 모든 단락에 포함된 URL

2022년 11월 이전 사람들이 글을 쓰던 방식으로 작성하세요: 목적을 먼저, 다음에 가정, 평이한 제목, 각 섹션의 첫 문장에 핵심, 대부분 산문, 마지막에 일련번호가 있는 출처 목록. 그런 다음 humanizer 스킬(https://github.com/blader/humanizer)이 문장을 처리합니다.

references/rules.md에는 모든 규칙이 '전/후' 예시와 함께 있습니다. references/structures.md에는 문서 유형별 템플릿이 하나씩 있습니다. 아래 경로는 이 스킬 폴더를 기준으로 합니다.

워크플로우

1. 프레임 설정. 채팅 한 줄에 네 가지를 명시합니다:

   • 독자
   • 독자가 읽는 시점 (받은 편지함, 면접 패널, 피드)
   • 유형: 과제, 메모, 이메일, 자기소개서, 게시물, 이력서, 프레젠테이션, 랜딩 페이지 또는 문서
   • 중요도

   높은 중요도는 채용 지원이나 과제, 고객 납품물, 임원 대상 자료, 또는 사용자가 높은 중요도라고 말한 모든 것을 의미합니다. 라인이 작성되면 완료.

2. 초안 작성 전 수집. 다음을 수집합니다:

   • 브리핑의 정확한 문구, 길이나 페이지 제한 포함.
   • 커버리지 테이블: 브리핑이 요구하는 모든 내용을 답변할 섹션에 매핑합니다. 채팅이나 메모에만 유지하고 문서에는 넣지 않습니다.
   • 일차 증거, 각 항목과 출처.
   • 사용자의 직접적인 표현 (노트나 이전 메시지에서).
   • 고객 카피의 경우, 고객의 직접적인 표현 15~20개.

   출처가 없는 계획된 주장은 "문의"로 표시합니다. 모든 계획된 주장에 출처 또는 "문의"가 있으면 완료.

3. 구조화. references/structures.md에서 템플릿을 선택하고 각 섹션에 중요도에 따른 단어 예산을 할당합니다. 브리핑의 제한이 기본 길이보다 우선합니다. 예산이 포함된 개요가 존재하면 완료.

4. 초안 작성 <이름>_draft.md로, references/rules.md 및 references/evidence.md를 따릅니다. 상태 레이블, 접근 날짜 및 번호가 매겨진 표는 <이름>_notes.md에 저장합니다.

5. 린트 실행. 다음을 실행합니다:

   python3 scripts/lint_doc.py --type <유형> <파일>
   

   프레젠테이션의 경우 슬라이드 폴더를 전달하고; <aside>는 발표자 노트로 읽힙니다. 모든 FAIL을 수정합니다. 각 WARN을 수정하거나, 채팅에서 유지 이유를 설명합니다. 종료 코드가 0이면 완료.

6. 휴머나이저. 세 줄짜리 이메일이라도 Skill 도구로 humanizer 스킬을 호출합니다. 수동으로 "내가 직접 확인했다"는 통과로 인정되지 않습니다; 새로운 세션은 테스트에서 이 단계를 건너뛰었습니다. 산문에 대해서만 임베디드 모드로 실행합니다. 표, 인용된 카피, 코드 및 출처 목록은 그대로 둡니다. 결과를 새 파일로 저장하고 다시 린트합니다. 새 파일이 깨끗하게 린트되면 완료.

7. 사용자 관련 주장. 사용자의 행동, 습관, 결과, 사용 방식 또는 감정을 진술하는 모든 문장을 나열합니다. 각각을 사용자의 이력서, 노트, 기억 또는 이 대화에서 말한 내용으로 추적합니다. 출처가 없는 것은 질문하거나 삭제합니다. 채팅 테이블(주장 | 출처 | 유지, 삭제 또는 문의)이 모든 해당 문장을 포함하면 완료. 8.명명된 독자로서 읽어보기. 각 질문에 예/아니오로 답하고, 잘못된 답변을 모두 수정합니다:

   • 각 섹션의 첫 문장이 핵심을 전달합니까?
   • 각 단락이 잘리면 독자가 놓칠까요?
   • 문서 자체를 설명하는 문장이 있습니까?
   • 섹션 길이가 중요도를 따릅니까?
   • 여기서 일차 작업에서만 나올 수 있는 내용은 무엇입니까? (이름을 대시오; 없으면 초안이 일반적입니다.)
   • 모든 숫자가 노트로 추적됩니까?
   • 다음 단계나 요청으로 끝납니까?
   • 형식이 전달될 위치에 적합합니까? (이메일 및 링크드인은 일반 텍스트, 마크다운 없음.)

8. 높은 중요도 등급만 해당. 1단계에서 높은 중요도라고 할 때마다 이 단계가 필요하며, 짧은 텍스트도 포함됩니다. references/high-stakes.md를 따릅니다:

   • 새로운 에이전트가 독자 관점 검토 수행
   • 과제 및 제안의 경우 기준선과 함께 scripts/sameness_check.py 및 scripts/blind_pack.py를 통한 블라인드 검토

   통과 규칙이 충족되거나 실패가 보고되면 완료.

9. 인계 대상 형식으로:

   • 이메일 및 게시물: 일반 텍스트
   • 문서: 마크다운 또는 문서 파일
   • 프레젠테이션: 슬라이드

   커버리지, 주장 및 상태 테이블은 채팅 또는 <이름>_notes.md에 둡니다. 사용자가 요청하거나 납품물이 PDF인 경우에만 PDF를 만듭니다:

   python3 scripts/build_pdf.py in.md out.pdf --title "..." --footer-left "..."
   

   그런 다음 출처 페이지를 포함한 페이지 이미지를 확인합니다. markdown을 가져오므로 -I 없이 실행합니다.

다른 스킬을 재정의하는 규칙

• 대시. 따옴표와 노트를 포함하여 U+2014 또는 U+2013을 어디에도 사용하지 않습니다. 이것은 작성자의 자체 규칙입니다; 대시가 허용되는 스타일이라면 scripts/lint_doc.py에서 dash 검사를 삭제하세요.
• 수정은 새 버전입니다. 원본 납품물을 조용히 편집하지 마십시오.
• 프로세스는 페이지 밖에 둡니다. 방법, 프로세스 및 AI 사용은 출처 슬라이드나 노트에 한 줄로만 기재하고, 섹션이나 슬라이드로 만들지 않습니다.
• 이 스킬이 최종 패스입니다. 카피라이팅, 이메일 및 이력서 스킬은 내용을 초안합니다; 이 스킬은 그 후에, 그 대신이 아니라 실행됩니다.

파일

• scripts/lint_doc.py: 구조 및 표현 린터. --help로 플래그 확인; --fix-typography OUT은 수정된 복사본을 작성합니다.
• scripts/sameness_check.py, scripts/blind_pack.py: 높은 중요도 키트.
• scripts/build_pdf.py: 마크다운을 PDF로 변환, 검사 포함.
• scripts/prompt_trigger.py: 선택적 UserPromptSubmit 후크로, Claude에게 이 스킬 사용을 상기시킵니다 (README 참조).
• references/:
  • structures.md
  • rules.md
  • evidence.md
  • voice.md
  • high-stakes.md
• templates/blind_review_prompt.md
• tests/test_lint_doc.py: 규칙 변경 후 실행합니다.