zgx949/ai-pojia

破甲CodeX。面向小白的实用 Skills 与插件，可直接破甲CodeX发挥出模型最大的潜能，附完整教程和示例。

AI破甲 (ai-pojia) 는 OpenAI Codex 코딩 에이전트용 구성 및 Skill 설치 프로그램입니다. 사용자 지정 지침 파일과 Skill을 설정하여 Codex가 작업을 처리할 때 특정 권한 기반 워크플로를 따르도록 합니다. 프로젝트는 버전 0.2.0이며, 업스트림 프로젝트의 gpt-instruct v45 프롬프트를 다시 작성한 버전을 기반으로 하지만, 모든 목표를 자동으로 샌드박스 처리하거나, 소유권/범위를 무시하거나, 무조건적으로 답변을 거부하는 등의 기능을 명시적으로 제거합니다. AI가 승인된 작업을 완료하고 검증 가능한 출력을 생성하는 것을 목표로 하지만, 모든 모델에서 작동하거나 공식 데모 테스트를 통과했다고 주장하지 않습니다.

설치 내용

프롬프트 파일(prompts/ai-pojia.md)을 Codex 디렉토리에 복사하고 model_instructions_file 설정을 통해 로드합니다(새 세션에 대한 Codex 내장 지침을 대체).
Skill(skills/ai-pojia/SKILL.md)을 같은 디렉토리의 skills/ai-pojia/에 설치합니다.
구성 확인, 미리보기, 백업 및 복원 도구를 제공합니다.

설치 프로그램은 자체 프롬프트, Skill 및 관련 설정만 관리합니다. 모델, 공급자, 인증 또는 권한 설정은 변경하지 않습니다.

설치

가장 간단한 방법: Codex에 특정 메시지를 보내 리포지토리를 클론하고, README를 읽고, python3 install.py를 실행한 다음 python3 install.py --doctor를 실행하여 확인하도록 요청합니다.
수동: git clone, cd, python3 install.py. Python 3.9+ 및 model_instructions_file과 로컬 Skill을 지원하는 Codex 버전이 필요합니다. Windows에서는 python3 대신 py -3을 사용합니다.
--codex-dir로 사용자 지정 Codex 디렉토리를 지정할 수 있습니다(기본값은 CODEX_HOME 또는 ~/.codex).

사용법

설치 후 일반 작업은 로드된 지침을 사용합니다.
자체 작성 테스트 데모의 경우 파일을 별도 디렉토리에 넣고 "$ai-pojia를 사용하여 이 테스트 DEMO를 분석하세요..."와 같은 메시지를 보냅니다. 그러면 Skill이 요약, 분석 증거, 수정된 복사본, diff, 검증 명령 및 실제 결과를 생성합니다.
demos/ 폴더에는 현재 테스트 프로그램이나 사전 설정된 답변이 없습니다. 공식 데모는 나중에 계획됩니다.

확인, 미리보기 및 제거

python3 install.py --doctor – 설치 확인.
python3 install.py --dry-run – 파일을 쓰지 않고 미리보기.
python3 install.py --uninstall – 원래 최상위 지침 필드를 복원하고 Skill을 보관.
파일을 수동으로 편집했거나 충돌이 있는 경우 도구가 중지되고 실제 상태를 보고합니다.

업스트림 및 수정 사항

이 버전은 연속 실행, 아티팩트 전달, 기준선 비교 및 복구 검증을 유지하지만, 모든 실제 목표를 샌드박스 처리하거나, 소유권/범위를 무시하거나, 무조건 거부를 금지하거나, 관련 없는 브랜치를 제거합니다.
성공적으로 로드되었다는 것은 구성이 내장 지침을 가리키고 검증한다는 의미일 뿐이며, 모델이 요청을 수락할 것이라고 보장하지 않습니다. 클라이언트, 모델 및 서버 측 규칙은 결과에 영향을 미칩니다.

개발

테스트는 python3 -m unittest discover -s tests -v로 실행합니다.
패키징은 python3 tools/package_release.py로 합니다.
플러그인 패키징을 위한 plugin.json이 있지만 아직 게시되지 않았습니다. Skill을 설치하지만 전역 지침은 수정하지 않습니다. 전체 원클릭 진입점은 install.py입니다.

제한 사항

보편적인 거부 취소, 전체 모델 호환성, 공식 데모 완료 결과는 아직 없습니다.
실제 검증 범위는 docs/validation.md에 문서화되어 있습니다.