chancy24/codex-knowledge-base-skill

프로젝트 지식 관리자

목적

이 스킬을 사용하여 AI 코딩 에이전트를 위한 프로젝트 수준의 지식 기반을 초기화, 유지 및 발전시키십시오. 지식 기반은 향후 에이전트 세션이 프로젝트 목적, 아키텍처, 인터페이스, 결정 사항, 버그 및 최근 변경 사항을 처음부터 다시 파악하지 않고도 이해할 수 있도록 도와줍니다.

워크플로우는 도구 중립적으로 유지하십시오. Codex, Claude Code, Cursor, Gemini CLI 등 프로젝트 파일을 읽고 저장소 로컬 지침을 따를 수 있는 모든 코딩 에이전트에서 사용 가능해야 합니다.

사용 시기

사용자가 다음을 요청할 때 이 스킬을 사용하십시오:

• 프로젝트 지식 기반 초기화
• 프로젝트 요약 또는 문서화
• 버그 수정 및 수리 경험 보존
• 기능 추가 또는 변경
• API, 스키마, 명령어 또는 데이터 형식 추가 또는 변경
• 기술적 결정 또는 트레이드오프 기록
• 원시 프로젝트 자료를 구조화된 지식으로 정리
• 완료된 개발 세션 검토 또는 회고
• AGENTS.md 또는 knowledge/ 아래 파일 업데이트

입력

일반적인 입력은 다음과 같습니다:

• 현재 저장소 또는 대상 프로젝트 경로.
• 기존 프로젝트 파일, 소스 코드, 문서, 이슈, 로그 또는 원시 자료.
• 사용자의 현재 작업 및 세션 중 수행된 구현 변경 사항.
• 기존 AGENTS.md, knowledge/, raw/ 또는 skills/ 콘텐츠 (있는 경우).

출력

예상 출력은 다음과 같습니다:

• AGENTS.md 프로젝트 규칙.
• knowledge/overview.md 프로젝트 개요.
• knowledge/business.md 비즈니스 로직 및 사용 시나리오.
• knowledge/architecture.md 시스템 아키텍처 및 데이터 흐름.
• knowledge/api.md 인터페이스, 스키마, 명령어 및 데이터 구조.
• knowledge/decisions.md 기술적 결정 및 트레이드오프.
• knowledge/bugs.md 버그 이력, 근본 원인, 수정 사항 및 방지 규칙.
• knowledge/changelog.md 세션 수준 변경 기록.
• 선택적 raw/ 및 프로젝트 로컬 skills/ 폴더.
• 무엇이 업데이트되었고 무엇이 여전히 검증이 필요한지에 대한 간략한 최종 보고서.

워크플로우

1. 먼저 프로젝트 규칙을 읽으십시오:
   • AGENTS.md (있는 경우)
   • knowledge/overview.md
   • knowledge/architecture.md
   • knowledge/decisions.md
   • knowledge/bugs.md
2. 저장소를 초기화하는 경우, references/templates/의 템플릿을 사용하거나 이 패키지의 초기화 스크립트를 실행하십시오.
3. 현재 작업을 이해하고 무엇이 변경되었는지 식별하십시오:
   • 프로젝트 목표 또는 비즈니스 로직
   • 아키텍처 또는 모듈 경계
   • API, 명령어, 데이터 파일, 스키마 또는 반환 구조
   • 버그 증상, 근본 원인, 수정 사항 또는 방지 규칙
   • 기술적 결정 또는 트레이드오프
   • 사용자 대면 동작 또는 UI 관례
4. 관련 지식 파일만 업데이트하십시오.
5. 중복되거나, 오래되었거나, 모순된 콘텐츠를 제거하거나 조정하십시오.
6. 중요한 작업 후에는 항상 knowledge/changelog.md를 업데이트하십시오.
7. 업데이트된 파일과 누락된 검증 사항을 보고하십시오.

더 자세한 유지 관리 지침은 references/playbook.md를 읽으십시오.

knowledge/ 업데이트

변경 사항과 일치하는 가장 작은 파일을 사용하십시오:

• 지속적인 프로젝트 목적, 범위, 주요 모듈 및 주요 출력물에 대한 overview.md 업데이트.
• 사용자 시나리오, 워크플로우, 도메인 규칙 및 안전 경계에 대한 business.md 업데이트.
• 모듈 관계, 데이터 흐름, 런타임 모드 및 통합 경계에 대한 architecture.md 업데이트.
• 엔드포인트, 함수, 명령어, 이벤트, 데이터 파일, 스키마 및 반환 구조에 대한 api.md 업데이트.
• 의미 있는 기술적 선택 및 트레이드오프에 대한 decisions.md 업데이트.
• 확인된 버그 및 교훈에 대한 bugs.md 업데이트.
• 모든 중요한 작업 요약에 대한 changelog.md 업데이트.

일시적인 추론을 지식 기반에 덤프하지 마십시오. 안정적인 사실, 검증된 결정 및 재사용 가능한 교훈을 선호하십시오.

버그 회고

버그가 수정되면 knowledge/bugs.md를 다음으로 업데이트하십시오:

• 문제 증상.
• 근본 원인.
• 수정 사항.
• 영향 범위.
• 수행된 검증.
• 재발 방지 규칙.

근본 원인이 확실하지 않은 경우, 추측하지 말고 보류 중인 검증으로 표시하십시오.

인터페이스 변경

API, 명령어, 함수, 스키마, CSV, 이벤트 또는 파일 형식이 변경되면 knowledge/api.md를 다음으로 업데이트하십시오:

• 인터페이스 이름.
• 요청 메서드 또는 호출 스타일.
• 경로, 명령어, 함수 이름 또는 파일 경로.
• 입력 및 매개변수.
• 응답 또는 출력 형식.
• 참고 사항, 제약 조건 및 예제.

정확한 이름과 필드 철자를 사용하십시오.

기술적 결정

의미 있는 기술적 선택이 이루어지면 knowledge/decisions.md를 다음으로 업데이트하십시오:

• 결정 배경.
• 고려된 옵션.
• 최종 선택.
• 선택 이유.
• 결과 및 후속 작업.

향후 에이전트가 해결된 질문을 다시 열지 않도록 도움이 될 결정을 기록하십시오.

지식 부패 방지

• 거의 중복되는 항목을 추가하는 것보다 기존 항목을 편집하는 것을 선호하십시오.
• 오래된 콘텐츠를 대체됨으로 표시하거나 현재 사실로 대체하십시오.
• 프로젝트 사실을 추측과 분리하여 유지하십시오.
• 결정, 버그 및 변경 로그 항목에 날짜를 사용하십시오.
• 특정 도구 통합에 도구별 메모가 필요한 경우가 아니라면 에이전트 중립적인 표현을 유지하십시오.
• 명시적인 요청 없이 사용자가 작성한 프로젝트 규칙을 덮어쓰지 마십시오.

최종 응답

최종 응답은 간결하게 유지하십시오. 다음을 포함하십시오:

• 업데이트된 파일.
• 수행된 검증.
• 남아 있는 수동 확인 사항.