Community생산성 & 협업github.com

BattlePlan

작업 추적기(로컬 CSV, Excel 워크북 또는 Google 시트)로부터 일일 실행 계획을 생성합니다. 작업을 컨텍스트 및 하위 컨텍스트별로 그룹화하고, 시간을 추정하며, 병렬 스레드를 찾고, 각 스레드별로 바로 붙여넣을 수 있는 시작 프롬프트를 작성합니다. 빈 상태가 아닌 어제의 상태에서 시작하여 이전 에이전트 세션과 Git 커밋을 요약하고, 감사를 미리 채우며, 재개 명령을 제공합니다. 하루 마무리(--close), 무인 아침 초안(--draft), 작업 관리(add, done, cancel, restore, sweep, batch import) 기능을 포함합니다. 사용 시점: 내 하루 계획, 일일 계획, 배틀플랜, 무엇을 작업할지, 하루 마무리, 업무 인수인계, 아침 초안, 작업 개요, 스탠드업 준비, 작업 우선순위 지정, 작업 추가, 작업 완료 표시, 배틀플랜 설정, 작업 추적기 구성.

BattlePlan란 무엇인가요?

BattlePlan은 작업 추적기(CSV, XLSX, Google Sheets)에서 열린 작업을 읽어 병렬 실행 가능한 작업 스레드로 구성하고 각 스레드마다 새로운 에이전트 세션에서 바로 사용할 수 있는 시작 프롬프트를 생성하는 AI 에이전트 스킬입니다. Claude Code 환경에 최적화되어 있으며, uv와 Git을 종속성으로 사용합니다. 이 스킬의 핵심 특징은 '어제의 상태'에서 시작한다는 점입니다: 이전 세션과 Git 커밋을 자동으로 요약하여 작업 계획이 항상 최신 컨텍스트를 반영합니다. 하루가 끝나면 --close 명령어로 핸드오프 파일을 생성하고, 아침에는 --draft 명령어로 무인 초안을 작성하며, /BattlePlan 명령어로 최종 실행 계획을 확정합니다. 다중 머신을 지원하며 Git 기반 동기화, 기밀 컨텍스트 처리, 작업 관리(추가, 완료, 취소, 복원, 스윕, 일괄 가져오기) 등 강력한 기능을 제공합니다. 모든 작업은 사람의 확인을 거쳐야 하며, 감사 제안은 자동이지만 실제 작업 완료는 수동 확인이 필요합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juanmherrerav/agent-workday-skills/tree/main/skills/BattlePlan

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

BattlePlan은(는) 무엇을 하나요?

작업 추적기에서 모든 열린 작업을 읽고, 마지막 계획 이후 실제로 발생한 일과 비교하여 조정한 후, 각각 새로운 에이전트 세션에서 바로 사용할 수 있는 시작 프롬프트를 포함한 짧은 병렬 작업 스레드 목록으로 변환합니다.

0단계 — 모든 호출은 여기서 시작

BP="${SKILLS_HOME:-$HOME/.claude/skills}/BattlePlan/Tools"
uv run --script "$BP/setup_tracker.py" check
  • success: false 또는 설정 없음 → Workflows/Setup.md를 먼저 실행하세요. 추적기, 탭 이름 또는 컨텍스트를 임의로 만들지 마십시오.
  • 설정 파일 위치는 $BATTLEPLAN_CONFIG 환경 변수에 저장되며, 그렇지 않은 경우 ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/BattlePlan/config.json에 있습니다. 설정 파일은 소유자, 추적기 백엔드, 계획 디렉터리 및 컨텍스트 계층 구조를 보관합니다. 스킬 디렉터리에는 개인 데이터가 절대 저장되지 않으므로 자유롭게 공유하고 업데이트할 수 있습니다.

라우팅

호출워크플로우
"배틀플랜 설정", 설정 없음, 새 추적기, 새 컨텍스트Workflows/Setup.md
/BattlePlan [컨텍스트] [--mine] [--skip-audit] [--launch], --auditWorkflows/Plan.md
/BattlePlan --closeWorkflows/Close.md
/BattlePlan --draft (무인), 초안 예약Workflows/Draft.md
--add, --done, --cancel, --restore, --sweep, batch-add, 티켓 또는 회의에서 작업 가져오기Workflows/Tasks.md

하루 루프

 저녁                     예약 (평일)          아침
 /BattlePlan --close  ──▶   /BattlePlan --draft   ──▶   /BattlePlan
 완료, 스레드별 다음 단계,     추적기 + 핸드오프 +        초안을 열고; 예외 사항만
 재개 명령어                세션 읽기; 초안 작성        확인한 후 진행

각 단계는 이전 단계가 건너뛰어도 작동합니다: 핸드오프 없음 → 요약이 이전 근무일로 대체됨; 초안 없음 → /BattlePlan이 실시간으로 계획을 수립합니다. 파일은 plans_dir 디렉터리에 저장됩니다:

파일작성자내용
YYYY-MM-DD-handoff-<호스트>.md--close첫 줄 Closed: <ISO 8601 오프셋 포함> on <호스트>, 그 다음 완료, 진행 중(다음 단계 + 재개 명령어), 이월 항목
YYYY-MM-DD-draft-<호스트>.md--draft계획 및 미리 채워진 감사 제안; 추적기에는 아무것도 기록되지 않음
YYYY-MM-DD-plan.md/BattlePlan확정된 계획으로, --close가 계획과 실제 결과를 비교할 수 있게 함

<호스트>는 별칭(mac, wsl, linux 또는 $BATTLEPLAN_HOST_ALIAS)이며, 호스트 이름이 아닙니다. 이러한 파일은 여러 머신에서 공유될 수 있기 때문입니다. 세션 ID는 해당 세션을 생성한 머신에서만 재개됩니다: 다른 호스트의 다음 단계는 표시하되, 재개 명령어는 절대 표시하지 마십시오.

다중 머신: plans_git_sync: true를 설정하고 plans_dir을 Git 저장소 안에 배치하십시오. 커밋은 방금 작성된 파일만 수정합니다(git commit -- <경로>). fetch + merge --ff-only 후에 실행합니다. stash, reset 또는 clean을 절대 사용하지 마십시오: 다른 세션이 해당 저장소에서 커밋되지 않은 작업을 보유할 수 있습니다. fast-forward가 실패하면 로컬에서 커밋하고 푸시가 보류 중이라고 알리십시오.

도구

스크립트역할
`setup_tracker.py checkinit`
pull_tasks.py [컨텍스트] [--mine]계산된 긴급도, 마감일, 소유자 유형, 종속성, 티켓과 함께 JSON 형식의 열린 작업
recap_sessions.py --tasks pull.json [--since auto] [--context X]마지막 핸드오프 이후의 에이전트 세션 + Git 커밋을 티켓 ID별로 작업에 연결
`manage_tasks.py addbatch-add
`run_draft.sh --install--check
tracker.py스토리지 백엔드(csv, xlsx, gsheets) 및 설정 로딩; 다른 스크립트에서 임포트됨

모든 스크립트는 uv run --script 파일이며 인라인 종속성(PEP 723)을 포함합니다: 관리할 virtualenv가 없습니다. 테스트: uv run --with pytest --with openpyxl pytest tests/.

필수 준수 사항

  • 요약은 제안하며, 사람이 확인합니다. 증거만으로 완료로 표시되는 작업은 없습니다.
  • 쓰기 작업에 정확한 행 참조 사용. 가져오기 후에는 Tab!row 참조를 사용하여 하나의 batch-done 호출로 보관; 행을 알고 있을 때 부분 문자열 검색으로 대체하지 마십시오.
  • 기밀 컨텍스트 ("confidential": true)는 추적기와 핸드오프 모두에서 티켓 ID와 짧은 일반 요약만 포함합니다. manage_tasks.py는 IP, URL 및 컨텍스트의 forbidden_patterns를 거부합니다.
  • 명시적 확인 없이 스레드를 시작하지 마십시오.
  • 추적기 명령은 순차적으로 실행 — Google Sheets는 분당 약 60회 읽기를 허용하며 각 명령은 모든 탭을 읽습니다.

종속성

uv (brew install uv, 또는 curl -LsSf https://astral.sh/uv/install.sh | sh). 요약의 커밋 스캔을 위한 git. Google Sheets 백엔드 전용: 시트에 대한 편집자 액세스 권한이 있는 서비스 계정 JSON 키. 세션 요약은 Claude Code 트랜스크립트(~/.claude*/projects)를 읽습니다; 다른 에이전트의 경우 Git 활동 및 핸드오프만 보고합니다.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

CodeQuality

Code quality loop for any repo, seen through two lenses — a tool lens (linters, type checkers, security, dead-code and duplication scanners; fix by P0 security → P1 correctness → P2 maintainability) and a principle lens (SOLID + Clean Code smells; one principle at a time, propose → confirm → apply behind characterization tests). One manifest of free local tools, one scan, one fix loop, one mandatory Quality Improvement Report. USE WHEN improve code quality, analyze code, fix linting, reduce duplication, add types, security scan, test coverage, refactor, improve code design, apply SOLID, clean code refactor, reduce complexity, kill code smells, make code maintainable, refactor legacy code, single responsibility, dependency inversion, remediation sprint, install quality tools, quality baseline, smell report, refactoring roadmap, what should we fix first. NOT FOR the issue lifecycle, branches, PRs or merging (use IssueFlow; its Remediation workflow calls this skill to pick and scope the w

MeetingAnalysis

Turn meetings into structured summaries and tracked action items. Transcribes recordings locally (faster-whisper on CUDA, Apple Silicon or CPU), imports Google Meet / Gemini notes through connectors, or takes pasted notetaker transcripts; writes a summary with decisions and an action table; pushes only your own items to the BattlePlan tracker. Includes an unattended inbox ingest (drop a recording, get a summary) and a hard rule that recordings never land in a git repo. USE WHEN analyze meeting, meeting summary, transcribe meeting, transcribe recording, summarize this call, what happened in the meeting, import meeting notes, Gemini notes, Google Meet notes, import meetings to tracker, auto ingest meetings, meeting inbox, process recordings folder, set up meeting analysis.

관련 스킬