Capabilities

한눈에 보기

Capabilities는 KeystoneHub가 실제로 어떤 작업 표면을 제공하는지 보여주는 문서입니다. 중요한 것은 설치된 도구 목록이 아니라, 어떤 상황에서 skill, MCP, plugin, command, hook 중 무엇을 선택하는지입니다.

• 핵심 질문: 작업 유형에 따라 어떤 실행 표면을 선택해야 하는가?
• 읽는 대상: KeystoneHub가 할 수 있는 일과 도구 선택 기준을 빠르게 파악하려는 사람
• 연결 문서: Commands & Guardrails, Cross-Tool Sync, Evidence Dashboard

이 문서에서 확인할 것

• skill, MCP, plugin, command, hook의 역할 차이
• 반복 작업, 외부 데이터, UI 확인, 위험 차단 상황별 선택 기준
• ai-rules 정책이 keystone-hub 실행 표면으로 연결되는 방식

작업 표면의 역할

Capabilities는 Keystone이 실제로 무엇을 할 수 있는지 보여주는 메뉴입니다. 여기서 중요한 것은 설치 목록이 아니라, 어떤 작업에 어떤 표면을 선택하는지입니다.

flowchart TD
  A["User Request"] --> B{"작업 유형"}
  B -->|반복 워크플로우| C["Skills"]
  B -->|외부 능력 연결| D["MCP"]
  B -->|문서/브라우저/파일 표면| E["Plugins"]
  C --> F["Command / Agent execution"]
  D --> F
  E --> F
  F --> G["Evidence"]

표면별 책임

표면	역할	예시
Skills	특정 작업 유형의 로컬 지침	planning, code-review, frontend QA, sync-debugger
MCP	외부 능력과 데이터 접근	memory search, browser QA, GitHub, docs lookup
Plugins	문서/브라우저/스프레드시트/발표자료 작업 표면	Browser, Documents, Presentations, Spreadsheets
Commands	사용자가 호출하는 반복 작업 입구	/planning, /commit, /self-improve
Hooks	행동을 검증하거나 차단하는 장치	safety, evidence, quality, session hooks

선택 기준

상황	우선 표면
작업 방식이 반복된다	Skill로 고정
과거 결정이나 fact가 필요하다	Memory MCP 검색
UI 렌더링 확인이 필요하다	Browser QA
문서 산출물이 필요하다	Documents 또는 Markdown docs
위험한 작업을 막아야 한다	Hook 또는 eval
도구 설정 drift를 잡아야 한다	Doctor

ai-rules와 keystone-hub 연결

flowchart LR
  A["ai-rules<br/>역할과 정책"] --> B["Skill instructions"]
  C["keystone-hub<br/>배포 레이어"] --> D["Claude commands"]
  C --> E["Codex skills"]
  C --> F["hooks / settings"]
  B --> D
  B --> E

ai-rules는 어떤 기준으로 일할지 정의하고, keystone-hub는 그 기준을 실제 호출 가능한 표면으로 배포합니다.

공개 문서화 기준

• 설치된 모든 항목을 나열하기보다 대표 작업 표면을 설명한다.
• 특정 개인 경로나 토큰이 들어간 설정은 공개하지 않는다.
• “사용 가능”보다 “언제 쓰는가”를 중심으로 설명한다.
• 결과 검증은 Evidence 메뉴와 연결한다.

체크리스트

• 새 작업이 반복된다면 skill 후보인가?
• 새 도구가 필요하다면 MCP allowlist나 plugin 경계가 있는가?
• 명령으로 노출해야 할 만큼 자주 쓰이는가?
• hook으로 막아야 할 만큼 위험하거나 반복되는가?