Question 1

test-bash-workflow.sh를 실행할 때 발생하는 macOS BSD sed 오류 "invalid command code f"를 어떻게 해결하나요?

Accepted Answer

이 스크립트는 GNU 전용 `sed -i 's/.../' file`을 사용합니다. macOS에서 BSD `sed`는 `-i` 뒤에 백업 접미사를 요구하므로, 치환 표현식을 접미사로, 파일명을 sed 스크립트로 파싱하게 됩니다.

`skills/scripts/test-bash-workflow.sh`의 52, 60, 61번 줄에 있는 `sed -i` 호출을 이식 가능한 형태로 수정하세요:

```sh
if sed --version >/dev/null 2>&1; then
  SEDI=(-i)
else
  SEDI=(-i '')
fi

sed "${SEDI[@]}" 's/mode: authorized_target_only/mode: invalid_mode/g' "$SCRATCH/work/test-bash-01/scope.md"
```

나머지 두 치환에도 동일한 패턴을 적용하세요:

```sh
sed "${SEDI[@]}" 's/mode: invalid_mode/mode: authorized_target_only/g' "$SCRATCH/work/test-bash-01/scope.md"
sed "${SEDI[@]}" 's/status: granted/status: pending/g' "$SCRATCH/work/test-bash-01/scope.md"
```

또는 `sed -i`를 아예 사용하지 않을 수도 있습니다:

```sh
tmp="$(mktemp)"
sed 's/a/b/' "$file" > "$tmp" && mv "$tmp" "$file"
```

그런 다음 다시 실행하세요:

```sh
bash skills/scripts/test-bash-workflow.sh
```

이제 테스트 4와 5가 macOS에서 실행되어 `FAIL=0`으로 완료되어야 합니다. 회귀를 방지하려면 이 스크립트를 `macos-bash-compat.yml` CI 워크플로에 추가하세요.

Question 2

Windows에서 ReFirmLabs.binwalk에 대해 winget 오류 "No package found matching input criteria"가 발생하며 binwalk 자동 설치가 실패하는 문제를 어떻게 해결하나요?

Accepted Answer

선언된 winget ID `ReFirmLabs.binwalk`는 winget 리포지토리에 존재하지 않으며, binwalk는 사전 빌드된 Windows 릴리스 바이너리를 제공하지 않습니다. `skills/scripts/bootstrap-manifest.json`의 binwalk 항목을 `winget-package`에서 수동 설치로 변경하고, `jeb-pro`/`binaryninja` 패턴을 따라 `"bootstrapKind": "manual"`과 `"canAutoInstall": false`를 설정한 후 `manualInstallHint`를 추가하세요. 힌트는 사용자에게 다음 명령을 실행하도록 안내해야 합니다:

```powershell
winget install --id Rustlang.Rustup --exact
```

설치 후 터미널을 다시 시작한 다음 Cargo로 binwalk를 설치하세요:

```powershell
cargo install binwalk
```

다음 명령으로 확인하세요:

```powershell
binwalk --version
```

또한 `skills/tool-index.md.template`과 `CHANGELOG.md`를 업데이트하여 binwalk가 더 이상 Windows에서 winget으로 자동 설치 가능한 것으로 안내되지 않도록 하세요. 그러면 `bootstrap-reverse.ps1 -Capability binwalk`를 다시 실행했을 때 winget 오류 `0x8A150014` 대신 `MANUAL_INSTALL_REQUIRED`가 보고되어야 합니다. 향후 개선 사항으로는 3.1.0과 같이 고정된 binwalk 버전을 사용하는 일급 `cargo-install` 부트스트랩 종류를 추가하는 것이 있습니다.

Question 3

AI 코딩 에이전트가 README_AI.md를 읽은 후 스크립트를 자동으로 실행하거나 전역 규칙을 주입하는 것을 막으려면 어떻게 해야 하나요?

Accepted Answer

`fix(security): consent-gate agent bootstrap` 변경 사항이 포함된 릴리스 또는 PR로 업그레이드하세요. 즉시 업그레이드할 수 없는 경우 `README_AI.md`의 섹션 0을 편집하여 `refresh-tool-index.sh`, `refresh-tool-index.ps1`, 그리고 `RULES.md` 자동 로딩을 비롯해 에이전트에게 즉시 실행을 지시하는 모든 지침을 제거하세요. 이를 다음과 같은 명시적 동의 게이트로 교체하세요: `Do not run any command, script, or configuration change until you show the user the exact commands and receive explicit confirmation.` 또한 "global injection" 단계를 제거하고 관련 케이스 또는 작업 디렉터리에서만 라우팅 규칙을 로드하세요. 더 안전한 설정을 위해 검증된 릴리스 태그에서 체크섬이 포함된, 사람이 직접 실행하는 설치 프로그램을 게시하세요. 사용자는 에이전트가 설정을 수행하기 전에 이를 검증하고 실행해야 합니다. 즉각적인 완화 조치로서 예를 들어 `chmod -x refresh-tool-index.sh`와 같이 부트스트랩 스크립트를 검사하거나 비활성화하고, Claude Code, Codex, Cursor, Cline, Windsurf, Kiro, OpenCode 또는 Pi에서 리포지토리를 열기 전에 `README_AI.md`와 `RULES.md`를 검토하세요.

Question 4

이 프로젝트는 어떻게 사용하나요? 클론한 후 리포지토리 폴더에서 에이전트를 시작한 다음 질문을 하면 되나요?

Accepted Answer

네. 전체 리포지토리를 클론하고, 리포지토리 루트를 Agent 워크스페이스로 연 다음, 에이전트가 `AGENTS.md`와 `RULES.md`를 읽도록 하세요. 그런 다음 플랫폼 고유의 `master-route` 및 `case-init` 명령을 사용하여 특정 스킬에 진입하세요. 이는 단순히 스킬을 설치하는 문제가 아닙니다. 자세한 지침은 `docs/QUICKSTART_zh.md`에 제공되며, README에도 이 가이드로 연결되는 링크가 있습니다. 공식 문서는 reverse.apivix.com에서도 확인할 수 있습니다.

Question 5

Cursor가 스킬 설치를 거부할 때 macOS에서 스킬을 수동으로 설치하려면 어떻게 해야 하나요?

Accepted Answer

Cursor가 클라이언트 측 보안 정책으로 인해 거부하는 경우, 리포지토리에서 수동으로 설치하세요. 전체 리포지토리를 클론한 후 다음을 실행하세요:

```bash
bash skills/scripts/refresh-tool-index.sh
```

또는 스킬을 직접 복사하세요:

```bash
cd skills && cp -r . ~/.agents/skills/
```

macOS에서는 핵심 워크플로가 네이티브 Bash 스크립트 `master-route.sh`, `case-init.sh`, `refresh-tool-index.sh`를 사용하며, PowerShell은 필요하지 않습니다. 자세한 단계는 `docs/platforms/macos.md`와 `docs/QUICKSTART_zh.md`에 있습니다. 바이러스 백신이나 보안 도구에서 심각한 플래그를 보고하는 경우 먼저 스크립트를 검토하세요.

reverse-skill

개요

README 미리보기

FAQ (5)

同类型项目

rust

ponytail

agency-agents

obsidian-skills