테마 전환

AI로 기술 블로그를 쓰는 방법: 자료 조사, 코드 검증, 사람의 검토

Easton editorial illustration: central technical article manuscript with code lines and verified citation markers, circular four-stage verification hub

"Google: 유용하고 신뢰할 수 있으며 사람을 우선하는 콘텐츠 만들기"

기술 글에 코드 블록이 세 개 있지만 하나도 실행하지 않았다고 가정해 보겠습니다. 독자는 코드를 복사한 뒤 오류를 만납니다. 문제는 문장이 매끄럽지 않은 것이 아니라 사실과 코드가 아무런 게이트도 통과하지 않았다는 데 있습니다.

AI 초안은 완성되어 보이면서 버전, 명령 인수, 출력 형식을 추측할 수 있습니다. 어떤 프로젝트는 package.json에 "type": "module"을 선언했는데 예제에서는 곧바로 require를 씁니다. 다른 글은 “GitHub Actions는 매달 2,000분을 제공한다”고 쓰면서 이 수치가 특정 요금제의 비공개 저장소에 포함된 사용량이라는 조건을 설명하지 않습니다.

기술 블로그 작성은 주제를 모델에 던진 뒤 문장만 다듬는 작업이 아닙니다. 먼저 자료와 실행 가능한 증거를 확보하고, AI가 설명을 구성하게 한 다음, 사람이 사실과 코드와 문체를 검토해야 합니다. 아래 절차는 각 단계의 게이트와 담당자를 정해 사실의 정확성, 코드 실행 가능성, 결론의 재현성을 지킵니다.

AI에게 초안을 맡기기 전에 자료부터 조사하기

먼저 조사할 내용과 AI가 작성해도 되는 내용

첫 번째 판단은 외부에서 확보해야 하는 사실과 모델이 구성해도 되는 부분을 나누는 것입니다.

조사 대상은 세 가지로 나눌 수 있습니다.

버전, API 필드 변경, 공식 문서의 제한, 가격이나 사용량, 보안 설정은 먼저 조사해야 합니다. 이런 정보가 틀리면 독자의 프로젝트가 실패하거나 예상하지 못한 비용이 생깁니다. 예를 들어 현재 Next.js 문서는 turbopack 설정 키를 사용하지만 13.0.0부터 15.2.x까지는 experimental.turbo를 사용했습니다. 적용 버전을 밝히지 않고 “Turbopack을 설정한다”고만 쓰면 호환되지 않는 구성을 복사하게 할 수 있습니다.

일반 개념, 프레임워크 사용법, 모범 사례, 흔한 오류는 AI가 초안을 쓸 수 있지만 사람이 검토해야 합니다. React hooks 사용 원칙은 그럴듯하게 작성할 수 있어도 규칙 수, 이름 규칙, 버전 차이는 공식 문서와 대조해야 합니다.

순수한 구조 정리, 문체 편집, 형식 정리는 AI에게 맡길 수 있습니다. 기술 설명을 더 자연스럽게 바꾸거나 흩어진 문단을 한 절로 합치는 데는 보통 추가 조사가 필요하지 않습니다.

비교:

조사 유형대표 내용게이트 강도적용 단계
먼저 조사버전, API 필드, 가격이나 사용량, 보안높음: 공식 문서에서 추출하고 [VERIFY] 표시기획 때 준비하고 작성 당일 재확인
AI 초안 + 검토일반 개념, 프레임워크 사용법, 모범 사례중간: AI 초안을 공식 문서와 대조본문 작성 후 검토 단계에서 확인
AI 작성구조, 문체, 형식낮음: 추가 조사 불필요본문 작성 단계

조사 결정 트리:

X 유형의 내용을 만남
  ↓
버전, API, 가격, 보안과 관련 있는가?
  ├─ 예 → 공식 문서에서 추출하고 [VERIFY] 표시 후 작성 당일 재확인
  └─ 아니요 → 기술 규칙이나 모범 사례와 관련 있는가?
      ├─ 예 → AI가 초안을 쓰고 검토 때 공식 문서와 대조
      └─ 아니요 → AI가 표현을 구성

조사 결과를 outline 입력에 표시하는 방법

조사가 끝나면 결과를 outline input에 넣어 AI 작성 단계가 바로 인용할 수 있게 합니다.

research.md에서 high로 표시된 신뢰도 높은 공식 자료를 추출합니다. Google Search Central의 helpful content 지침, GitHub Actions의 공식 Node.js CI 예제, Astro Content Collections 공식 문서가 그 예입니다.

변동 가능한 사실에는 [VERIFY]를 붙입니다. 예를 들어 “GitHub Actions 비공개 저장소의 포함 사용량은 계정 요금제에 따라 다름 [VERIFY]”, “대상 Node 버전이 현재도 지원되는지 확인 [VERIFY]”와 같이 기록합니다.

출처 카드, 명령 출력, 검토 결과를 outline input의 source_cards와 risk_notes에 넣습니다.

{
  "source_cards": [
    {
      "url": "https://developers.google.com/search/docs/fundamentals/creating-helpful-content",
      "type": "official/docs",
      "confidence": "high",
      "usable_info": "콘텐츠는 독창적인 정보와 완전한 설명을 제공하고 대량 자동화에 주로 의존하지 않아야 함"
    }
  ],
  "risk_notes": [
    {
      "fact": "GitHub Actions 무료 사용량",
      "status": "[VERIFY]",
      "check_date": "2026-06-24",
      "source": "https://docs.github.com/en/billing/managing-billing-for-github-actions"
    }
  ]
}

표시가 끝나면 작성 단계에서 조사를 전부 반복하지 않고 변동 사실만 다시 확인하면 됩니다.

코드 예제는 보기만 하지 말고 반드시 검증하기

네 가지 코드 검증 상황

기술 글의 코드는 보기에는 맞지만 실제로 실행하면 실패하는 경우가 많습니다. 독자가 복사한 코드에서 오류를 만나면 글에 대한 신뢰가 바로 사라집니다.

코드 검증은 네 가지 상황으로 나눕니다.

로컬 실행에는 설치 명령, 설정 예제, 간단한 스크립트가 포함됩니다. npm install, git clone, 설정 파일 수정 등이 해당합니다. 실제 로컬 환경에서 실행하고 출력을 기록해야 합니다.

CI 테스트에는 빌드와 테스트 명령, 환경 의존성이 포함됩니다. GitHub Actions의 npm ci, npm run build, npm test가 예입니다. CI는 환경 일관성을 확보할 수 있어 이런 명령을 검증하기에 적합합니다.

버전 관리에는 Node, 의존성, API 버전이 포함됩니다. .nvmrc, package.json, API endpoint 변경 등이 해당합니다. 버전을 명시하고 차이를 본문에서 설명해야 합니다. 환경 일관성은 개발, 프로덕션, CI의 설정 차이를 다룹니다. 환경 변수, Docker 이미지, 운영체제가 달라질 수 있으므로 실행 환경을 표시해야 다른 조건에서 생기는 오류를 줄일 수 있습니다.

비교:

검증 상황대표 내용검증 방법필수 증거
로컬 실행설치 명령, 설정 파일로컬 실행명령 출력 텍스트 또는 캡처
CI 테스트빌드, 테스트 명령GitHub Actions 또는 다른 CICI 로그 또는 빌드 결과 캡처
버전 관리Node와 의존성 버전버전 확인 명령node --version 출력 + 버전 표기
환경 일관성환경 변수, Docker여러 환경에서 테스트하거나 조건 명시환경 표기 + 조건 설명

코드 실행 증거를 기록하는 방법

모든 코드 예제에는 실행 증거가 필요합니다. “성공했다”고만 쓰면 안 됩니다. 아래 명령과 출력은 증거 기록 형식을 보여 주는 예시이며 재사용 가능한 실제 검증 자료가 아닙니다. 자신의 글에서는 대상 프로젝트의 실제 버전과 로그로 교체해야 합니다.

Node.js CI 명령 예시:

# 로컬 환경: macOS + Node 18.20.0 LTS
$ node --version
v18.20.0

# CI 환경: GitHub Actions
$ npm ci
added 245 packages in 12s

$ npm run build
✓ Built in 1.23s

$ npm test
✓ 12 tests passed

출력 비교:

✅ 올바른 예: 명령 출력의 캡처나 텍스트를 제공하고 버전과 핵심 출력을 표시합니다.

❌ 잘못된 예: 출력 증거 없이 “실행 성공”이라고만 씁니다.

코드 블록은 fenced code block과 bash, typescript 같은 언어 표시를 사용합니다. 긴 출력은 접기 영역에 넣거나 핵심만 보여 줍니다. 여러 단계의 명령은 로컬, CI, Docker 같은 실행 환경을 표시합니다. 버전 확인에는 node --version이나 npm --version 출력을 포함합니다.

예시:

# 실행 환경: macOS + Node 18.20.0
$ npm install
added 124 packages in 8s

$ node --version
v18.20.0

출력이 길면 핵심만 보여 줍니다.

$ npm run build
✓ Built in 1.23s
  ├─ dist/index.html
  ├─ dist/assets/index.js
  └─ dist/assets/index.css

GitHub 공식 문서는 Creating and highlighting code blocks에서 fenced code block과 구문 강조를 권장합니다. 기술 블로그도 이 기준을 지키고 코드를 일반 문장처럼 숨기지 않아야 합니다.

사람의 검토는 문장 다듬기가 아니라 사실, 코드, 구조 확인

사실 검토: 버전, 매개변수, 가격의 출처 확인

사람의 검토는 사실, 코드, 구조의 세 층을 다룹니다. 검토를 “표현을 조금 고치는 일”로 이해하면 버전 오류, 잘못된 명령 인수, 코드와 맞지 않는 결론을 놓칩니다.

사실 검토의 핵심은 추적 가능성입니다. 버전, API 필드, 명령 인수, 설정값, 가격과 사용량, 출시일을 공식 문서나 실제 실행 결과와 대조해야 합니다.

체크리스트:

항목검토 방법실패 신호올바른 예
버전공식 release 또는 문서와 대조버전이 없거나 기능 설명이 틀림공식 링크 + node --version 출력
명령 인수공식 CLI 문서와 대조인수가 없거나 형식이 틀림공식 링크 + 실제 명령 출력
API 필드공식 API 문서와 대조필드가 없거나 타입이 틀림공식 API 링크 + 실제 요청
가격이나 사용량공식 가격 페이지와 대조가격이 틀리거나 공개/비공개 조건이 없음공식 가격 링크 + 사용 조건
출시일공식 공지나 블로그와 대조날짜가 틀리거나 사건이 없음공식 공지 링크

잘못된 예:

프로젝트가 package.json에 "type": "module"을 선언했지만 코드 예제는 .cjs로 바꾸거나 모듈 경계를 설명하지 않은 채 CommonJS의 require를 바로 사용합니다.

글은 “GitHub Actions는 매달 2,000분만 제공한다”고 하지만, 공개 저장소의 표준 GitHub-hosted runner는 무료이고 비공개 저장소의 포함 시간은 계정 요금제에 따라 달라진다는 조건이 없습니다.

올바른 예:

“Node 18은 ES modules와 CommonJS를 모두 지원하며 .mjs, .cjs, package.json의 type 필드가 파일 해석 방식에 영향을 줍니다. 실행 기록은 Node 18.20.0에서 만들었고 node --version 출력도 보관했습니다(출처: Node.js 공식 문서).”

“2026년 7월 26일 기준, 공개 저장소에서 표준 GitHub-hosted runner는 무료입니다. 비공개 저장소는 요금제별 포함 시간을 받으며 GitHub Free는 2,000분, GitHub Pro는 3,000분입니다(출처: GitHub Actions billing).”

코드 검토: 실행 여부, 출력 일치, 환경 표기

코드 검토는 명령이 실행되는지, 출력이 본문 설명과 일치하는지, 환경이 분명한지 확인합니다.

체크리스트:

항목검토 방법실패 신호올바른 예
명령 실행로컬 또는 CI에서 실행명령 오류나 의존성 누락실행 로그 또는 캡처
출력 일치본문 설명과 대조출력과 설명이 다름본문과 명령 출력 일치
환경 표기환경 설명 확인Node 버전이나 운영체제 없음Node 18.20.0 + macOS
의존성 버전package.json 확인본문과 버전이 다름package.json 또는 버전 출력

잘못된 예:

본문에는 “빌드가 성공해 파일 세 개가 생성됐다”고 적었지만 실제 npm run build 출력에는 파일이 다섯 개입니다.

본문에는 “로컬에서 실행됐다”고 쓰지만 코드 예제는 Docker에 의존하며 차이를 밝히지 않습니다.

올바른 예:

명령 출력과 같은 내용으로 “npm run build는 index.html, index.js, index.css 세 파일을 생성했습니다”라고 씁니다.

“이 글은 macOS와 Node 18.20.0에서 테스트했습니다. Linux, Windows 또는 다른 Node 버전에서는 경로를 조정해야 할 수 있습니다.”

구조와 문체 검토: H2/H3, 내부 링크, AI 표현 제거

구조와 문체 검토에서는 H2/H3가 outline과 일치하는지, 내부 링크가 계획한 위치에 있는지, AI 특유의 빈 표현이 제거됐는지 확인합니다.

체크리스트:

항목검토 방법실패 신호올바른 예
H2/H3 일관성outline.md와 대조H2/H3 누락 또는 추가outline 변경 이유 기록
내부 링크링크 계획과 대조링크 누락 또는 앵커 텍스트 오류계획한 위치에 배치
AI 표현anti-ai-words.json과 대조시대적 상투어 또는 모호한 약속구체적인 표현으로 바꾸거나 삭제

프로젝트의 anti-ai-words.json은 피해야 할 표현을 두 부류로 정의합니다. 검토할 때 빈말, 모호한 귀속, 과도한 약속을 찾아 바꾸거나 삭제합니다.

잘못된 예:

시대적 배경을 말하는 상투적인 문장으로 시작합니다.

검증 내용을 밝히지 않고 “이 글에서 전부 분석합니다”라고 약속합니다.

올바른 예:

상투어를 삭제하고 문제로 바로 들어갑니다. “AI로 기술 블로그를 쓸 때 먼저 답해야 할 질문은 어떤 사실을 외부에서 가져올지입니다.”

모호한 약속을 구체적인 판단으로 바꿉니다. “이 글은 실행 가능한 작성, 검증, 검토 절차를 제공합니다.”

게시 전 QA 체크리스트로 마무리하기

게시 전 QA 체크리스트

글을 다 썼다고 게시할 수 있는 것은 아닙니다. 게시 전 QA는 조사 표시, 코드 검증, 사실 추적, 구조 일관성, 내부 링크, AI 표현, 이미지 처리를 항목별로 확인하는 마지막 게이트입니다.

항목확인 방법통과 조건실패 처리
조사 표시 정리[VERIFY] 검색남은 표시 없음조사 단계로 돌아가 확인
코드 예제 검증실행 로그와 대조모든 예제에 출력 증거 있음코드 검증 단계로 돌아감
사실 추적 가능출처 카드와 대조모든 사실에 출처나 제한 표시 있음출처 추가 또는 주장 삭제
구조 일관성outline.md와 대조H2/H3 일치 또는 변경 설명 있음outline 갱신 또는 이유 기록
내부 링크 배치링크 계획과 대조모든 링크와 앵커가 정확함링크 추가 또는 계획 수정
AI 표현 제거anti-ai-words.json과 대조금지 표현 없음교체 또는 다시 작성
이미지 처리이미지 목록과 Markdown 경로 대조모든 경로가 유효하고 처리됨이미지 업로드 또는 경로 수정

상태:

✅ 통과: 게시 가능

⚠️ 보류: 재검토 또는 출처 보완 필요

❌ 실패: 다시 쓰거나 조사/검증 단계로 돌아가야 함

각 항목을 하나씩 확인하고 문제가 나오면 즉시 상태를 표시합니다. 모든 항목이 통과한 뒤에만 작업 상태를 “게시 가능”으로 바꿉니다.

문제가 발견되면 어디로 되돌릴까?

QA에서 문제를 찾으면 건너뛰지 말고 담당 단계로 되돌립니다.

사실 오류는 조사 단계로 돌아갑니다. 공식 문서를 추가하고, 추적할 수 없는 주장을 삭제하고, 변동 사실을 다시 확인합니다.

코드 오류는 코드 검증 단계로 돌아갑니다. 명령을 다시 실행하고 출력을 기록하며 본문의 예제를 고치고 실행 환경을 밝힙니다.

구조가 다르면 outline을 갱신하거나 이유를 기록합니다. 삭제하거나 추가한 H2/H3와 변경 이유를 남깁니다.

내부 링크가 없으면 cluster map과 사이트 인벤토리를 확인해 관련 글을 찾고 “여기를 클릭” 대신 설명형 앵커를 사용합니다.

AI 표현이 남아 있으면 anti-ai-words.json을 기준으로 바꿉니다. 구체적으로 바꿀 수 없다면 문단을 다시 씁니다.

반환 절차 예시:

QA가 GitHub Actions 사용량에 공개/비공개 조건이 없음을 발견
  ↓
실패로 표시
  ↓
조사 단계로 반환
  ↓
공식 결제 자료와 적용 조건 추가
  ↓
QA 다시 실행

이 경로를 사용하면 책임이 보입니다. 마지막 검토자는 설명 없이 바뀐 내용을 넘겨받지 않습니다.

글이 사실에서 벗어났음을 보여 주는 일곱 가지 신호

일곱 가지 신호

사실의 이탈은 조금씩 쌓입니다. 다음 신호를 이용하면 게시 전에 찾을 수 있습니다.

신호 1: 출처 없는 주장. “최신 버전”, “공식 권장”, “모범 사례”라고 쓰면서 링크가 없습니다. 예를 들어 공식 문서 없이 특정 Turbopack 키가 모든 Next.js 버전에서 작동한다고 말합니다.

신호 2: 실행하지 않은 코드. 출력이나 로그는 없고 “작동한다”는 말만 있습니다.

신호 3: 잘못 분류한 버전이나 매개변수. 버전은 존재하지만 release 라인이나 지원 상태가 틀릴 수 있고 매개변수와 endpoint도 바뀝니다. Node 20.1.0은 LTS가 아니라 Current였습니다.

신호 4: 일치하지 않는 환경. 증거에는 한 환경이 적혀 있지만 동작은 다른 환경에서 확인했습니다.

신호 5: 재현할 수 없는 결론. 방법, 데이터, 절차 없이 성능 향상을 주장합니다.

신호 6: 끊어진 내부 링크. 글이 /posts/ai/ai-xxx를 가리키지만 해당 경로가 없습니다.

신호 7: 모호한 문장이 증거 부족을 가립니다. “전면 분석”이 출처나 결과를 대신합니다.

예시:

신호잘못된 예문제
출처 없음“이 Turbopack 키는 모든 Next.js 버전에서 작동한다”공식 문서 없음
코드 미실행“npm install을 실행하면 작동한다”증거 없음
버전 오류“Node 20.1.0 LTS”20.1.0은 Current였음
환경 불일치기록은 이전 환경이고 검증은 다른 환경버전과 환경 불일치
결론 재현 불가“성능이 크게 향상된다”방법과 데이터 없음
링크 끊김/posts/ai/ai-xxx 링크경로가 없음
AI 표현“AI 글쓰기 전면 분석”모호한 약속

신호가 보이면 [VERIFY]를 붙이고 담당 단계로 되돌립니다.

출처 없는 주장은 조사로, 실행하지 않은 코드는 검증으로, 잘못된 버전은 공식 release 확인으로 돌아갑니다. 환경이 다르면 올바른 조건을 적거나 주장을 삭제합니다. 재현할 수 없는 결론에는 방법, 데이터, 절차를 추가하거나 삭제합니다. 끊어진 링크는 실제 경로로 고칩니다. 모호한 문장은 구체화하거나 제거합니다.

즉시 되돌려야 합니다. 그렇지 않으면 작은 불확실성이 쌓여 추적할 수 없는 글이 됩니다.

완전한 실험 환경이 없어도 정직하게 쓰기

세 가지 정직한 작성법

유료 서비스, 복잡한 클러스터, 특정 운영체제나 하드웨어가 없을 수 있습니다. 이때 증거를 만들어 내면 안 됩니다. 세 가지 대안을 사용할 수 있습니다.

첫째, 조건과 제한을 밝힙니다. 테스트한 버전과 가능한 차이, 무료 요금제만 테스트했다는 사실을 적습니다. 예: “이 예제는 Node 18.20.0에서만 검증했으며 다른 버전에서는 결과가 다를 수 있습니다.”

둘째, 대체 검증 방법을 제공합니다. 최소 재현, Mock 데이터, 공식 issue를 사용할 수 있습니다. 예: “사용 가능한 Kubernetes 클러스터가 없어 최소 재현만 제공하며 실제 클러스터에서 추가 검증해야 합니다.”

셋째, 검증하지 못한 사실을 인정합니다. “현재 환경에서는 이 성능 결론을 재현하지 못했습니다”라고 쓰거나 주장을 삭제합니다.

비교:

상황오해를 부르는 표현정직한 표현
버전 차이“모든 버전이 지원한다”“Node 18.20.0에서 검증했으며 다른 버전은 다를 수 있다”
환경 차이“로컬에서 작동했다”“macOS와 Node 18.20.0에서 테스트했으며 Linux, Windows 또는 다른 버전에서는 조정이 필요할 수 있다”
유료 서비스“무료다”“무료 요금제만 테스트했으며 유료 기능은 다를 수 있다”
미검증 주장“성능이 크게 향상된다”“현재 환경에서는 이 성능 결론을 재현하지 못했다”

올바른 예:

“테스트는 현재 하루 100,000회 요청이 포함된 Cloudflare Workers 무료 요금제를 사용했습니다. 유료 조건은 달라질 수 있으므로 공식 가격 페이지를 확인하세요.”

“사용 가능한 Kubernetes 클러스터가 없었습니다. 최소 재현은 실제 클러스터에서 Pod 리소스 제한과 네트워크 설정을 포함해 추가로 검증해야 합니다.”

“대규모 프로젝트의 측정 결과가 없으므로 Turbopack 빌드 성능을 단정하지 않습니다. 자신의 프로젝트에서 기준값과 비교값을 측정하세요.”

잘못된 예:

“Cloudflare Workers는 무료입니다.” 사용량 제한이 없습니다.

“모든 환경에서 작동합니다.” 환경 설명이 없습니다.

“성능이 크게 향상됩니다.” 방법과 데이터가 없습니다.

Google Search Central은 Creating helpful, reliable, people-first content에서 독창적인 정보, 완전한 설명, 유용한 분석을 권장합니다. 제한을 설명하는 것은 기준을 낮추는 일이 아니라 검증된 내용과 추가 테스트가 필요한 내용을 구분하는 일입니다.

초안을 게시할 때와 다시 검토할 때 판단하기

게시 결정 트리

게시 여부는 글자 수나 완성되어 보이는지에 달려 있지 않습니다. 조사, 검증, 검토, QA가 통과했는지로 결정합니다.

조사: 신뢰할 수 있는 출처를 모두 확보하고 변동 데이터를 표시했으면 검증으로 넘어갑니다. 핵심 출처가 없으면 조사합니다.

검증: 모든 예제가 작동하면 검토로 넘어갑니다. 실패한 예제는 고치거나 삭제합니다. 검증할 수 없는 예제는 제한을 밝히거나 제거합니다.

사람의 검토: 사실을 추적할 수 있으면 QA로 넘어갑니다. 출처 없는 주장은 문서화하거나 삭제합니다. 설명된 구조 변경은 진행할 수 있지만 설명 없는 이탈은 기획으로 돌아갑니다.

게시 전 QA: 모두 통과하면 글이 진행됩니다. 보류 항목은 다시 검토하고 실패는 담당 단계로 돌아갑니다.

조사와 최신성 확인이 끝나고, 코드에 증거가 있으며, 검토가 사실과 구조를 확인하고, AI 표현이 제거되고, QA가 통과하면 게시로 진행할 수 있습니다.

출처, 로그, 내부 링크, 문체 정리가 빠졌다면 아직 작업이 남았습니다.

버전, 매개변수, 가격 같은 핵심 사실이 틀렸거나 주요 결론을 재현할 수 없거나 설명 없이 목표 구조를 벗어났다면 다시 검토해야 합니다.

각 단계에는 게이트가 있습니다. 실패는 원인으로 돌아가며 게시 단계까지 전달되지 않습니다.

우선순위:

사실 오류를 먼저 고치거나 삭제합니다. 다음은 독자가 복사할 수 있는 코드 오류입니다. 구조와 링크의 우선순위는 낮지만 게시 전에는 해결해야 합니다.

관련 글

AI에 프로젝트 맥락을 제공하려면 CLAUDE.md로 잘못된 코드 생성을 줄이는 방법을 읽어 보세요. 작성과 검토 단계를 재사용 가능한 절차로 만들려면 Claude Code Skill로 워크플로를 구성하는 방법을 참고하세요.

사이트에는 일반 콘텐츠 제작자를 위한 AI 글쓰기 워크플로도 있습니다. 그 글은 작성 속도를, 이 글은 기술 사실, 실행 증거, 게시 게이트를 중점적으로 다룹니다. 두 절차를 함께 사용할 수 있습니다.

AI 기술 글 작성 및 검증 절차

1차 자료에서 시작해 실행 가능한 증거와 사람의 검토로 AI 초안을 게시 가능한 기술 글로 완성합니다.

⏱️ Estimated time: 90 min

  1. 1

    Step 1: 자료를 모으고 위험 표시하기

    공식 문서, 1차 자료, 대상 버전과 환경을 정리하고 변동 가능하거나 확인되지 않은 사실을 표시합니다.
  2. 2

    Step 2: 확인된 자료만으로 초안 작성하기

    AI가 검증된 자료만 구성하도록 제한하고 버전, 매개변수, 가격, 출력, 실험 결론을 만들어 내지 못하게 합니다.
  3. 3

    Step 3: 코드와 명령 실행하기

    명시된 로컬 또는 CI 환경에서 설치, 빌드, 테스트, 배포 예제를 실행하고 버전과 핵심 출력을 보관합니다.
  4. 4

    Step 4: 사람이 검토하기

    출처, 명령 인수, 출력, 환경 조건, 구조, 표현을 항목별로 확인하고 문제를 담당 단계로 되돌립니다.
  5. 5

    Step 5: 게시 전 QA 완료하기

    표시를 해소하고 인용, 내부 링크, 제한 사항을 재검토한 뒤 모든 게이트가 통과하면 번역과 게시로 넘깁니다.

FAQ

AI가 기술 글에서 절대 만들어 내면 안 되는 정보는 무엇인가요?
버전, API 필드, 명령 인수, 설정값, 가격과 한도, 출시일, 플랫폼 정책, 보안 제한은 공식 문서나 1차 자료로 확인해야 합니다.
코드 예제는 언제 반드시 실행해야 하나요?
설치, 빌드, 테스트, 배포, 버전 확인 예제는 실행해야 합니다. 설정 조각도 최소한 구문과 구조를 검사해야 하며, 환경이 없을 때 성공 출력을 꾸며서는 안 됩니다.
사람은 AI 기술 글에서 무엇을 먼저 검토해야 하나요?
먼저 주장의 출처를 추적할 수 있는지 확인하고 코드, 명령, 출력, 환경을 대조합니다. 기술 증거가 확실해진 뒤 구조, 링크, 문체를 검토합니다.
조사, 코드 검증, 사람의 검토는 어떻게 연결되나요?
조사는 출처와 확인 항목을 만들고, 작성은 제한된 초안을 만들며, 검증은 실제 로그를 남깁니다. 사람이 출처와 로그를 대조한 뒤 게시 전 QA로 마무리합니다.
글이 사실에서 벗어났다는 신호는 무엇인가요?
출처 없는 주장, 실행하지 않은 코드, 잘못된 버전이나 매개변수, 일치하지 않는 환경, 재현할 수 없는 결론, 끊어진 링크, 증거 부족을 가리는 모호한 표현이 대표적입니다.
완전한 실험 환경이 없을 때는 어떻게 정직하게 써야 하나요?
실제로 검증한 버전과 환경을 밝히고 최소 재현이나 대체 검증 방법을 제공하며 미확인 결론을 표시합니다. 증거가 없는 주장은 삭제합니다.
AI 초안은 언제 게시할 수 있고 언제 되돌려야 하나요?
조사, 코드 검증, 사람의 검토, QA를 모두 통과해야 게시로 진행합니다. 출처나 로그가 없으면 보완하고 핵심 사실이 틀리거나 결론을 재현할 수 없으면 다시 검토합니다.

2분 읽기 · 게시일: 2026년 11월 13일

댓글

GitHub로 로그인하여 댓글을 남기세요

Easton BlogEaston Blog