convez.ai
MCP ServerAutomaçãoAvançado
sunjin12

Ossmate — Copiloto de Mantenedor Open Source

sunjin12/ossmate

Automação completa de tarefas de mantenimento OSS com Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta baseada em Claude que automatiza tarefas repetitivas de mantenedores OSS: triagem de PRs, classificação de issues, geração de notas de release, auditoria de dependências e limpeza de issues obsoletas. Funciona como plugin Claude Code, servidor MCP ou CLI independente, servindo também como referência implementação de todas as superfícies de extensão do Claude.

Instalação

$npx convez-ai sunjin12/ossmate

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 7 meses
Versão
v0.1.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Triagem automática de pull requests e classificação de issues
  • Geração inteligente de notas de release e relatórios de changelog
  • Auditoria de dependências e detecção de issues obsoletas
  • Onboarding de contribuidores e gerenciamento de fila de issues

Veredito

Implementação robusta e completa que demonstra maestria em múltiplas superfícies Claude (Skills, Subagents, Hooks, MCP, Plugins, Agent SDK, Cron). Essencial para mantenedores solo de projetos grandes; oferece tanto valor prático quanto ser modelo educacional sólido para arquitetura de agentes Claude.

README

A tradução para o português deste README ainda está na fila.

Ossmate

🇰🇷 한국어 · 🇬🇧 English

CI PyPI Claude Code Plugin Python License: MIT

Claude 기반 오픈소스 메인테이너 보조 도구.

Ossmate는 OSS 메인테이너의 반복 업무 — PR 트리아지, 이슈 분류, 릴리스 노트 작성, 의존성 감사, stale 이슈 정리, 컨트리뷰터 온보딩 — 을 Claude Code 플러그인과 독립 CLI로 자동화합니다.

두 가지 목적으로 만들어졌습니다:

  1. 실용 도구 — 이슈 큐에 빠져 죽는 솔로 메인테이너를 위한 진짜 도구.
  2. 레퍼런스 구현체 — Claude Code의 모든 확장 표면(Skills, Subagents, Hooks, MCP, Plugins, Agent SDK, Cron, Status line, Output styles, Memory, Settings, Keybindings)을 하나의 일관된 제품으로 결합한 사례.

구축된 표면

표면위치상태
Skills (슬래시 명령).claude/commands/[x] Phase 5 (8/8)
Subagents.claude/agents/[x] Phase 5 (6개 — haiku/sonnet/opus 매칭)
Hooks.claude/hooks/[x] Phase 3 (5개 이벤트, 21개 테스트)
MCP 서버mcp/ossmate_mcp/[x] Phase 4 (11개 도구, 3개 템플릿)
플러그인 패키징.claude-plugin/[x] Phase 6 (manifest + 자체 마켓플레이스)
Claude Agent SDK CLIcli/ossmate/[x] Phase 7 (Typer + 8개 서브커맨드, dry-run 모드)
Status line.claude/statusline.sh[x] Phase 1
Output styles.claude/output-styles/[x] Phase 1
Scheduled triggersscheduled/[x] Phase 8 (3개 cron 잡, off-minute 분산)
Memory templates.claude/CLAUDE.md[x] Phase 0
Settings & permissions.claude/settings.json[x] Phase 0
Keybindings.claude/keybindings.json.example[x] Phase 1
CI / Release.github/workflows/[x] Phase 9 (3-OS × 3-Python 매트릭스, OIDC PyPI 발행)

빠른 시작

세 가지 사용 방법이 있습니다. 본인 환경에 맞는 것을 고르세요.

A. Claude Code 플러그인 (권장)

claude plugin marketplace add https://raw.githubusercontent.com/sunjin12/ossmate/main/.claude-plugin/marketplace.json
claude plugin install ossmate@ossmate

설치 후 어느 repo에서나:

/triage-pr 1234
/release-notes v1.4.0
/stale-sweep --days 60

플러그인은 자체 네임스페이스를 가지므로 /ossmate:triage-pr 1234 형식도 작동합니다 — 다른 플러그인과 명령 이름이 충돌할 때 네임스페이스 형식을 쓰세요.

B. 독립 CLI

pipx install ossmate
ossmate triage-pr 1234
ossmate release-notes v1.4.0
ossmate triage-pr 1234 --dry-run    # 렌더링된 prompt + ClaudeAgentOptions 출력

CLI는 플러그인이 사용하는 동일한 .claude/commands/*.md 스킬 본문을 로드합니다 — 스킬을 한 번 작성하면 슬래시 명령과 CLI 서브커맨드가 자동으로 함께 생깁니다.

설치 후 첫 명령이 실패한다면 ossmate doctor로 환경(Python, gh CLI 인증, MCP 서버, .claude/·.ossmate/ 디렉터리)을 먼저 진단하세요. --json 플래그로 CI에서도 사용 가능합니다.

C. 소스에서 (개발용)

git clone https://github.com/sunjin12/ossmate.git
cd ossmate
bash scripts/dev_link.sh        # mcp + cli editable 설치, --check 자동 실행
# Windows:
# powershell -ExecutionPolicy Bypass -File scripts/dev_link.ps1
pytest -q                       # 161개 hermetic 테스트, ~5초

아키텍처

flowchart LR
    User([Maintainer])
    User -->|slash commands| CC[Claude Code]
    User -->|terminal / CI| CLI[ossmate CLI]
    CC --> Skills[Skills]
    CC --> Hooks[Hooks]
    Skills --> Subagents
    Subagents --> MCP[ossmate MCP server]
    CLI --> SDK[Claude Agent SDK]
    SDK --> MCP
    MCP --> GH[(GitHub API)]
    MCP --> Repo[(Local repo)]
    MCP --> Adv[(OSV advisories)]

같은 MCP 서버가 플러그인과 독립 CLI 양쪽을 모두 지원합니다 — 도구를 한 번 작성하면 어디서나 사용 가능.


왜 모든 표면을 사용했나?

12개 하네스 확장 각각이 OSS 메인테이너 도메인의 특정 마찰을 제거합니다. 단순 데모 매핑이 아닙니다 — 아래 표는 각 표면이 없을 때 어떤 마찰이 생기는지로 정당화합니다.

표면없으면 발생할 마찰
Skills (슬래시 명령)반복 워크플로(triage / release notes / stale sweep)를 매번 프롬프트 처음부터 작성
Subagents모든 업무를 단일 모델로 — bulk 분류에 Opus, 보안 감사에 Haiku 같은 모델 미스매치 비용
Hooksgit push origin main 실수 1건이 수 시간 복구 비용. 인간 의지력에만 의존
MCP 서버slash / CLI / 다른 AI 클라이언트가 gh · OSV · lockfile 파싱을 각자 재구현
플러그인 패키징온보딩이 pip install + .claude/ 복사 + settings 편집 다단계
Agent SDK CLICI · 원격 shell · non-Claude-Code 환경에서 동일 워크플로 재구성 필요
Status line현재 저장소의 PR 수 · stale 수가 매번 브라우저 탭으로만 확인
Output stylesCHANGELOG의 Keep-a-Changelog 포맷 · 리뷰 tone을 매번 수동 교정
Scheduled triggers의지력에 의존한 일간 체크 — 며칠 skip되면 악순환
Memory templatespersona · 브랜치 보호 정책 · 커밋 컨벤션을 매 세션 다시 설명
Settings & permissionsdestructive gh 차단을 매번 훅으로만 방어 — 허용목록 baseline 없음
Keybindings파워유저 전용 gesture 부재 (옵션 — 가장 낮은 가치)

각 표면의 빌드 순서와 동기는 이 저장소의 PR 이력과 phase-0 ~ phase-9 태그를 참조하세요.


Self-dogfooding

이 저장소의 CHANGELOG는 Ossmate 자신이 생성하고, 스케줄된 트리거가 매일 이 repo에 다이제스트를 돌리며, PreToolUse 훅이 실수로 main에 force-push 하는 것을 막습니다. CHANGELOG.md를 참조하세요.


릴리스 방법

두 PyPI 프로젝트(ossmate-mcp, ossmate)는 함께 출시됩니다 — 버전 올리고, 태그 달고, push만 하면 GitHub Actions가 나머지를 처리합니다:

python scripts/bump_version.py 0.2.0   # 두 pyproject + plugin.json + marketplace.json 동시 갱신
python scripts/bump_version.py --check # invariant: 5곳 모두 일치 확인
git commit -am "chore(release): v0.2.0"
git tag v0.2.0 && git push --tags      # PreToolUse 훅이 명시적 승인 없이는 차단

릴리스 워크플로우는 태그 버전과 pyproject.toml 버전이 다르면 발행을 거부합니다. PyPI 업로드는 OIDC 신뢰 발행 방식 — 저장소 시크릿에 API 토큰이 없습니다.


개발 현황

단계별로 빌드되었습니다 — 계획은 docs/project_phases.md에 있습니다. 각 단계는 태그(phase-0, phase-1, …)로 마킹되어 있어 프로젝트의 진화 과정을 따라가볼 수 있습니다.

v0.1.0 (2026-04-19) — 첫 공개 릴리스. 모든 12개 표면 작동, PyPI 발행 완료.


About / 프로젝트 회고

이 프로젝트가 어떤 문제를 해결하려 했는지, 어떻게 구현했는지, 구현 과정에서 내린 결정, 자체 평가를 정리한 회고는 docs/portfolio.md에 있습니다.

이 프로젝트는 클로드 코드의 도움을 받아 작성되었습니다.

라이선스

MIT — LICENSE 참조.

Ver o original no GitHub

Bom para

Relacionados