Vibe Docs

한국어나 영어로 작성되는 결과물의 의미를 분명하게 유지한다. 이 파일에는 상황과 상관없이 지키는 절대 규칙과 상황별로 읽을 참고 파일만 둔다. 문장을 쓰는 세부 규칙은 참고 파일에 있다.

적용 범위

• 스킬 파일과 스킬을 다루는 문서
• 새로 쓰거나 고치는 코드 주석
• 커밋 메시지
• 이슈 제목, 본문, 댓글
• PR 제목, 본문, 리뷰, 댓글

저장소가 정한 구조 규칙은 그대로 지킨다. 템플릿, 제목 형식, 커밋 접두사, 주석 기호, @param과 TODO 같은 주석 태그가 그 예다. 다만 문장은 아래 상황별 참고 파일에서 고른 언어별 참고 파일을 따른다.

Javadoc, KDoc처럼 문서화 주석을 다루는 다른 스킬을 함께 쓸 때 두 스킬의 규칙이 충돌하면 그 스킬의 규칙을 따른다.

결과물을 어느 언어로 쓸지는 사용자의 요청, 호출한 스킬, 저장소의 관례가 정한다. 이 스킬은 결과물의 언어를 바꾸지 않는다.

이 스킬은 글의 작성과 검토만 맡는다. 커밋 생성, 이슈나 PR 게시, 댓글 전송과 같은 변경 권한을 새로 주지 않는다. 실제 변경 여부는 호출한 스킬과 사용자의 요청이 정한다.