ai-guide
무엇인가
AI 프로그래밍 도구 운용과 제품화 절차를 문서 자산으로 규율하는 스킬이다. 모델·도구 선택, 대화 설계, 컨텍스트 관리, 환각 처리, 코드 품질 보증, 수익화 단계까지 에이전트가 참조할 판단 기준을 한 저장소에 모아 둔다.
어떻게 동작하나
단일 규칙 파일이 아니라 디렉터리 트리로 동작한다. `00 Vibe Coding 简介`, `01 快速上手`, `10 编程工具`, `15 模型动态`, `30 经验技巧`, `50 产品变现`, `70 概念大全` 같은 마크다운 문서가 규칙 본문 역할을 하고, 에이전트는 도구 선택·프롬프트 작성·프로젝트 착수 시점에 해당 문서를 컨텍스트로 로드한다. 슬래시 명령이나 훅이 아니라 참조 지식 주입 방식이다.
무엇과 다른가
행동 제약만 나열하는 `AGENTS.md`·`CLAUDE.md`와 달리 규칙과 배경 지식을 분리해 쌓는다. 프롬프트를 매번 직접 작성하는 방식과 달리 도구 비교, 모델 동향, 실패 사례, 수익화 경로까지 문서로 고정해 재사용한다. 규칙 파일 하나로 끝나는 skill-file과도 구조가 다르다.
어떻게 쓰나
저장소를 클론해 작업 디렉터리 옆에 두고 `CLAUDE.md`에서 참조 경로를 지정한다. 첫 사용은 `00`·`01` 문서로 전체 흐름을 확인한 뒤 `10 编程工具`에서 대상 도구 항목을 골라 읽히는 순서다. README에 별도 설치 명령은 없다.
전제와 한계
Claude Code 기준으로 붙이며 문서 본문은 중국어다. 실행 코드나 검증 훅이 아니므로 규칙 위반을 자동으로 막지 못하고, 에이전트가 문서를 실제로 읽었는지는 별도로 확인해야 한다. 문서 라이선스가 CC BY-NC-SA 4.0이라 상업 프로젝트에 내용을 그대로 옮겨 쓸 수 없다.