Community코딩 & 개발github.com

스킬그램-리포트

스킬그램 버그 또는 누락된 스킬 갭을 실제 증거와 함께 보고합니다: 채널을 선택하고, JSON을 캡처하고, 이슈를 엽니다.

스킬그램-리포트란 무엇인가요?

이 스킬은 AI 에이전트 사용자가 `skillgram` 도구에서 발생한 버그나 특정 기능을 수행할 수 있는 스킬이 허브에 없는 갭을 체계적으로 보고할 수 있도록 설계되었습니다. 사용자는 CLI 명령어를 재현하여 종료 코드와 JSON 출력을 캡처하고, 환경 정보(OS, Python 버전, 스킬그램 버전, 하네스, 런처)를 수집합니다. 버그는 `bug_report.yml` 템플릿을 통해, 누락된 스킬 요청은 `skill_request.yml` 템플릿을 통해 제출되며, 모든 증거는 실제 실행된 명령어에서 비롯되어야 합니다. 이 스킬은 GitHub CLI를 사용해 이슈를 자동으로 게시하거나 사용자에게 텍스트를 제공합니다. Cursor, Claude Code, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 하네스 설정 파일을 수동으로 편집하여 문제를 우회하는 행위를 금지합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Xhuk/skillgram/tree/HEAD/skills/skillgram-report

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서


name: skillgram-report description: 스킬그램 버그 또는 누락된 스킬 갭을 실제 증거와 함께 보고합니다: 채널을 선택하고, JSON을 캡처하고, 이슈를 엽니다.

스킬그램-리포트은(는) 무엇을 하나요?

활성화 조건

다음 중 하나에 해당할 때 이 스킬을 사용하세요:

  • skillgram이 ok:false를 출력하고, 종료 코드 1/2로 종료되거나, 충돌하거나, 디스크와 모순되는 내용을 말한 경우 (등록됨인데 하네스 설정에 항목이 없음, 아무것도 가리키지 않는 링크, 매니페스트에는 스킬이 있는데 0개를 보고한 마운트).
  • 에이전트가 기능이 필요했는데 skillgram missing "<query>"이 found:false를 반환한 경우.
  • 설치 또는 등록이 문서화된 재시작 후에도 하네스에 적용되지 않은 경우.

다음 경우에는 해당하지 않음: "X를 어떻게 실행하나요" (INSTALL.md 참조) 또는 관찰된 갭이 없는 기능 아이디어.

엄격한 규칙

  1. 버그는 절대 스킬로 제출하지 않습니다. 잘못된 동작을 감추기 위해 propose를 실행하지 마십시오.
  2. 갭은 절대 버그로 제출하지 않습니다. 허브에 기능이 없는 것은 요청입니다.
  3. 조작된 증거는 없습니다: 모든 종료 코드, 경로 및 JSON 라인은 지금 실행한 명령어에서 나와야 합니다.
  4. 붙여넣기 전에 토큰, 비밀번호, 개인 호스트, 고객 이름은 가립니다. 형태는 유지하고 값만 변경합니다.
  5. 버그를 감추기 위해 하네스 설정 (config.toml, config.yaml, .claude.json, .cursor/mcp.json)을 수동으로 편집하여 skillgram을 "고치지" 마십시오.
  6. 성공을 주장하기 전에 설정을 다시 읽으십시오: <harness> mcp get skillgram (또는 mcp list) 및 skillgram status. 종료 코드는 증거가 아닙니다.

결정 게이트

관찰 사항채널
ok:false, 0이 아닌 종료 코드, 잘못된 링크, 출력의 거짓말, 충돌버그 → bug_report.yml
실제로 필요했던 기능에 대해 found:false스킬 요청 → skill_request.yml
누락된 것이 스킬이 아니라 skillgram 명령어, 플래그 또는 동작인 경우버그 (제목에 "기능"이라고 명시)
다른 머신이나 하네스에서 작동하는 경우증거로 기록, 수정 사항이 아님
불확실한 경우두 증거를 모두 수집하고 사용자가 채널을 선택하도록 함

실행 단계

  1. 정확한 명령줄을 유지하면서 한 번 재현합니다. CLI (skillgram <command> --json, 또는 설치되지 않은 경우 python <repo>/skillgram.py <command> --json)를 사용하고 종료 코드 ($LASTEXITCODE (PowerShell), $? (POSIX))를 기록합니다.
  2. 환경을 캡처합니다:
    • skillgram status --json
    • skillgram doctor --json (읽기 전용; 공개하고 싶지 않은 경로는 제거)
    • OS, Python 버전, skillgram 버전, 하네스, 사용한 런처 (PATH에 있는 것이 올바른 것이 아닌 경우 SKILLGRAM_MCP_CLI_<HARNESS>)
  3. 등록 주장의 경우, 성공을 주장한 명령어 후에 <harness> mcp get skillgram (또는 mcp list)를 캡처합니다.
  4. 갭의 경우, skillgram missing "<query>" --json 및 skillgram demand --limit 20 (아무도 답변할 수 없었던 쿼리를 순위 매기므로 이슈와 수요 로그가 일치함)을 캡처합니다.
  5. 템플릿에서 이슈를 작성하고 게시하기 전에 사용자에게 보여줍니다. gh issue create --repo Xhuk/skillgram --template bug_report.yml (또는 직접 양식을 작성하는 경우 --body-file <file>)로 게시하거나 텍스트를 전달합니다.

출력 계약

정확히 다음을 포함하여 회신합니다:

  • 채널: bug 또는 skill-request
  • 증거: 명령어, 종료 코드, 하나의 JSON 라인
  • 환경: OS / Python / skillgram / 하네스 / 런처
  • 기대한 동작: 한 문장, 추측 없음
  • 처리: 게시됨 (이슈 URL 포함) 또는 사용자에게 텍스트로 남김

관련 스킬