name: skillgram-report description: 스킬그램 버그 또는 누락된 스킬 갭을 실제 증거와 함께 보고합니다: 채널을 선택하고, JSON을 캡처하고, 이슈를 엽니다.
스킬그램-리포트은(는) 무엇을 하나요?
활성화 조건
다음 중 하나에 해당할 때 이 스킬을 사용하세요:
skillgram이ok:false를 출력하고, 종료 코드1/2로 종료되거나, 충돌하거나, 디스크와 모순되는 내용을 말한 경우 (등록됨인데 하네스 설정에 항목이 없음, 아무것도 가리키지 않는 링크, 매니페스트에는 스킬이 있는데 0개를 보고한 마운트).- 에이전트가 기능이 필요했는데
skillgram missing "<query>"이found:false를 반환한 경우. - 설치 또는 등록이 문서화된 재시작 후에도 하네스에 적용되지 않은 경우.
다음 경우에는 해당하지 않음: "X를 어떻게 실행하나요" (INSTALL.md 참조) 또는 관찰된 갭이 없는 기능 아이디어.
엄격한 규칙
- 버그는 절대 스킬로 제출하지 않습니다. 잘못된 동작을 감추기 위해
propose를 실행하지 마십시오. - 갭은 절대 버그로 제출하지 않습니다. 허브에 기능이 없는 것은 요청입니다.
- 조작된 증거는 없습니다: 모든 종료 코드, 경로 및 JSON 라인은 지금 실행한 명령어에서 나와야 합니다.
- 붙여넣기 전에 토큰, 비밀번호, 개인 호스트, 고객 이름은 가립니다. 형태는 유지하고 값만 변경합니다.
- 버그를 감추기 위해 하네스 설정 (
config.toml,config.yaml,.claude.json,.cursor/mcp.json)을 수동으로 편집하여 skillgram을 "고치지" 마십시오. - 성공을 주장하기 전에 설정을 다시 읽으십시오:
<harness> mcp get skillgram(또는mcp list) 및skillgram status. 종료 코드는 증거가 아닙니다.
결정 게이트
| 관찰 사항 | 채널 |
|---|---|
ok:false, 0이 아닌 종료 코드, 잘못된 링크, 출력의 거짓말, 충돌 | 버그 → bug_report.yml |
실제로 필요했던 기능에 대해 found:false | 스킬 요청 → skill_request.yml |
| 누락된 것이 스킬이 아니라 skillgram 명령어, 플래그 또는 동작인 경우 | 버그 (제목에 "기능"이라고 명시) |
| 다른 머신이나 하네스에서 작동하는 경우 | 증거로 기록, 수정 사항이 아님 |
| 불확실한 경우 | 두 증거를 모두 수집하고 사용자가 채널을 선택하도록 함 |
실행 단계
- 정확한 명령줄을 유지하면서 한 번 재현합니다. CLI (
skillgram <command> --json, 또는 설치되지 않은 경우python <repo>/skillgram.py <command> --json)를 사용하고 종료 코드 ($LASTEXITCODE(PowerShell),$?(POSIX))를 기록합니다. - 환경을 캡처합니다:
skillgram status --jsonskillgram doctor --json(읽기 전용; 공개하고 싶지 않은 경로는 제거)- OS, Python 버전,
skillgram버전, 하네스, 사용한 런처 (PATH에 있는 것이 올바른 것이 아닌 경우SKILLGRAM_MCP_CLI_<HARNESS>)
- 등록 주장의 경우, 성공을 주장한 명령어 후에
<harness> mcp get skillgram(또는mcp list)를 캡처합니다. - 갭의 경우,
skillgram missing "<query>" --json및skillgram demand --limit 20(아무도 답변할 수 없었던 쿼리를 순위 매기므로 이슈와 수요 로그가 일치함)을 캡처합니다. - 템플릿에서 이슈를 작성하고 게시하기 전에 사용자에게 보여줍니다.
gh issue create --repo Xhuk/skillgram --template bug_report.yml(또는 직접 양식을 작성하는 경우--body-file <file>)로 게시하거나 텍스트를 전달합니다.
출력 계약
정확히 다음을 포함하여 회신합니다:
- 채널:
bug또는skill-request - 증거: 명령어, 종료 코드, 하나의 JSON 라인
- 환경: OS / Python / skillgram / 하네스 / 런처
- 기대한 동작: 한 문장, 추측 없음
- 처리: 게시됨 (이슈 URL 포함) 또는 사용자에게 텍스트로 남김