| name | workspace-surface-audit |
| description | 활성 저장소, MCP 서버, 플러그인, 커넥터, 환경 표면, 하니스 구성을 감사하고, 가장 가치가 큰 ECC 네이티브 스킬, 훅, 에이전트, 운영 워크플로를 권고합니다. Claude Code 설정을 도와주거나 현재 환경에서 실제로 어떤 기능이 가능한지 파악할 때 사용합니다. |
| origin | ECC |
Workspace Surface Audit
"이 워크스페이스와 머신은 지금 실제로 무엇을 할 수 있고, 다음에 무엇을 추가하거나 켜야 하는가?"라는 질문에 답하기 위한 읽기 전용 감사 스킬입니다.
이것은 setup-audit 플러그인의 ECC 네이티브 답변입니다. 사용자가 후속 구현을 명시적으로 요청하지 않는 한 파일을 수정하지 않습니다.
사용 시점
- 사용자가 "Claude Code 설정해줘", "자동화 추천해줘", "어떤 plugin이나 MCP를 써야 해?", "뭐가 부족하지?"라고 할 때
- 더 많은 스킬, 훅, 커넥터를 설치하기 전 머신이나 저장소를 감사할 때
- 공식 마켓플레이스 플러그인과 ECC 네이티브 커버리지를 비교할 때
.env, .mcp.json, plugin 설정, connected-app 표면을 검토해 빠진 워크플로 레이어를 찾을 때- 어떤 기능을 skill, hook, agent, MCP, 외부 connector 중 어디에 둘지 결정할 때
비타협 규칙
- 비밀 값은 절대 출력하지 않습니다. 제공자 이름, 기능 이름, 파일 경로, 키/설정 존재 여부만 드러냅니다
- ECC가 충분히 소유할 수 있는 표면이면 일반적인 "다른 플러그인 설치"보다 ECC 네이티브 워크플로를 우선합니다
- 외부 플러그인은 기준점과 영감으로 취급하며 권위 있는 제품 경계로 보지 않습니다
- 다음 세 가지를 명확히 분리합니다
- 지금 이미 사용 가능함
- 사용 가능하지만 ECC에 잘 감싸져 있지 않음
- 아직 사용 불가하며 새 통합이 필요함
감사 입력
질문에 잘 답하는 데 필요한 파일과 설정만 점검합니다.
- Repo surface
package.json, lockfile, 언어 마커, 프레임워크 설정, README.md.mcp.json, .lsp.json, .claude/settings*.json, .codex/*AGENTS.md, CLAUDE.md, 설치 매니페스트, hook 설정
- Environment surface
- 활성 저장소와 인접 ECC 워크스페이스의
.env*
STRIPE_API_KEY, TWILIO_AUTH_TOKEN, FAL_KEY 같은 키 이름만 표면화
- Connected tool surface
- 설치된 플러그인, 활성 커넥터, MCP 서버, LSP, 앱 연동
- ECC surface
- 기존 skill, command, hook, agent, 설치 모듈
감사 절차
1단계: 현재 존재하는 것 인벤토리
다음을 간결하게 정리합니다.
- 활성 하니스 타깃
- 설치된 플러그인과 연결 앱
- 설정된 MCP 서버
- 설정된 LSP 서버
- 키 이름으로 암시되는 env 기반 서비스
- 현재 워크스페이스와 관련 있는 기존 ECC 스킬
어떤 표면이 primitive로만 존재하면 그 점을 명시합니다.
2단계: 공식/설치 표면과 비교
다음과 비교합니다.
- 설정, 리뷰, 문서, 디자인, 워크플로 품질과 겹치는 공식 Claude 플러그인
- 로컬에 설치된 Claude 또는 Codex 플러그인
- 사용자가 현재 연결한 앱 표면
각 비교에 대해 다음을 답합니다.
- 실제로 무엇을 하는가
- ECC가 이미 동등 이상인지
- ECC에 primitive만 있는지
- ECC가 워크플로를 통째로 놓치고 있는지
3단계: 격차를 ECC 결정으로 변환
실제 격차마다 올바른 ECC 네이티브 형태를 권고합니다.
| Gap Type | Preferred ECC Shape |
|---|
| 반복 가능한 운영 워크플로 | Skill |
| 자동 강제 또는 부수효과 | Hook |
| 전문 위임 역할 | Agent |
| 외부 도구 연결 | MCP server or connector |
| 설치/부트스트랩 가이드 | Setup or audit skill |
문제가 인프라보다는 운영이면, 기존 도구를 오케스트레이션하는 사용자 대면 스킬을 기본값으로 둡니다.
출력 형식
다음 5개 섹션 순서로 반환합니다.
- Current surface
- Parity
- Primitive-only gaps
- Missing integrations
- Top 3-5 next moves
권고 규칙
- 카테고리당 최대 1~2개의 최고 가치 아이디어만 권고합니다
- 사용자 의도와 비즈니스 가치가 분명한 스킬을 우선합니다
- setup audit
- billing/customer ops
- issue/program ops
- Google Workspace ops
- deployment/ops control
- 회사 특화 connector는 실제로 사용 가능하거나 워크플로에 명확히 유용할 때만 권고합니다
- ECC에 강한 primitive가 이미 있으면 새 서브시스템 대신 wrapper skill을 제안합니다
좋은 결과
- 사용자가 지금 연결된 것, 빠진 것, ECC가 다음에 소유해야 할 것을 즉시 파악할 수 있다
- 권고가 추가 조사 없이 저장소에 바로 구현 가능한 수준으로 구체적이다
- 최종 답변이 API 브랜드가 아니라 워크플로 중심으로 정리된다
