Community生产力与协作github.com

BattlePlan

根据任务跟踪器(本地 CSV、Excel 或 Google 表格)生成每日执行计划,按上下文和子上下文分组任务、估算时间、找出并行线程,并为每个线程生成可直接粘贴的启动提示。

BattlePlan 是什么?

BattlePlan 是一款面向开发者与 AI 代理用户的每日执行规划工具,帮助你将零散的任务跟踪器转化为可执行的并行工作流。它读取本地 CSV、Excel 或 Google Sheets 中的未完成任务,自动按上下文和子上下文分组任务,估算时间、发现并行线程,并为每个线程生成可直接用于新代理会话的启动提示与恢复命令。 技能支持完整的日循环流程:晚间关闭(--close)生成交接文件,记录已完成、进行中和待延续任务;无人值守的早晨草稿(--draft)自动读取任务跟踪器与交接文件,预填审计提案;正式规划指令则打开草稿供你确认异常后执行。此外还提供任务增删改查、批量导入、上下文标签、秘密上下文过滤、多主机同步(通过 Git)等功能。 BattlePlan 不依赖虚拟环境,所有脚本通过 uv run --script 运行,支持 Pip 723 内联依赖。要求系统安装 uv 和 git。后端可配置为 CSV、Excel 或 Google Sheets(需要 service account JSON 密钥)。适用于主流终端和 CLI 代理场景。

兼容平台✓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 [context] [--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-<host>.md--close第一行 Closed: <带偏移的ISO 8601时间> on <host>,接着是已完成项、进行中项(下一步 + 恢复命令)、延续项
YYYY-MM-DD-draft-<host>.md--draft计划及预填的审计提案;不向跟踪器写入任何内容
YYYY-MM-DD-plan.md/BattlePlan确认后的计划,以便 --close 可以将计划与实际情况对比

<host> 是一个别名(mac、wsl、linux 或 $BATTLEPLAN_HOST_ALIAS),绝不使用主机名,因为这些文件可能跨机器共享。会话 ID 仅能在创建它的机器上恢复:向其他主机显示下一步操作,但绝不显示其恢复命令。

多主机: 设置 plans_git_sync: true 并将 plans_dir 放入一个 git 仓库中。提交仅影响刚刚写入的文件(git commit -- <path>),并在 fetch + merge --ff-only 之后执行。切勿 stash、reset 或 clean:其他会话可能在该仓库中持有未提交的工作。如果快进失败,则本地提交并说明推送待处理。

工具

脚本功能
`setup_tracker.py checkinit`
pull_tasks.py [context] [--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 后端需要:具有工作表编辑器权限的 service account 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.

相关技能