파일 기반 작업 계획 시스템 (중국어판)
task_plan.md·findings.md·progress.md 세 파일로 복잡한 다단계 작업의 계획과 진행 상황을 디스크에 영구 저장하는 스킬입니다.
자동화·워크플로중급★ 26,060⑂ 2,177AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
Manus 스타일의 '파일=외부 기억장치' 패턴을 Claude Code에 이식한 스킬입니다. 복잡한 작업을 시작하기 전에 다음 세 파일을 프로젝트 루트에 만들고 계속 갱신합니다.
| 파일 | 역할 |
|------|------|
| task_plan.md | 단계(Phase)·상태·주요 결정 |
| findings.md | 조사·검색 결과 등 발견 사항 |
| progress.md | 세션 로그, 테스트 결과 |
또한 UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact 훅을 등록해 매 도구 호출 전에 계획을 다시 컨텍스트에 주입하고, /clear 이후에도 session-catchup.py로 이전 세션 맥락을 복원합니다. '3회 실패 프로토콜', '읽기 vs 쓰기 결정 매트릭스', 외부 웹 내용은 findings.md에만 쓰라는 프롬프트 인젝션 방어 규칙까지 문서화되어 있습니다. 문서 본문은 중국어(간체)입니다.
이런 분께 추천
- 도구 호출이 5회 이상 필요한 리팩터링·리서치를 자주 돌리는 분
- 대화가 길어지면 Claude가 초기 목표를 잊는 문제를 겪은 분
/clear나 컴팩션 이후에도 작업 맥락을 이어가고 싶은 분- 중국어 인터페이스로 계획 문서를 관리하고 싶은 팀
활용 예시
- 레거시 모듈 리팩터링: "이 결제 모듈을 단계별로 나눠서 리팩터링해줘"라고 하면 6단계
task_plan.md를 만들고 각 단계 완료마다 상태를complete로 바꾸며 발생한 에러를 표로 기록합니다. - 경쟁 서비스 리서치: 웹 검색 2회마다 핵심 내용을
findings.md에 저장해 컨텍스트가 잘려도 조사 결과가 남습니다. - 중단 후 재개: 다음 날 세션을 열면
session-catchup.py와git diff --stat로 미반영 변경을 감지해 계획 파일을 최신화한 뒤 이어서 작업합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 OthmanAdi/planning-with-files 의 skills/planning-with-files-zh 폴더를 내 ~/.claude/skills/planning-with-files-zh/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files && cp -r /tmp/planning-with-files/skills/planning-with-files-zh ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/OthmanAdi/planning-with-files.git - 스킬 폴더를 복사합니다:
cp -r planning-with-files/skills/planning-with-files-zh ~/.claude/skills/ - 스크립트에 실행 권한을 줍니다:
chmod +x ~/.claude/skills/planning-with-files-zh/scripts/*.sh - 파이썬이 있는지 확인합니다:
python3 --version(세션 복원 스크립트에 필요) - Claude Code를 재시작한 뒤 "이 프로젝트 작업을 단계별로 계획해줘" 같이 요청하면 스킬이 실행됩니다.
- 설치 경로가 표준과 다르면
export PWF_SCRIPT_DIR=~/.claude/skills/planning-with-files-zh/scripts를 셸 설정에 추가하세요. - 훅이 매 프롬프트마다 셸 명령을 실행하므로, 회사 보안 정책이 있다면 사전에 스크립트 내용을 확인하세요.
GitHub에서 원본 보기 ↗라이선스: MIT