68 lines
2.0 KiB
Markdown
68 lines
2.0 KiB
Markdown
# 💻 Developer — 도구 매니페스트
|
|
|
|
_Developer 에이전트가 어떤 도구를 어디까지 자율적으로 쓸 수 있는지 정의합니다._
|
|
_매번 시스템 프롬프트로 주입되며, 텔레그램에서 `/tools`로 현재 상태 확인 가능._
|
|
|
|
---
|
|
|
|
## 자율도 레벨
|
|
|
|
AUTONOMY_LEVEL: 2
|
|
|
|
| 값 | 의미 |
|
|
|---|---|
|
|
| 0 | Off — 도구 전체 비활성 (이 에이전트는 채팅만) |
|
|
| 1 | Read-only — 읽기·분석·보고만, 외부에 쓰기 X |
|
|
| 2 | Draft — 초안 작성 후 사용자 승인 게이트 통과해야 실행 ⭐ 권장 기본값 |
|
|
| 3 | Auto — 화이트리스트 안에서 사용자 승인 없이 실행 |
|
|
|
|
> 위 `AUTONOMY_LEVEL` 줄의 숫자(0~3)를 직접 바꾸면 다음 호출부터 적용됩니다.
|
|
|
|
---
|
|
|
|
## 사용 가능한 도구
|
|
|
|
### `project_scaffolder`
|
|
_company/projects/<name>/ 폴더 자동 생성 (vite/next/astro)
|
|
|
|
- `enabled`: true
|
|
- `requires_credentials`: `config.md` 참조
|
|
|
|
### `dev_server`
|
|
자체 dev server + 포트 매니저 + 라이브 미리보기 푸시
|
|
|
|
- `enabled`: true
|
|
- `requires_credentials`: `config.md` 참조
|
|
|
|
### `git_committer`
|
|
작업 단위 자동 커밋
|
|
|
|
- `enabled`: true
|
|
- `requires_credentials`: `config.md` 참조
|
|
|
|
### `deploy_cli`
|
|
Vercel/Netlify/Cloudflare 배포 (deploy --prod는 항상 승인)
|
|
|
|
- `enabled`: true
|
|
- `requires_credentials`: `config.md` 참조
|
|
|
|
### `lint_test`
|
|
테스트·린트·타입체크 자동 실행
|
|
|
|
- `enabled`: true
|
|
- `requires_credentials`: `config.md` 참조
|
|
|
|
|
|
---
|
|
|
|
## 안전 규칙 (모든 레벨 공통, 절대 우회 X)
|
|
|
|
- **삭제·배포·발송**(rm, deploy --prod, send, publish) 류는 자율도와 무관하게 **항상 승인 게이트**.
|
|
- 외부 API 호출 전 `config.md`의 토큰 존재 여부 확인.
|
|
- 모든 외부 행동은 `_agents/developer/activity.log`에 한 줄 기록 (감사용).
|
|
- 승인 대기 액션은 `approvals/pending/` 에 저장 → 텔레그램 `/approvals` 로 조회.
|
|
|
|
---
|
|
|
|
_레벨을 어떻게 골라야 할지 모르겠다면 `2 (Draft)`가 안전한 시작점입니다._
|