Back to Details

kc-init

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

새 프로젝트 초기화하기

新项目初始化

새 프로젝트에서 한 번만 사용한다. 별도 질문 없이 바로 작업 기반을 준비한다.
仅在新项目中使用一次。无需额外询问，直接准备工作基础。

진행

流程

대상 확인

确认目标

  1. 대상 폴더가 새 프로젝트용이며 실질적으로 비어 있는지 확인한다. 운영체제 메타데이터와 빈 Git 저장소는 허용한다.
  2. 기존 코드나 프로젝트 설정이 있으면 초기화하지 않고 기존 프로젝트임을 보고한다.
  3. 대상 폴더가 불명확하면 정확한 위치만 확인한다.
  1. 确认目标文件夹是用于新项目且实际为空。允许包含操作系统元数据和空Git仓库。
  2. 若存在已有代码或项目配置，则不进行初始化，而是报告该文件夹为现有项目。
  3. 若目标文件夹不明确，则仅确认准确位置。

초기화

初始化

  1. .gitignore
    를 만들고 비밀값, 환경 파일, 의존성, 빌드 결과와 도구 캐시를 제외한다.
  2. AGENTS.md 템플릿을 사용해 비개발 도메인 전문가와 협업할 공통 지침을 만든다. 기술 구성과 실행 명령이 아직 정해지지 않았다면 임의로 선택하지 않고 미정 상태를 기록한다.
  3. 사용자가 기술 구성이나 제품 자료를 함께 제공했다면 프로젝트 환경 원칙에 따라 필요한 실행 기반을 구성하고 실제 프로젝트 명령을 AGENTS.md에 반영한다.
  4. CLAUDE.md 템플릿을 사용해 
    AGENTS.md
    를 불러온다. Claude Code만의 프로젝트 규칙이 있을 때만 그 아래에 추가한다.
  5. Git 저장소가 없으면 초기화하고, 이미 빈 저장소가 있으면 유지한다. 작성자 정보가 없어 최초 저장점을 만들 수 없으면 임의로 설정하지 말고 알려준다.
  6. 초기화만을 위해 외부 프로젝트를 생성·연결·업로드·배포하지 않는다.
  7. 실행 기반을 구성한 경우에만 설치와 기본 실행 또는 빌드를 확인한다.
  8. 생성 파일을 확인하고 가능하면 최초 Git 저장점을 만든다.
  1. 创建
    .gitignore
    文件，排除密钥、环境文件、依赖项、构建结果及工具缓存。
  2. 使用AGENTS.md模板创建与非开发领域专家协作的通用指南。若技术架构和执行命令尚未确定，请勿随意选择，需记录为待定状态。
  3. 若用户同时提供了技术架构或产品资料，则根据项目环境原则构建所需的执行基础，并将实际项目命令反映到AGENTS.md中。
  4. 使用CLAUDE.md模板导入
    AGENTS.md
    。仅当存在Claude Code专属的项目规则时，才在其下方添加相关内容。
  5. 若不存在Git仓库则进行初始化，若已有空仓库则保留。若因缺少作者信息无法创建初始提交，请不要随意设置，需告知用户。
  6. 不得为仅初始化操作而创建、连接、上传或部署外部项目。
  7. 仅在构建了执行基础的情况下，才确认安装、基础运行或构建操作。
  8. 检查生成的文件，尽可能创建初始Git提交。

완료

完成

생성한 프로젝트 지침, Git 상태, 구성한 경우에만 실행 기반과 확인한 명령을 보고한다.
报告生成的项目指南、Git状态，若构建了执行基础则同时报告执行基础及已确认的命令。