michael-denyer/pstack-claude

pstack‑claude – 멀티 런타임 에이전트 스킬 플러그인

개요

• pstack 플러그인(원래 Cursor의 Claude Code용으로 작성됨)의 포트로, 54개의 재사용 가능한 Agent Skills를 번들로 제공합니다.
• 스킬은 Claude Code용으로 작성되었지만 공유 ~/.agents/skills/ 디렉토리를 통해 Codex, Prime Agent, opencode, Gemini‑CLI 런타임에서도 사용할 수 있습니다.
• 저장소에는 플러그인 매니페스트, 전체 스킬 트리, Codex용 생성된 명령 스텁, 스킬 세트를 업스트림 Cursor 버전과 동기화하는 도구가 포함되어 있습니다.

중요성

• 세션 시작 시 짧은 지시를 주입하는 즉시 사용 가능한 "poteto‑mode" 워크플로우를 제공하고, 그 후 고급 엔지니어링 헬퍼(TDD, 코드 리뷰, PR 자동화, CI 수정 등)를 제공합니다.
• 동일한 스킬 정의를 여러 AI 코딩 에이전트에 노출함으로써 사용자는 프롬프트를 다시 작성하지 않고도 Claude Code, Codex, Prime Agent, opencode 또는 Gemini‑CLI를 전환할 수 있습니다.
• 모든 코드는 MIT 라이선스이며 원래 Cursor 플러그인에서 적용한 변경 사항에 대한 철저한 감사(CHANGES.md, NOTICE.md)가 포함되어 있습니다.

설치

• Claude Code – 마켓플레이스 항목을 추가하고 플러그인을 설치합니다:

  /plugin marketplace add michael-denyer/pstack-claude
  /plugin install pstack@pstack-claude
  

  플러그인은 세션 시작 시 자동으로 실행됩니다(poteto‑mode 지시 주입). 후크는 hooks/hooks.json을 제거하여 비활성화할 수 있습니다.
• 공유 스킬 설치 – 저장소를 클론하고 각 스킬을 ~/.agents/skills/에 심볼릭 링크합니다:

  git clone https://github.com/michael-denyer/pstack-claude
  cd pstack-claude
  mkdir -p ~/.agents/skills
  for s in plugins/pstack/skills/*/; do ln -s "$PWD/$s" ~/.agents/skills/$(basename "$s"); done
  

  이 단일 트리는 Codex, Prime Agent, opencode 및 Gemini‑CLI에서 검색됩니다.
• Codex 전용 – 공유 설치 후 생성된 슬래시 명령 스텁을 ~/.codex/prompts/에 링크하고 ~/.codex/config.toml에서 멀티 에이전트 지원을 활성화합니다.
• Gemini‑CLI / opencode / Prime Agent – 동일한 심볼릭 링크된 스킬 디렉토리가 작동합니다. 런타임의 스킬 캐시를 다시 로드하기만 하면 됩니다.

주요 기능(선택된 스킬)

스킬	목적
poteto-mode	첫 번째 모델 응답 전에 중요하지 않은 엔지니어링 요청을 구조화된 워크플로우로 라우팅하는 짧은 "지시"를 설정합니다.
tdd	테스트 주도 개발 헬퍼. 테스트를 스캐폴드하고 실행하며 수정 사항을 제안합니다.
fix-ci	CI 실패를 분석하고 패치를 제안합니다.
fix-merge-conflicts	병합 충돌을 자동으로 감지하고 해결합니다.
make-pr-easy-to-review	간결한 PR 요약 및 체크리스트를 생성합니다.
get-pr-comments	기존 PR 토론을 세션으로 가져와 컨텍스트를 제공합니다.
what-did-i-get-done	최근 작업을 요약하여 빠른 상태 업데이트를 제공합니다.
deslop	코드 스타일 린트 및 정리를 수행합니다.
thermo-nuclear-code-quality-review	숨겨진 버그를 표면화하는 심층 정적 분석 패스.

런타임별 참고 사항

• Claude Code – 플러그인에는 poteto‑mode 지시를 자동으로 실행하는 SessionStart 후크가 포함되어 있습니다. 후크는 plugins/pstack/hooks/에 있으며 수동 활성화를 선호하는 경우 제거할 수 있습니다.
• Codex – 후크 시스템이 없으므로 pstack:poteto-mode를 명시적으로 호출하거나 ~/.codex/AGENTS.md에 영구 지시를 추가해야 합니다. 슬래시 명령 단축키(/tdd, /fix-ci, …)는 생성된 Markdown 프롬프트를 통해 제공됩니다.
• Prime Agent – 동일한 디렉토리에서 스킬을 검색합니다. user-invocable: false 플래그를 무시하므로 내부 "principle‑*" 리프는 UI에 숨겨져 있지만 poteto-mode에서 읽을 수 있습니다.
• opencode – 54개의 스킬을 모두 공개로 취급합니다. principle‑* 리프는 피커에 나타나지만 무해합니다.
• Gemini‑CLI – ~/.gemini/skills/(또는 호환 별칭)을 통해 스킬을 로드합니다. activate_skill 도구를 사용하여 poteto-mode 또는 다른 스킬을 실행합니다.

개발 및 CI

• CI 파이프라인(ci.yml, security.yml)은 생성된 파일을 재생성하고, 코드를 린트하고(Bun, shell, Markdown), 스킬 충돌 테스트를 실행하고, osv‑scanner 및 zizmor로 종속성을 스캔합니다.
• 저장소에는 스킬 트리를 업스트림 Cursor 버전(e8d856f)과 동기화하는 헬퍼 스크립트(tools/generate.mjs, tools/validate-skills.mjs, tools/sync.mjs)가 포함되어 있습니다.
• VERSION 파일은 플러그인 버전의 단일 소스입니다. 매니페스트는 생성 중에 여기에서 스탬프됩니다.

종속성

• plugin.json에는 런타임 수준 종속성이 선언되어 있지 않습니다. 유일한 선택적 동반 플러그인은 plugin‑dev(공식 Claude‑plugins 마켓플레이스에서)로, 스킬 작성 워크플로우를 개선합니다.
• 일부 플레이북에 필요한 시스템 수준 도구: gh(GitHub CLI), bun(번들 스크립트용), jq 및 rg(감사 스크립트용). 해당 플레이북을 실행하지 않는 한 선택 사항입니다.

라이선스

• 핵심 플러그인과 번들된 모든 스킬은 MIT 라이선스로 릴리스됩니다(LICENSE 및 LICENSE‑cursor‑team‑kit 참조). 귀속 세부 사항은 NOTICE.md에 있습니다.

결론 pstack‑claude는 잘 문서화되고 CI 테스트된 멀티 런타임 플러그인으로, Claude Code 및 호환 에이전트에 풍부한 엔지니어링 자동화 스킬을 제공합니다. 지원되는 AI 코딩 어시스턴트 중 하나를 사용하는 경우 이 저장소를 설치하면 코드 품질, PR 처리, CI 디버깅 등을 위한 즉시 사용 가능한 도구 상자를 얻을 수 있으며, 기본 프롬프트를 직접 작성할 필요가 없습니다.