위키 업데이트 스킬
위키 페이지의 수동 작성 산문 섹션을 코드베이스의 현재 상태를 반영하도록 새로 고칩니다. 생성된 메트릭/데이터 블록은 오케스트레이터가 관리하므로 절대 건드리지 않아야 합니다.
호출 시점
- 사용자가
/update-wiki를 입력 — 모든 산문이 포함된 페이지 업데이트 - 사용자가
/update-wiki Architecture를 입력 —wiki/Architecture.md만 업데이트 - 사용자가 "위키 산문 새로 고침", "온보딩 설명 업데이트", "아키텍처 문서 다시 작성"이라고 말할 때
- 시스템 설계 개요를 변경하는 중요한 리팩터링 후
이 스킬이 수행하는 작업 (단계별)
-
범위 결정. 페이지 이름 인자가 제공된 경우(예:
Architecture),wiki/{PageName}.md로 변환합니다. 그렇지 않으면 아래 나열된 모든 산문이 포함된 페이지를 큐에 넣습니다. -
각 대상 페이지에 대해: a. 위키 페이지 파일을 읽습니다. b. 모든
<!-- claude:prose -->...<!-- claude:prose:end -->블록을 식별합니다. c. 아래 페이지 레지스트리에 나열된 관련 소스 파일을 읽어 컨텍스트를 구축합니다. d. 마커 사이의 콘텐츠를 현재 코드베이스를 정확히 반영하도록 다시 작성합니다 — 일반적인 구조(제목, 단락 순서)는 사실적으로 틀리지 않는 한 유지합니다. e. 업데이트된 콘텐츠를 마커를 정확히 보존한 채 파일에 다시 씁니다. -
생성된 블록은 절대 건드리지 않음.
<!-- generated:start -->...<!-- generated:end -->내부의 콘텐츠는 바이트 단위로 동일하게 남겨두어야 합니다. 이 블록은 위키 오케스트레이터 스크립트가 유지 관리합니다. -
아키텍처 결정 로그는 전적으로 클로드 소유.
wiki/Architecture-Decision-Log.md에는generated블록도claude:prose마커도 없습니다. 클로드가 전체 파일을 유지 관리합니다. 업데이트 시 마지막으로 기록된 항목 이후의 아키텍처 결정에 대한 새 ADL 항목을 추가합니다. 기존 항목은 수정하지 마십시오. -
커밋 프롬프트. 모든 페이지가 업데이트된 후 사용자에게 상기시킵니다:
"위키 산문이 업데이트되었습니다. 변경 사항을 저장하려면
/commit을 실행한 다음 위키 원격 저장소에 푸시하세요."
산문이 포함된 페이지 및 해당 소스 파일
wiki/Architecture.md
산문 블록 목적: 시스템 설계 개요 — 모듈 책임, 데이터 흐름, 정적 사이트와 Lambda 채팅 에이전트가 어떻게 함께 작동하는지 설명합니다.
읽을 관련 소스 파일:
WebContent/js/main.jsWebContent/js/filter.jsWebContent/js/carousel.jsWebContent/js/utils.jslambda/lambda_function.pyindex.html(페이지 구조 컨텍스트용)projects.html(페이지 구조 컨텍스트용)
wiki/Lambda-Chat-Agent.md
산문 블록 목적: 에이전트 설계 근거 — Lambda 아키텍처, 지식 기반 로딩, 프롬프트 구성, 응답 처리를 설명합니다.
읽을 관련 소스 파일:
lambda/lambda_function.pylambda/context/(존재하는 경우 모든.md파일)
wiki/Contributing.md
산문 블록 목적: 온보딩 개요 — 새 기여자를 위한 개발 워크플로, 테스트 철학, 프로젝트 규칙을 설명합니다.
읽을 관련 소스 파일:
CLAUDE.mdMakefilepackage.jsonpyproject.toml.github/workflows/ci-cd.yml
wiki/Architecture-Decision-Log.md
특별 처리: claude:prose 마커가 없습니다. 클로드가 전체 파일을 소유합니다. 새 ADL 항목을 추가하고 기존 항목은 절대 수정하지 마십시오.
읽을 관련 소스 파일:
- 최근 git 로그에서 중요한 아키텍처 변경 검토
CLAUDE.md— 현재 도구 결정 사항 확인lambda/lambda_function.py— 백엔드 결정 사항 확인
마커 보존 규칙
<!-- claude:prose -->
[클로드가 이 콘텐츠를 다시 작성]
<!-- claude:prose:end -->
<!-- generated:start -->
[절대 건드리지 않음 — 오케스트레이터 관리 데이터]
<!-- generated:end -->
- 여는 마커와 닫는 마커는 각각 고유한 줄에 있어야 하며 변경되지 않습니다.
- 마커 내부에 추가 빈 줄을 넣지 마십시오.
- 마커를 중첩하지 마십시오.
경고
<!-- generated:start --> ... <!-- generated:end --> 블록을 절대 수정하지 마십시오. 이 블록에는 위키 오케스트레이터가 생성한 자동 생성 메트릭과 테이블이 포함되어 있습니다. 이를 수정하면 다음 오케스트레이터 실행 시 병합 충돌이 발생하거나 변경 사항이 자동으로 덮어쓰여질 수 있습니다.