# 읽는 지식과 실행하는 capability

> 문서·skill·plugin·MCP를 선택하는 기준

- Canonical: https://learning.reopt.ai/en/courses/agentic-documentation/lessons/ad-m3-concept
- Language: en
- HTML: https://learning.reopt.ai/en/courses/agentic-documentation/lessons/ad-m3-concept

---

[Agentic documentation](/en/courses/agentic-documentation) 3. 문서에서 실행 표면으로 5 / 9

# 읽는 지식과 실행하는 capability

문서·skill·plugin·MCP를 선택하는 기준
Concept 45 XP 9 min

매번 읽고 사람이 따라 하는 절차가 안정되면 실행 표면으로 옮길 수 있습니다. 다만 문서를 자동화한다고 모든 API를 tool로 노출해서는 안 됩니다. 읽기 문맥·반복 절차·외부 변경 권한 을 서로 다른 계층으로 관리합니다.
권한이 커질수록 더 강한 계약 설명은 문서, 반복 가능한 로컬 절차는 skill, 배포 가능한 기능 묶음은 plugin, 외부 시스템 capability는 MCP로 두고, write 도구에는 최소 권한·승인·감사 로그를 강제합니다.

| 표면 | 적합한 내용 | 필수 통제 |
| 문서 | 개념·결정·정책·예외 | 출처·owner·기준일 |
| Skill | 반복 workflow와 검증 | 명확한 trigger·입출력·script |
| Plugin | 팀 배포용 skill·hook·tool 묶음 | 버전·의존성·설치 정책 |
| MCP resource | 읽기 전용 외부 문맥 | scope·tenant 경계 |
| MCP tool | 외부 실행·변경 | strict schema·승인·audit |

- 1 반복성 확인 같은 입력과 판정 기준으로 세 번 이상 반복되는지 봅니다.

- 2 권한 분류 read·compute·write와 외부 부작용을 나눕니다.

- 3 표면 선택 문서·skill·plugin·MCP 중 가장 낮은 권한을 고릅니다.

- 4 실패 계약 거절·승인·rollback·감사 기록을 설계합니다.

실무에 남길 기준

- 자동화 가능성과 외부 권한 노출은 별개의 결정이다
- 읽기 지식은 resource, 변경 capability는 tool로 분리한다
- skill과 plugin도 버전·owner·폐기 정책이 필요한 운영 자산이다

[Previous](/en/courses/agentic-documentation/lessons/ad-m2-scenario) Got it · Continue

---

Site guide for agents: https://learning.reopt.ai/llms.txt · Sitemap: https://learning.reopt.ai/sitemap.xml · Contact: https://learning.reopt.ai/contact