configure-ecc

Everything Claude Code 구성

현재 환경에서 대화형 마법사를 실행합니다. 먼저 현재 상태를 조사하고, 지원되는 옵션만 수집한 후 미리보기, 한 번의 확인, 비대화형 적용, 검증, 그리고 성공 시에만 환영 메시지를 표시합니다. ECC를 임시 디렉토리에 복제하거나 플러그인 구성 요소를 수동으로 복사하지 마십시오.

인간이 직접 조작하는 터미널의 경우 표준 진입점은 ecc setup 및 npx ecc-universal setup입니다. AI 에이전트 환경에서는 아래의 명시적인 비대화형 명령을 대신 사용하십시오.

현재 환경에 따라 경로 분기

• Claude Code에서는 아래의 전체 범위 및 후크 마법사를 사용합니다.
• Codex에서는 Codex의 네이티브 플러그인 수명 주기를 사용합니다. Claude의 범위를 제공하거나 ECC의 네 가지 Claude 후크 프로필을 Codex에 매핑하지 마십시오.
• Kimi에서는 ./.kimi-code 아래에 프로젝트 표면을 설치합니다. Kimi는 ECC의 Claude 수명 주기 후크 프로필을 제공하지 않습니다.
• 환경이 확실하지 않으면 감지된 증거를 명시하고 변경 명령을 실행하기 전에 어떤 환경을 구성할지 물어보십시오.

이 스킬은 설치 후 재구성 경로입니다. 제공자의 기본 제공 첫 설치 UI를 가로채거나 대체할 수 없습니다.

Claude Code: 전체 대화형 마법사 실행

1. 변경 없이 현재 상태 조사

두 명령을 모두 실행하고 설치된 ECC 범위, 활성화 상태 및 마켓플레이스 출처를 요약합니다:

claude plugin list --json
claude plugin marketplace list --json

단일 기존 ecc@ecc 설치는 재구성으로 처리합니다. Claude 제공자의 "홈 페이지 열기" 제어를 설치 증거로 해석하지 마십시오. 여러 ECC 범위, 레거시/수동 설치, 설정 오류 또는 마켓플레이스 충돌이 있는 경우 setup이 반환하는 복구 방법을 보고하고 중단합니다. 어떤 상태를 삭제할지 추측하지 마십시오.

2. 정확히 두 가지 선택 수집

정확히 하나의 범위 질문을 하고 하나의 값을 요구합니다:

• user | project | local
• user는 이 사용자에게 전역입니다.
• project는 저장소 설정을 통해 공유됩니다.
• local은 현재 프로젝트에 비공개입니다.

선택한 범위만 선택 또는 설치 중으로 시각적으로 표시합니다. 사용자가 단일 기존 설치와 다른 범위를 선택하는 경우 이를 범위 마이그레이션으로 설명하고 아래 명령에 --move-scope를 포함합니다.

정확히 하나의 후크 모드 질문을 하고 하나의 값을 요구합니다:

• off | minimal | standard | strict
• off는 스킬과 명령을 유지하지만 ECC 후크 자동화를 비활성화합니다.
• minimal은 가장 가벼운 수명 주기 및 안전 자동화를 활성화합니다.
• standard는 품질과 안전 자동화의 균형을 맞춥니다.
• strict는 가장 강력한 검사와 알림을 활성화합니다.

후크 선호도는 개인 Claude 플러그인 구성입니다. 선택한 설치 범위를 따르지 않습니다.

3. 미리보기 및 한 번 확인

플러그인 번들 setup 스크립트를 선호합니다. 두 개의 선택된 값을 대체하고 범위 마이그레이션의 경우에만 --move-scope를 포함합니다:

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

$CLAUDE_PLUGIN_ROOT을 사용할 수 없으면 공개 npm 패키지를 사용합니다:

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

계획된 작업, 하나의 범위, 하나의 후크 모드, 마켓플레이스 작업 및 출발지에서 목적지로의 마이그레이션을 포함하는 정확히 하나의 확인 요약을 표시합니다. 하나의 예/아니오 질문을 합니다. 환경 셸 도구를 통해 대화형 ecc setup을 실행하지 마십시오. 해당 셸은 일반적으로 TTY가 아닙니다.

4. 명시적 선택 적용

확인 후, --dry-run 없이 동일한 경로를 다시 실행합니다. 모든 선택을 명시적으로 유지하고 JSON을 요청하여 성공을 결정론적으로 확인할 수 있도록 합니다:

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

대체:

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

5. 검증 후 환영 메시지 표시

종료 상태 0과 scope 및 hooks가 선택한 값과 일치하는 setup 결과를 요구합니다. 그런 다음 독립적으로 실행합니다:

claude plugin list --json

선택한 범위에 정확히 하나의 활성화된 ecc@ecc 항목이 있는 경우에만 계속합니다. $CLAUDE_PLUGIN_ROOT을 사용할 수 있는 경우 성공적인 setup action(installed, updated, migrated, resumed 또는 already-migrated)을 번들 렌더러에 전달합니다:

호출하기 전에 제공자가 보고한 버전이 scripts/lib/terminal-welcome.js의 ECC_VERSION_PATTERN과 일치하는지 확인합니다. 예상치 못한 버전 텍스트를 셸 명령에 삽입하는 대신 거부합니다.

node -e 'const { renderTerminalWelcome } = require(process.env.CLAUDE_PLUGIN_ROOT + "/scripts/lib/terminal-welcome"); process.stdout.write(renderTerminalWelcome({ action: process.argv[1], version: process.argv[2], color: process.stdout.isTTY }));' "<action>" "<installed-version>"

환영 메시지를 정확히 한 번 표시합니다. 실패, dry-run, 취소, 범위 또는 후크 불일치 또는 확인 불가능한 상태인 경우 표시하지 않고 오류와 복구 방법을 보고합니다. 확인된 변경 후 사용자에게 /reload-plugins를 실행하거나 Claude Code를 다시 시작하라고 알립니다.

Codex: 네이티브 플러그인 수명 주기 사용

codex plugin marketplace list --json 및 codex plugin list --available --json으로 현재 상태를 조사합니다. Codex의 네이티브 플러그인 명령에는 Claude 스타일의 user | project | local 선택기가 없습니다. Codex 네이티브 플러그인은 제공자별 후크를 지원하지만 Codex는 이에 대한 명시적 신뢰를 요구합니다. Codex가 해당 신뢰 결정을 표시하도록 합니다. Claude의 네 가지 프로필 후크 질문을 하거나 해당 프로필이 Codex에 매핑된다고 주장하지 마십시오.

ECC 마켓플레이스가 없으면 추가합니다. 그렇지 않으면 스냅샷을 새로 고칩니다:

codex plugin marketplace add affaan-m/ECC
codex plugin marketplace upgrade ecc --json

한 번의 확인을 요청한 다음 설치하거나 설치된 캐시를 멱등적으로 새로 고치고 확인합니다:

codex plugin add ecc@ecc --json
codex plugin list --json

JSON이 ECC 설치를 보고하고 installedPath를 제공하는 경우에만 계속합니다. 그런 다음 확인된 번들의 환영 메시지를 표시합니다:

Codex JSON이 반환한 정확한 절대 installedPath만 사용합니다. 제어 문자를 거부하고 설치된 버전이 ECC_VERSION_PATTERN과 일치하는지 확인합니다. 이 인수 배열로 node를 직접 호출합니다. 이는 셸 명령이 아닌 도구 API 호출입니다:

["<installedPath>/scripts/welcome.js", "--action", "configured", "--version", "<installed-version>"]

현재 환경에서 별도의 인수 배열로 실행 파일을 호출할 수 없는 경우 환영 메시지를 건너뜁니다. Codex JSON 값으로 셸 명령을 구성하지 마십시오.

Claude의 off | minimal | standard | strict 프로필이 Codex에 적용되었다고 주장하지 마십시오.

Kimi: 프로젝트 표면 설치

확인 전에 기능 요약을 표시합니다: 대상 ./.kimi-code; ECC 수명 주기 후크의 경우 hooks=unsupported. Claude 범위 또는 후크 모드 질문을 하지 마십시오. 먼저 미리보기:

npx --yes --package ecc-universal ecc install --profile core --target kimi --dry-run

해당 프로젝트 대상에 대한 한 번의 확인을 표시한 다음 --dry-run 없이 동일한 명령을 적용합니다. 다음으로 확인합니다:

npx --yes --package ecc-universal ecc doctor --target kimi

doctor가 성공하고 설치된 지침과 스킬이 ./.kimi-code 내에 남아 있는 경우에만 다음을 표시합니다:

npx --yes --package ecc-universal ecc welcome --action configured

Kimi가 ECC 수명 주기 후크를 설치하거나 구성했다고 주장하지 마십시오.