AnastasiyaW/knowledge-space

knowledge-space은(는) 무엇을 하나요?

큐레이트된 기술 지식 베이스: 26개 도메인에 걸친 785개 이상의 밀도 높은 참고 문서. 위키 링크, 주의사항, 실행 가능한 코드를 포함한 에이전트 우선 형식. AI 에이전트와 엔지니어를 위한 검증된 참고 자료(튜토리얼 아님).

개요

knowledge-space는 AI 에이전트와 숙련된 개발자가 복잡한 기술 주제를 빠르게 이해할 수 있도록 특별히 설계된 고밀도 기술 문서 라이브러리입니다. 기존 블로그 게시물이나 공식 문서와 달리, 각 문서는 핵심 개념, 일반적인 실수(gotchas), 바로 실행 가능한 코드 예제를 강조하며 최대한 간결하게 작성되었습니다.

주요 기능

• 방대한 범위: 785개 이상의 문서가 Python, JavaScript, TypeScript, React, Node.js, Docker, Kubernetes, AWS, Git, SQL, Linux 등 26개 도메인을 다룹니다.
• 에이전트 최적화 형식: 각 문서에는 다음이 포함됩니다:
  • 다른 문서로 연결되는 내부 위키 링크
  • gotchas 섹션: 일반적인 실수와 주의해야 할 점
  • 바로 복사하여 사용할 수 있는 runnable code 예제
• 튜토리얼이 아닌 참고 자료: 깊이 있는 설명이나 단계별 가이드보다는 간결하고 정확한 참고 정보에 중점을 둡니다.
• 다양한 플랫폼 지원: Claude Code, Cursor, Codex, GitHub Copilot 등 모든 AI 에이전트 환경에서 동작합니다.

사용 방법

직접 접근

저장소를 복제하고 원하는 문서를 찾아보세요:

git clone https://github.com/AnastasiyaW/knowledge-space.git
cd knowledge-space

AI 에이전트와 함께 사용

이 지식 베이스는 AI 에이전트에 컨텍스트로 제공되도록 설계되었습니다. 에이전트는 관련 문서를 참조하여 질문에 답하거나 문제를 해결할 수 있습니다.

문서 구조

각 문서는 일반적으로 다음 섹션을 포함합니다:

• 개요: 주제에 대한 간략한 소개
• 핵심 개념: 이해해야 할 가장 중요한 아이디어
• gotchas: 개발자가 자주 저지르는 실수와 이를 피하는 방법
• 예제: 바로 사용할 수 있는 실용적인 코드 조각
• 참조: 관련 문서나 외부 자료로의 링크

예시: Python 문서

python/async-await.md 문서는 다음과 같은 내용을 포함할 수 있습니다:

async/await 기초

• Python 3.5+에서 도입된 async/await 구문은 동시성 코드를 작성하는 방법입니다.
• async def 함수는 코루틴(coroutine)을 정의합니다.
• await는 코루틴 내에서만 사용 가능하며, 다른 코루틴의 완료를 기다립니다.

Gotcha: await를 동기 함수 내에서 사용하면 SyntaxError가 발생합니다. Gotcha: asyncio.run()과 asyncio.create_task()의 차이를 혼동하지 마세요.

import asyncio

async def say_hello():
    await asyncio.sleep(1)
    print("Hello, world!")

async def main():
    await say_hello()

asyncio.run(main())

기여하기

커뮤니티의 기여를 환영합니다. 새로운 문서를 추가하거나 기존 문서를 개선하려면 저장소의 기여 가이드라인을 참조하세요.

라이선스

자세한 내용은 저장소의 LICENSE 파일을 참조하세요.

---

이 스킬은 AI 에이전트가 knowledge-space 지식 베이스를 활용하여 개발 작업을 보다 효율적으로 수행할 수 있도록 지원합니다.