주석과 설명문 형식 맞춰 달기

예시를 프롬프트 안에 직접 넣은 것이 그 장치입니다. "의미 있는 주석을 달아 주세요"는 아무것도 지정하지 않은 문장이라 결과가 바뀌지 않습니다. 나쁜 주석 한 줄과 좋은 주석 한 줄을 나란히 보여 주면 AI가 기준을 잡고, 그 뒤로는 다른 줄에도 같은 밀도로 적용합니다.

제약은 두 방향으로 걸어 두었습니다. "코드는 한 글자도 바꾸지 마세요"가 없으면 AI는 주석을 달면서 변수 이름을 바꾸거나 조건문을 정리해 버립니다. 주석만 확인하려던 차이가 코드 변경과 섞이면 검토가 어려워집니다. "줄마다 달지 마세요"는 반대쪽 과잉을 막고, "확인이 필요한 곳" 목록은 AI가 모르는 것을 아는 척 주석으로 쓰는 대신 꺼내 놓을 자리를 줍니다.

주석 형식을 문장이 아니라 이름으로 지정하는 것도 중요합니다. docstring 자동 생성을 여러 번 돌리면 어떤 함수는 파라미터 표가 붙고 어떤 함수는 한 줄 설명만 붙는 일이 흔한데, 형식 이름을 매번 같이 적으면 파일 전체가 같은 모양으로 유지됩니다. 코드를 """ 로 감싼 것은 코드 안의 기존 주석이 지시로 읽히지 않게 하기 위해서입니다.