Community生產力與協作github.com

BattlePlan

根據任務追蹤器(本地 CSV、Excel 活頁簿或 Google 試算表)生成每日執行計畫。根據情境與子情境分組任務,估算時間,找出可平行處理的執行緒,並為每個執行緒產立即能用的起始提示。從昨天而非從零開始 — 回顧前一天的代理程式工作階段與 git 提交,預填稽核紀錄,並提供繼續命令。包含日終交接 (--close)、無人值守晨間草稿 (--draft) 以及任務管理功能(新增、完成、取消、復原、清理、批次匯入)。使用時機:規劃今天、每日計畫、戰鬥計畫、我該做什麼、日終交接、晨間草稿、任務總覽、站立會議準備、任務優先排序、新增任務、標記任務完成、設定 BattlePlan、設定任務追蹤器。

BattlePlan 是什麼?

BattlePlan 是一個 AI 代理技能,旨在將開發人員的工作從被動的回應模式轉變為主動的、基於計畫的執行模式。它支援 Claude Code、Cursor、Codex 等代理,其核心功能是從本機 CSV、Excel 活頁簿或 Google 試算表中讀取所有開啟任務,並自動與自上次計畫以來的實際執行情況進行比對。技能會根據情境將任務分組,估算時間,找出可平行處理的執行緒,並為每個執行緒產立即能使用的起始提示,讓全新的代理工作階段可以無縫接軌。BattlePlan 強調「回顧提案,人類確認」的原則,不會僅憑證據就自動標記任務完成,確保使用者始終保有控制權。它支援多機器工作流程,透過 git 同步計畫檔案,並透過 `--close` 和 `--draft` 命令實現日終交接與無人值守的晨間草稿。此外,它還提供完整的任務管理功能,包括新增、完成、取消、復原、清理以及從票務系統或會議中批次匯入任務。 BattlePlan 的執行完全依賴 `uv` 來管理 Python 腳本的依賴(基於 PEP 723 規範),無需額外管理虛擬環境,並支援 CSV、Excel 和 Google 試算表作為後端儲存。對於機密情境,它會自動隱藏 IP、URL 與特定模式,僅顯示票務 ID 與通用摘要。

相容平台✓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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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。其中包含所有者、追蹤器後端、計畫目錄以及情境階層。技能目錄絕不儲存個人資料,因此可以自由共享和更新。

路由

調用方式工作流程
"設定 battleplan",無設定檔,新追蹤器,新情境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:其他工作階段可能正在該儲存庫中處理未提交的工作。如果快轉合併失敗,請在本地提交並通知推送尚未完成。

工具

腳本功能
`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):無需管理虛擬環境。測試: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.

相關技能