ContextGeneration

分类: 工具与效率 | 上传者: qurugi0347 | 下载: 0 | 版本: v1.0（最新）

通过分析 PR 变化自动生成 .claude/context/ 文档的规则

更新日志: Source: GitHub https://github.com/qurugi0347/jun-claude-code

目录结构

当前层级: tree/main/.claude/skills/ContextGeneration/

📄 SKILL.md 3.7 KB

SKILL.md

---
name: ContextGeneration
description: PR 변경 내용을 분석하여 .claude/context/ 문서를 자동 생성하는 규칙
keywords: [context, codebase, business, PR, 자동생성, 문서화]
estimated_tokens: ~800
---

# Context 자동 생성 규칙

PR 변경 내용을 분석하여 `.claude/context/` 하위에 codebase/business 문서를 자동 생성합니다.

## Context 디렉토리 구조

```
.claude/context/
├── codebase/
│   ├── INDEX.md          # 모듈 목록 + 경로
│   └── <module-name>.md  # 모듈별 구현 참조
└── business/
    ├── INDEX.md          # 프로젝트 개요 + 도메인 목록
    └── <domain-area>.md  # 비즈니스 레벨 요약
```

<rules>

## Codebase Context 규칙

### 파일명
- **kebab-case** 사용 (예: `cli.md`, `copy-logic.md`, `auth-middleware.md`)
- 모듈/기능 단위로 분리

### 필수 섹션

```markdown
---
name: <모듈명>
description: <한 줄 설명>
keywords: [관련, 키워드]
---

# <모듈명>

<2-3문장 개요>

## 파일 구조

| 파일 | 역할 | 핵심 함수/클래스 |
|------|------|-----------------|
| src/example.ts | 메인 로직 | mainFunction(), HelperClass |

## 핵심 흐름

1. <진입점> → <처리> → <결과>
2. ...

## 관련 Business Context

- [<도메인명>](../business/<domain>.md)
```

### 참조 원칙

- 파일 경로와 함수/클래스명만 참조한다
- 파일 참조 형식: `| src/copy.ts | 파일 복사 메인 로직 | mergeSettingsJson() |`
- 원본 소스 코드 대신 경로와 함수 시그니처로 표현한다

## Business Context 규칙

### 파일명
- **비즈니스 도메인 기준**으로 명명한다 (예: `configuration-management.md`, `user-authentication.md`)
- 비즈니스 용어를 사용한다 (예: `settings-json-merge.md` -> `configuration-management.md`)

### 필수 섹션

```markdown
---
name: <도메인명>
description: <비즈니스 관점 한 줄 설명>
keywords: [비즈니스, 키워드]
---

# <도메인명>

## 목적

<이 기능이 사용자에게 제공하는 가치>

## 핵심 기능

| 기능 | 설명 | 사용자 관점 |
|------|------|------------|
| 설정 복사 | 템플릿 설정을 사용자 환경에 적용 | 초기 설정 자동화 |

## 사용자 흐름

1. 사용자가 <동작> → <결과>
2. ...

## 관련 Codebase Context

- [<모듈명>](../codebase/<module>.md)
```

### 변환 규칙
- Codebase의 기술 용어를 비즈니스 관점으로 변환한다
  - `mergeSettingsJson()` -> "기존 설정을 보존하면서 새 설정 적용"
  - `copyClaudeFiles()` -> "템플릿 설정을 사용자 환경에 배포"

</rules>

## INDEX.md 작성 규칙

### codebase/INDEX.md

```markdown
---
name: Codebase Index
description: 코드베이스 모듈 참조 목록
---

# Codebase Context Index

## 모듈 목록

| 모듈 | 설명 | 문서 |
|------|------|------|
| CLI | 커맨드라인 인터페이스 | [cli.md](./cli.md) |
```

### business/INDEX.md

```markdown
---
name: Business Index
description: 비즈니스 도메인 참조 목록
---

# Business Context Index

## 프로젝트 개요

<프로젝트가 해결하는 문제와 대상 사용자 1-2문장>

## 도메인 목록

| 도메인 | 설명 | 문서 |
|--------|------|------|
| 설정 관리 | 사용자 설정 배포 및 관리 | [configuration-management.md](./configuration-management.md) |
```

## 증분 업데이트 원칙

<checklist>

- PR에서 변경된 파일과 관련된 context 문서만 업데이트한다
- 기존 문서의 변경되지 않은 부분은 그대로 유지한다
- 새 모듈이 추가되면 INDEX.md에 행을 추가한다
- 모듈이 삭제되면 INDEX.md에서 해당 행을 제거하고 문서 파일을 삭제한다

</checklist>

登录后下载/点赞/收藏 ❤ 5 | ★ 0

ContextGeneration

目录结构

SKILL.md

举报内容

提示