AI 도구 사용 지침

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

성공을 위한 고려 사항

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

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

필수는 아니지만, PR 설명에 AI 도구 사용 사실을 공개하면 감사하겠습니다. 도구를 어떻게 사용했으며 어떤 변경을 수행했는지 설명할 준비를 하십시오.

AI 도구의 사용 여부와 관계없이 기여의 품질을 위해 다음 원칙을 명심하십시오:

• 변경이 필요한지 고려하십시오

• 최소한의 변경을 집중적으로 수행하십시오

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

• 변경 사항을 실행해 보는 테스트를 작성하십시오

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

변경 사항 테스트에 관해 AI가 생성한 권고 사항을 면밀히 살펴보십시오. AI 모델에 지침을 제공할 때 Python의 테스트 원칙에 관한 정보를 입력하십시오. 풀 리퀘스트나 이슈를 열기 전에 제안된 PR 또는 이슈의 제목과 설명을 포함한 결과물을 항상 검토하십시오.

허용되는 사용 사례

생성형 AI의 허용되는 사용 사례에는 다음이 포함됩니다:

• 특히 모국어가 아닌 언어로 주석을 작성할 때 도움받기

• 기존 코드 이해하기

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

허용되지 않는 사용 사례

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

기여자가 비생산적인 이슈나 PR을 반복해서 열면 프로젝트에 지장을 주고 유지관리자의 시간을 존중하지 않는 행위이므로 프로젝트 기여가 차단될 수 있습니다.

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