스킬 planning-with-files
📦

planning-with-files

안전 ⚙️ 외부 명령어

지속성 파일을 사용한 복잡한 작업 계획

또한 다음에서 사용할 수 있습니다: OthmanAdi,ZhanlinCui,AmmarCodes

긴 AI 세션은 컨텍스트 손실과 목표 망각을 초래합니다. 이 스킬은 마크다운 파일을 외부 메모리로 사용하여 무제한 도구 호출에 걸쳐 작업 상태를 유지합니다.

지원: Claude Codex Code(CC)
🥈 77 실버
1

스킬 ZIP 다운로드

2

Claude에서 업로드

설정 → 기능 → 스킬 → 스킬 업로드로 이동

3

토글을 켜고 사용 시작

테스트해 보기

"planning-with-files" 사용 중입니다. add, list, delete 명령을 사용하는 Python CLI todo 앱에 대한 계획 초기화

예상 결과:

  • 5 개의 단계 (Requirements, Planning, Implementation, Testing, Delivery) 가 포함된 task_plan.md 생성
  • requirements, research, technical decisions 섹션이 포함된 findings.md 생성
  • 세션 타임스탬프와 초기 상태가 포함된 progress.md 생성

"planning-with-files" 사용 중입니다. 오류 기록: config.json 읽기 시 FileNotFoundError 발생

예상 결과:

  • Errors Encountered 표에 추가: FileNotFoundError, 시도 1, 해결 방법: 기본 설정 파일 생성
  • 타임스탬프와 함께 progress.md 오류 로그 업데이트
  • 오류가 해결될 때까지 단계 상태는 in_progress 로 유지

보안 감사

안전
v1 • 2/24/2026

All static analysis findings were evaluated and determined to be false positives. The shell command patterns detected are from markdown documentation code blocks and legitimate bash helper scripts that only perform file operations. No cryptographic code, network exfiltration, or credential access exists. This is a safe productivity skill for planning complex tasks using persistent markdown files.

8
스캔된 파일
1,146
분석된 줄 수
1
발견 사항
1
총 감사 수
감사자: claude

품질 점수

59
아키텍처
100
유지보수성
87
콘텐츠
33
커뮤니티
100
보안
91
사양 준수

만들 수 있는 것

다단계 개발 프로젝트

단계 추적, 오류 로깅, 결정 문서를 통해 50 회 이상의 도구 호출에 걸쳐 복잡한 코딩 작업을 추적합니다.

연구 및 문서화

컨텍스트가 손실되기 전에 웹 검색 결과, 브라우저 결과, 소스 자료를 구조화된 마크다운으로 캡처합니다.

시스템 탐색 및 디버깅

익숙하지 않은 코드베이스를 탐색하거나 문제를 디버깅할 때 발견 사항, 실패한 시도, 해결 방법을 문서화합니다.

이 프롬프트를 사용해 보세요

계획 세션 초기화
프로젝트 디렉토리에 task_plan.md, findings.md, progress.md 파일을 생성하세요. 목표는: [작업 목표 설명]. 요구사항 수집을 위한 Phase 1 로 시작합니다.
버그 수정 진행 상황 추적
task_plan.md 를 읽고 현재 단계 상태를 업데이트하세요. 발생한 오류를 기록합니다: [오류 붙여넣기]. Errors Encountered 표에 근본 원인과 시도한 수정 사항을 문서화합니다.
연구 결과 캡처
[주제] 에 대해 웹 검색을 두 번 완료했습니다. findings.md 를 주요 발견 사항, 관련 URL, 그리고 이 연구를 바탕으로 내린 기술적 결정과 함께 업데이트하세요.
단계 완료 및 검토
task_plan.md 에서 Phase [X] 를 완료로 표시합니다. 수행된 작업, 생성되거나 수정된 파일을 요약하고, progress.md 를 테스트 결과와 함께 업데이트합니다. 그런 다음 Phase [X+1] 을 in_progress 로 설정합니다.

모범 사례

  • 3 단계 이상의 복잡한 작업을 시작하기 전에 세 개의 계획 파일을 모두 생성
  • 주요 결정을 내리기 전에 task_plan.md 를 읽고 목표를 주의 깊게 확인
  • view 또는 browser 작업을 2 회 수행할 때마다 즉시 findings.md 업데이트
  • 반복을 방지하기 위해 발생한 모든 오류를 기록 (빨리 해결되었더라도)
  • 단계 상태 변경을 명시적으로 표시: pending → in_progress → complete

피하기

  • task_plan.md 파일을 먼저 생성하지 않고 실행 시작
  • 오류를 기록하지 않고 조용히 재시도
  • 접근 방식을 변경하지 않고 동일한 실패한 작업을 반복
  • 프로젝트 디렉토리 대신 스킬 디렉토리에 계획 파일 생성
  • 파일 기반 저장소 대신 TodoWrite 를 지속성에 사용

자주 묻는 질문

계획 파일을 어디에 생성해야 하나요?
task_plan.md, findings.md, progress.md 를 스킬 설치 폴더가 아닌 작업 중인 프로젝트 디렉토리에 생성하세요. 이렇게 하면 계획 파일이 코드와 함께 유지됩니다.
계획 파일은 언제 업데이트해야 하나요?
각 단계가 완료될 때마다 task_plan.md 를 업데이트하세요. view 또는 browser 작업을 2 회 수행할 때마다 findings.md 를 업데이트하세요. 세션 전반에 걸쳐 작업이 완료될 때마다 progress.md 를 업데이트하세요.
2-Action 규칙이란 무엇인가요?
view, browser, search 작업을 2 회 수행할 때마다 즉시 주요 발견 사항을 findings.md 에 작성하세요. 이렇게 하면 컨텍스트가 재설정될 때 시각적 또는 다중 모드 정보가 손실되는 것을 방지합니다.
이 스킬로 오류를 어떻게 처리하나요?
모든 오류를 시도 번호와 해결 방법과 함께 Errors Encountered 표에 기록하세요. 동일한 실패한 작업을 반복하지 마세요. 3 회 실패 후, 시도한 내용과 함께 사용자에게 에스컬레이션하세요.
간단한 작업에도 사용할 수 있나요?
단순한 질문, 단일 파일 수정, 빠른 조회의 경우 계획 파일을 건너뛰세요. 3 단계 이상의 작업, 연구 프로젝트 또는 많은 도구 호출에 걸쳐 조직화가 필요한 작업에 이 패턴을 사용하세요.
셸 스크립트는 무엇을 위한 것인가요?
init-session.sh 는 템플릿 내용으로 세 개의 계획 파일을 모두 생성합니다. check-complete.sh 는 task_plan.md 의 모든 단계가 complete 로 표시되었는지 확인합니다. 둘 다 자동화를 위한 선택적 헬퍼입니다.

개발자 세부 정보