oh-my-gh-writing은(는) 무엇을 하나요?
AI 에이전트를 위한 GitHub 글쓰기 스킬. 요청을 라우팅하고, 일치하는 표준을 로드하며, 증거 경계를 명확히 유지하고, 제출 직전 수준의 GitHub 초안을 생성합니다.
트리거 경계
이 스킬은 GitHub 관련 글쓰기 아티팩트 및 로컬 GitHub 글쓰기 초안 패키지에 사용하십시오. 일반적인 카피라이팅, UI 텍스트, 코드 구현, 제품 전략, 또는 광범위한 문서 작업에는 사용하지 마십시오. 단, 요청된 출력이 GitHub 아티팩트 또는 GitHub 저장소 파일인 경우는 예외입니다.
워크플로우
- 사용자가 단일 아티팩트를 원하는지, 아니면 다중 아티팩트 워크플로우 팩을 원하는지 식별합니다.
- 사용자가 단일 아티팩트를 명시적으로 명명하면, 주제가 광범위하더라도 해당 아티팩트로 라우팅합니다.
- 사용자가 광범위한 워크플로우, 론칭, 설정, 릴리스 패키지, 또는 종단 간 자료 세트를 요청하면, 일치하는 복합 워크플로우 팩으로 라우팅합니다.
- 사용자가 검사, 확인, 준비 상태 검토, 또는 필요한 파일 추천을 요청하면 감사 전용으로 처리합니다: 갭 분석 및 다음 파일 추천만 출력합니다. 대상 파일을 생성하지 말고,
.github-writing/디렉토리를 생성하지 말며, 사용자가 명시적으로 초안 작성, 생성, 쓰기, 적용, 업데이트를 요청하지 않는 한.github/또는 루트 저장소 파일을 작성하지 마십시오. - README 요청의 경우
references/readme.md의 세 가지 질문 프롬프트를 사용합니다. - 복합 워크플로우 팩의 경우 팩의 결정 규칙을 따릅니다. 패키지 선택 질문은 패키지 형태를 안전하게 추론할 수 없는 경우에만 묻고, 그렇지 않으면 권장 기본값을 사용하여
package-manifest.md에 기록합니다. - 사용자 대상 출력을 작성하기 전에 일치하는
references/*.md를 명시적으로 열고 읽습니다. 메모리에서 참조 내용을 추론하거나 추측하지 마십시오. - 복합 팩에 의해 선택된 단일 아티팩트 참조만 읽습니다. 모든 참조를 미리 로드하지 마십시오.
- 배지, 알림, Mermaid, 접이식 블록, 이모지 또는 복잡한 테이블이 필요한 경우
references/weapons.md를 읽습니다. - 사용자가 상세한 배지 디자인 또는 정확한 shields.io URL 패턴을 요청하는 경우에만
references/badge-catalog.md를 읽습니다. - 이모지가 요청되거나 대상 저장소가 이미 이모지를 사용하는 경우
references/emoji-guide.md를 읽습니다. - 요청이 사실 위주, 고위험, 교차 시나리오이거나 출력 품질 규칙을 명확히 해야 할 때
references/shared-principles.md를 읽습니다. - 최종 확정 전에
references/output-validation.md를 자동 수정 체크리스트로 사용합니다. 초안이 검사를 통과하지 못하면 전달하기 전에 수정합니다. 검증은 작고 깔끔한 아티팩트의 경우 조용히 유지하고, 아티팩트가 복잡하거나, 고위험 또는 명백한 차단 요소가 있는 경우에만 짧은 사후 출력 제출 노트를 추가합니다.
로컬 파일 읽기가 불가능한 경우, 사용자에게 관련 references/*.md 내용을 제공하거나 참조를 사용할 수 없다고 말하고 보이는 라우팅 규칙과 공유 원칙에서만 보수적인 초안을 생성합니다. 접근할 수 없는 파일을 읽은 척 하지 마십시오.
점진적 공개: 현재 작업에 필요한 파일만 로드합니다. 여러 참조가 실제로 필요하고 플랫폼이 일괄 읽기를 지원하는 경우, 직렬 도구 호출 대신 한 번에 읽습니다.
언어 충실도: 사용자가 요청한 언어 또는 대상 저장소의 기본 언어와 일치시킵니다. 이 스킬의 지침 언어는 최종 GitHub 아티팩트로 누출되어서는 안 됩니다.
시나리오 라우팅
18개 단일 아티팩트 표준 및 7개 복합 워크플로우 팩의 전체 목록은 INDEX.md를 참조하십시오.
다음 최상위 라우팅 규칙을 사용하십시오:
| 신호 | 라우팅 대상 |
|---|---|
| 사용자가 "릴리스 노트 작성" 또는 "PR 템플릿 생성"과 같은 명시적 아티팩트 하나를 요청 | 일치하는 단일 아티팩트 참조 |
| 사용자가 릴리스 패키지, 버전 업데이트 자료, 주요 릴리스 준비 또는 소프트웨어 업데이트 번들을 요청 | references/version-release.md |
| 사용자가 저장소를 처음으로 게시하거나 오픈소스로 공개하려 함 | references/project-launch.md |
| 사용자가 외부 기여자를 위해 프로젝트를 준비하려 함 | references/contribution-setup.md |
| 사용자가 보고 또는 분류부터 수정 PR을 통해 버그를 처리하려 함 | references/bug-fix-workflow.md |
| 사용자가 아이디어를 논의, 설계, 이슈 및 구현 자료로 전환하려 함 | references/proposal-to-implementation.md |
| 사용자가 호환성을 깨는 변경 커뮤니케이션 패키지를 원함 | references/breaking-change-package.md |
| 사용자가 광범위한 문서 새로고침 또는 문서 개편을 원함 | references/docs-overhaul.md |
프롬프트가 이슈, PR 및 논의 언어를 혼합하는 경우:
| 신호 | 라우팅 대상 |
|---|---|
| 구현된 diff 없이 미래 기능 요청 | 기능 요청 |
| 기존 동작 개선 | 개선 |
| 해결되지 않은 솔루션이 있는 커뮤니티 의견 | 논의 |
| 새 기능을 구현하는 브랜치, diff 또는 PR | 기능 PR |
| 버그 또는 회귀를 수정하는 브랜치, diff 또는 PR | 버그 수정 PR |
| 동작 변경 없이 코드를 재구성하는 변경 | 리팩터 PR |
| 문서만 변경됨 | 문서 PR |
| 사용자가 코드, PR 또는 diff 검토를 요청 | 코드 검토 |
사용자가 PR, 사후 분석 또는 논의를 다른 아티팩트로 전환하도록 요청하면, 원본 자료가 아닌 요청된 아티팩트로 라우팅합니다.
복합 워크플로우 기본값
복합 워크플로우 팩은 템플릿이 아닌 조정자입니다. 로드할 기존 단일 아티팩트 표준을 선택합니다.
- 감사 전용 프롬프트는 패키지 파일이 아닌 권장 사항을 생성합니다.
- 패키지 선택 질문은 팩의 결정 규칙이 기본값을 안전하게 선택할 수 없는 경우에만 한 번 묻습니다.
- 묻지 않고 기본값을 선택한 경우, 선택한 옵션과 가정을
package-manifest.md에 기록합니다. - 선택적 보충 자료는 동일한 메시지에 포함합니다.
- 기본 출력 위치는
.github-writing/<pack-name>/<version-or-date>/아래의 로컬 초안 파일입니다. - 버전이나 날짜를 알 수 없는 경우
.github-writing/<pack-name>/TBD/를 사용합니다. - 모든 복합 패키지에
package-manifest.md를 포함하여 생성된 파일, 가정,TODO/TBD필드, 작성해도 안전한 파일, 유지관리자 확인이 필요한 파일을 나열합니다. - 파일 쓰기가 불가능한 경우,
## 파일: ...제목과 펜스 블록을 사용하여 패키지를 다중 파일 채팅 출력으로 표시합니다. 파일을 작성했다고 주장하지 마십시오. - 사용자가 명시적으로 요청하지 않는 한, 게시, GitHub 릴리스 생성, 태그 푸시, PR 열기 또는 원격 상태 수정을 하지 마십시오.
참조 인덱스
전체 탐색을 위해 INDEX.md를 로드하십시오. 일반적인 참조 그룹:
| 그룹 | 참조 |
|---|---|
| 이슈 | bug-report.md, feature-request.md, enhancement.md, discussion.md |
| 풀 리퀘스트 | feature-pr.md, bug-fix-pr.md, refactor-pr.md, documentation-pr.md |
| 검토 및 커밋 | code-review.md, standard-commit.md |
| 문서 | readme.md, contributing.md, changelog.md |
| 릴리스 및 설계 | release-notes.md, migration-guide.md, rfc.md |
| 템플릿 | issue-form-yaml.md, pr-template.md |
| 복합 팩 | version-release.md, project-launch.md, contribution-setup.md, bug-fix-workflow.md, proposal-to-implementation.md, breaking-change-package.md, docs-overhaul.md |
| 부록 | shared-principles.md, weapons.md, badge-catalog.md, emoji-guide.md, output-validation.md, source-catalog.md |
누락된 정보
필요한 선택(예: 대상 패키지 이름, 릴리스 버전, 호환성 중단 의도, 출력 패키지 형태, 아티팩트 구조를 변경하는 범위 선택)을 안전하게 추론할 수 없는 경우에만 짧은 후속 질문을 합니다. 그렇지 않으면 TBD 또는 TODO를 사용하고, 가정을 간략히 명시하며, 증거가 없을 때 선택적 섹션을 제거합니다.
저장소 유지 관리
SKILL.md를 경량 런타임 라우터로 유지합니다.- 시나리오별 및 복합 팩 규칙은 일치하는
references/*.md에 둡니다. INDEX.md는 탐색 전용으로 유지합니다.- 런타임 지침은 기본적으로 영어로 유지합니다.
- README 실수가 발견되면
references/readme.md의 README 관련 교훈을 업데이트합니다. - 로컬 연구 및 검증 출력은 추적된 런타임 콘텐츠 외부에 유지합니다.