클로드 코드 얼티밋 가이드

source-command-audit-prose

사용자가 마이그레이션된 소스 명령어 audit-prose를 실행하도록 요청할 때 이 스킬을 사용하세요.

명령어 템플릿

Audit Prose — 베어 섹션 보강

화이트페이퍼의 각 '베어' 섹션 앞에 설명적인 산문(2-4문장)을 추가합니다. '베어' 섹션 = 헤딩 바로 다음에 테이블, 코드 블록, 또는 목록이 오고 도입 단락이 없는 경우.

사용법

/audit-prose        # 모든 WP (00-08), FR + EN
/audit-prose 07     # WP07만 (FR + EN)
/audit-prose 03 07  # WP03과 WP07만

'베어 섹션' 정의

## 또는 ### 섹션이 바로 다음에 오는 경우:

• 마크다운 테이블 (|)
• 코드 블록 (```)
• 글머리 기호 목록 (-) 또는 번호 목록

도입 단락(최소 2문장) 없음.

엄격한 규칙 (협상 불가)

1. 절대 글머리 목록 앞에 단락을 :로 끝내지 마세요 → Typst 버그로 글머리가 인라인으로 합쳐집니다.
2. 숫자, 메트릭, 인용구를 지어내지 마세요.
3. 콜아웃(:::), Mermaid, 또는 페르소나 시나리오를 추가하지 마세요.
4. 파일당 라인 수를 15% 이상 초과하지 마세요.
5. 유지되는 버전: 3.27.6
6. 영어 산문 = 자연스러운 영어, 프랑스어의 직역이 아님.
7. 각 추가사항 = 최소 2문장, 최대 4문장

변환 예시

변경 전:
### 종료 코드
| 코드 | 의미      |
|------|-----------|
| 0    | 허용됨    |

변경 후:
### 종료 코드
훅은 표준화된 종료 코드를 통해 Codex와 통신합니다.
이 메커니즘은 사람의 개입 없이 실시간으로 작업을 차단하거나 허용할 수 있게 해줍니다.

| 코드 | 의미      |
|------|-----------|
| 0    | 허용됨    |

워크플로우: 9개의 병렬 에이전트

컨텍스트 소스

• machine-readable/reference.yaml: 주제 → 메인 가이드 라인 매핑
• guide/ultimate-guide.md: 참조 가이드 (reference.yaml에 표시된 라인)
• Codex 지식 (v3.27.6, MCP, 훅, 에이전트 팀 등)

WP 매핑

#	FR	EN	~베어 섹션 수
00	whitepapers/fr/00-introduction-serie.qmd	whitepapers/en/00-series-introduction.qmd	~10
01	whitepapers/fr/01-prompts-efficaces.qmd	whitepapers/en/01-effective-prompts.qmd	~14
02	whitepapers/fr/02-personnalisation.qmd	whitepapers/en/02-customization.qmd	~18
03	whitepapers/fr/03-securite.qmd	whitepapers/en/03-security.qmd	~20
04	whitepapers/fr/04-architecture.qmd	whitepapers/en/04-architecture.qmd	~14
05	whitepapers/fr/05-equipe.qmd	whitepapers/en/05-team.qmd	~20
06	whitepapers/fr/06-privacy.qmd	whitepapers/en/06-privacy.qmd	~12
07	whitepapers/fr/07-guide-reference.qmd	whitepapers/en/07-reference-guide.qmd	~36
08	whitepapers/fr/08-agent-teams.qmd	whitepapers/en/08-agent-teams.qmd	~16

실행

인수가 특정 WP 번호인 경우: 해당 FR/EN 쌍에 대해서만 에이전트 1개를 실행합니다.

인수가 없거나 (또는 "all"): audit-prose-{날짜} 팀을 생성하고 9개의 에이전트를 병렬로 실행합니다.

대상 WP 각각에 대해 다음 프롬프트로 에이전트를 실행합니다:

당신은 시니어 기술 편집자입니다. 임무: 화이트페이퍼 [XX - 제목]의 '베어' 섹션에 설명적인 산문을 추가하는 것입니다.

## '베어 섹션' 정의
`##` 또는 `###` 섹션이 바로 다음에 테이블, 코드 블록, 또는 글머리 목록이 오고 도입 단락(2+문장)이 없는 경우.

## 수행할 작업
식별된 각 베어 섹션에 대해:
1. 구조화된 내용 앞에 2-4문장을 추가합니다.
2. 각 문장은 새로운 정보를 제공합니다: 이유, 사용 시기, 의미, 디자인 선택, 또는 실용적인 컨텍스트.
3. 뒤에 오는 내용을 바꾸어 말하지 말고 — 누락된 컨텍스트로 보완하세요.

## 컨텍스트 소스
- `machine-readable/reference.yaml`: 주제 → 메인 가이드 전체 매핑
- Codex 지식 (v3.27.6, MCP, 훅, 에이전트 팀 등)

## 엄격한 규칙
- 숫자, 메트릭, 인용구를 지어내지 마세요.
- 콜아웃 (:::), Mermaid, 또는 페르소나 시나리오를 추가하지 마세요.
- 글머리 목록 앞에 단락을 ":"로 끝내지 마세요 (Typst 버그).
- 라인 수를 15% 이상 초과하지 마세요.
- 버전을 3.27.6으로 유지하세요.
- 영어 산문 = 자연스러운 영어, 직역 금지.
- 각 추가사항 = 최소 2문장, 최대 4문장.

## 프로세스
1. reference.yaml 읽기 (WP 관련 섹션)
2. 전체 FR WP 읽기
3. 모든 베어 섹션 식별
4. FR 파일 편집 (Edit 도구, 섹션별로)
5. 전체 EN WP 읽기
6. EN 파일 편집
7. 확인: 어떤 단락도 목록 앞에 ":"로 끝나지 않음
8. 보고: 처리된 섹션 수, FR/EN 라인 델타

대기 및 보고

모든 에이전트의 응답을 기다립니다. 각 완료된 WP에 대해 다음을 표시:

WP[XX] ✅ — [N] sections, +[X]% FR/EN

종료

모든 에이전트가 완료되면 각각에 shutdown_request를 보낸 다음 TeamDelete를 수행합니다.

보강 후 검증

# 1. 라인 델타 (최대 +15%)
for f in whitepapers/fr/*.qmd; do
  echo "$(wc -l < "$f") $(basename $f)"
done

# 2. Typst 버그 확인: 목록 앞에 ":"로 끝나는 단락
grep -n ':$' whitepapers/fr/*.qmd whitepapers/en/*.qmd | head -20

# 3. 버전 유지 확인
grep "^version:" whitepapers/fr/*.qmd whitepapers/en/*.qmd

# 4. PDF 재빌드
for f in whitepapers/fr/*.qmd whitepapers/en/*.qmd; do
  quarto render "$f"
done

WP별 라인 예산

WP	최대 FR 예산	최대 EN 예산
00	+54 라인	+54 라인
01	+142 라인	+142 라인
02	+189 라인	+189 라인
03	+145 라인	+145 라인
04	+120 라인	+120 라인
05	+143 라인	+143 라인
06	+79 라인	+79 라인
07	+281 라인	+281 라인
08	+241 라인	+241 라인