donald-agent-hygiene은(는) 무엇을 하나요?
Claude Code + Codex의 skills/MCP/hooks/memory를 사용 기반으로 감사 및 정리하여, HTML 보고서, 안전한 적용(드라이런+백업), 로컬 원클릭 실행 서버를 제공합니다.
개요
donald-agent-hygiene은 Claude Code와 Codex 에이전트 환경에서 불필요한 skills, MCP 서버, hooks, 메모리 파일을 식별하고 정리하는 도구입니다. 각 구성 요소의 실제 사용 내역을 분석하여 더 이상 필요하지 않은 요소를 자동으로 제거하거나 비활성화할 수 있습니다.
주요 기능
- 사용량 기반 감사: 각 skill, MCP 서버, hook, 메모리 파일의 최근 사용 이력을 분석합니다.
- 드라이런 모드: 실제 적용 전에 어떤 변경이 이루어질지 미리 확인할 수 있습니다.
- HTML 보고서: 감사 결과를 시각적이고 상세한 HTML 형식으로 제공합니다.
- 안전한 적용: 변경 전 자동 백업을 생성하여 문제 발생 시 복구할 수 있습니다.
- 로컬 서버: 지속적인 정리 워크플로우를 위한 원클릭 실행 서버를 제공합니다.
지원 플랫폼
- Claude Code
- Codex
사용 방법
CLI 사용
# 감사 실행 (드라이런)
npx donald-agent-hygiene audit --dry-run
# 정리 적용 (백업 포함)
npx donald-agent-hygiene apply --backup
# HTML 보고서 생성
npx donald-agent-hygiene report --output ./hygiene-report.html
로컬 서버 사용
# 서버 시작
npx donald-agent-hygiene server --port 3000
# 브라우저에서 http://localhost:3000 접속하여 원클릭 실행
설정
프로젝트 루트에 donald-agent-hygiene.config.js 파일을 생성하여 사용자 정의 규칙을 설정할 수 있습니다.
module.exports = {
// 감사 제외 목록
exclude: [
"core-skills",
"essential-mcp"
],
// 백업 디렉토리 위치
backupDir: "./hygiene-backups",
// 보고서 출력 경로
reportPath: "./hygiene-report.html"
};
환경 변수
DONALD_HYGIENE_DRY_RUN:true로 설정하면 모든 작업이 드라이런 모드로 실행됩니다.DONALD_HYGIENE_BACKUP_DIR: 백업 파일 저장 위치를 지정합니다.DONALD_HYGIENE_PORT: 로컬 서버 포트를 지정합니다 (기본값: 3000).
라이선스
MIT