AI 도구 사용 지침

이슈나 PR을 제출하는 사람은 작성 과정에서 AI 도구를 사용했는지와 관계없이 그 내용에 책임을 집니다. 생성형 AI 도구는 결과물을 빠르게 만들어 낼 수 있지만, 모든 좋은 기여의 토대는 신중함, 올바른 판단력, 비판적 사고입니다. 저희는 좋은 코드, 간결하고 정확한 문서, 불필요한 코드 변경 없이 범위가 잘 정해진 PR을 중요하게 여깁니다.

성공을 위한 고려 사항

작성자는 AI 도구가 수행한 작업을 PR로 제안하거나 이슈로 등록하기 전에 자세히 검토하여 실제로 타당한지 확인해야 합니다.

PR 작성자와 이슈 등록자는 자신이 제안한 변경 사항을 자신의 말로 설명할 수 있어야 합니다.

필수는 아니지만, PR 설명에 AI 도구 사용 사실을 밝혀 주시면 감사하겠습니다. 도구를 어떻게 사용했는지, 그리고 도구가 어떤 변경을 했는지 설명할 수 있도록 준비하십시오.

AI 도구 사용 여부와 관계없이, 기여의 품질을 위해 다음 원칙을 염두에 두십시오:

• 변경이 꼭 필요한지 검토하십시오

• 변경은 최소한으로 하고, 한 가지에 집중하십시오

• 기존 코딩 스타일과 패턴을 따르십시오

• 변경 사항을 검증하는 테스트를 작성하십시오

• 이전 릴리스와의 하위 호환성을 염두에 두십시오. 기존 테스트가 특정 API 동작이 유지되도록 보장하고 있을 수 있습니다.

변경 사항 테스트에 관해 AI가 생성한 권장 사항에 각별히 주의하십시오. AI 모델을 안내할 때는 Python의 테스트 원칙에 관한 정보를 제공하십시오. 풀 리퀘스트나 이슈를 열기 전에, 제안된 PR이나 이슈의 제목과 설명을 포함하여 결과물을 항상 검토하십시오.

허용되는 사용 사례

생성형 AI의 허용되는 사용 사례는 다음과 같습니다:

• 특히 모국어가 아닌 언어로 코멘트를 작성할 때 도움받기

• 기존 코드 이해하기

• 코드, 테스트, 문서에 관한 기여자의 지식 보완하기

허용되지 않는 사용 사례

메인테이너는 AI 도구 사용 여부와 관계없이, 유용하지 않거나 생산적이지 않은 이슈와 PR을 설명 없이 닫을 수 있습니다.

기여자가 비생산적인 이슈나 PR을 반복해서 여는 것은 프로젝트에 지장을 주고 메인테이너의 시간을 존중하지 않는 행위이므로, 해당 기여자는 프로젝트 기여가 차단될 수 있습니다.

실패하는 테스트를 통과시키기 위해 기존 테스트를 수정하거나 우회하는 것, 또는 필요한 기능을 제거하는 것은 허용되지 않습니다. 이러한 변경은 진정한 수정이 아닙니다.