任务优先级管理工具

Quarterback是一款战略任务优先级管理和代理编排工具,专为多项目操作者设计,提供5因素加权评分引擎、组织上下文和时间感知规划。

  • by bobbyrgoldsmith
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 bobbyrgoldsmith/quarterback

使用说明

四分卫

阅读字段。呼叫该剧。

为多项目运营商提供战略任务优先级和代理编排。


其他所有AI任务管理器都崩溃了 一个项目 进入子任务。四分卫帮助你决定你的哪一个 十个项目 立即确定优先级——使用5因素加权评分引擎、组织背景和时间意识规划。它在本地运行,无需任何成本,既可以作为独立的CLI,也可以作为Claude的MCP服务器。

是什么让四分卫与众不同

功能 四分卫 TaskMaster AI 虾任务管理器
多项目优先级 5因素加权引擎 单个项目分解 单个项目
咨询文件系统 根据你的目标分析文章 否 否
代理编排 自治级别+webhooks 否 否
时间意识规划 工作时间、午餐、缓冲时间 否 否
组织背景 目标、约束、工作流 否 否
知识维基(Playbook) LLM维护wiki以实现跨会话一致性 否 否
冲突检测 跨项目调度冲突 否 否
独立CLI 无AI运行时的完整CLI 需要AI 需要AI
成本 免费(麻省理工学院) 免费 免费

快速开始

# Install
pip install quarterback

# Initialize (creates ~/.quarterback/)
quarterback init

# Interactive setup wizard — walks you through org, goals, workflows, projects, constraints
quarterback setup

# Add your first project and tasks
quarterback add "Launch landing page" --project "My Startup" --priority 4 --effort 3 --impact 5
quarterback add "Write blog post" --project "Content" --priority 3 --effort 2 --impact 3

# See what to work on
quarterback priorities

# Find quick wins
quarterback quick-wins

# Plan your day with time awareness
quarterback plan-day

LLM供电设置(通过MCP)

当使用Quarterback作为MCP服务器时,请询问您的LLM: “为我设置四分卫” --它将调用 setup_quarterback 工具,就您的业务、目标、工作流程、项目、约束和知识库(Playbook)与您进行对话式访谈,然后一次性编写所有配置文件和数据库记录。无需手动编辑YAML。

MCP服务器

四分卫与 任何兼容MCP的客户端 --Claude Desktop、Claude Code、Cursor、Windsurf、Cline、OpenAI代理等。所有23个工具都使用标准的MCP协议(基于stdio的JSON-RPC),没有LLM特定的依赖关系。

# Install with MCP support
pip install quarterback[mcp]

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "quarterback": {
      "command": "quarterback-server"
    }
  }
}

或者克劳德代码(~/.claude/settings.json):

{
  "mcpServers": {
    "quarterback": {
      "command": "quarterback-server"
    }
  }
}

相同的 quarterback-server 该命令适用于任何MCP客户端——只需将其添加到客户端的服务器配置中即可。

然后问你的法学硕士: “我今天应该做什么?” --它将使用所有23个四分卫工具来分析你的优先事项。

特性

5因素优先级引擎

每项任务都从五个方面进行评分:

因素 重量 它测量什么
影响 30% 任务影响+项目收入/战略价值
紧迫性 25% 截止日期临近+封锁状态
战略的 25% 项目优先级+里程碑状态
努力 15% 反向努力得分(快速任务得分更高)
快赢 5% 高影响力+低努力奖励

咨询文件系统

根据您的组织背景分析外部文章、书籍和建议:

# Import and auto-analyze an article
quarterback advisory-add --title "Growth Strategy" --url https://example.com/article

# Review the analysis
quarterback advisory-view --id 1

# Approve recommendations (optionally create tasks)
quarterback advisory-approve --id 1 --approve 1,3,5 --create-tasks

分析器根据您的目标和限制检查每一项建议,标记冲突和协同作用。

代理编排

标记具有可配置自主性的自主代理执行任务:

  • 草稿:代理创建草稿供您审阅
  • 检查点:代理人暂停关键决策以获得批准
  • 自主:代理运行到完成

当任务准备就绪时,Webhooks会通知您的自动化层(n8n、Zapier、自定义)。

游戏手册--知识维基

剧本是四分卫汇编的知识层。这是一个LLM维护的markdown wiki,它为每个会话(本地CLI、MCP或自治代理)提供了关于您的项目、决策和策略的相同规范上下文。

它解决的问题是: 如果没有Playbook,每个AI会话都会重新开始,并从稀疏的信号中重新获取组织上下文。运行同一查询的两个会话可能会产生不同的结果,因为它们独立地重建理解。剧本提供了所有课程阅读的累积知识。

它是如何工作的:

~/playbook/                          (or ~/.quarterback/playbook/)
├── CLAUDE.md                        # Schema — how the LLM reads/writes pages
├── raw/                             # Drop zone for source material
└── wiki/
    ├── index.md                     # Master catalog — read this first
    ├── entities/                    # Companies, products, clients, tools
    ├── concepts/                    # Patterns, strategies, recurring themes
    ├── decisions/                   # Decisions with rationale and alternatives
    ├── compiled/                    # QB-compatible files for task scoring
    │   ├── goals.md                 # Read by QB's prioritization engine
    │   └── constraints.md           # Read by QB's conflict detection
    └── log.md                       # Append-only operations record

设置: 播放手册在以下过程中自动创建 quarterback setup (或MCP设置向导)。面试会询问你的关键实体、概念和决策,然后为最初的维基页面播种。

没有剧本: 四分卫的工作方式和以前一样——从中读取目标和限制 ~/.quarterback/org-context/ 文件夹。Playbook是可选择加入的。

使用Playbook: 四分卫读 compiled/goals.md 和 compiled/constraints.md 从Playbook开始,回落到 org-context/ 如果Playbook未初始化,则返回文件。你的法学硕士阅读 wiki/index.md 完整的组织背景。

# Check Playbook status
quarterback playbook status

# Browse the index
quarterback playbook index

# List pages by category
quarterback playbook list --category entities

# Read a specific page
quarterback playbook read entities/my-product.md

# Search across all pages
quarterback playbook search "budget"

黑曜石集成(可选): 在设置过程中,您可以选择将Playbook配置为黑曜石保险库。打开Obsidian中的Playbook文件夹进行图形可视化和可视化编辑。安装 黑曜石MCP服务器 用于程序化访问。不需要黑曜石依赖性——Playbook作为普通的标记文件工作。

CI/CD管道集成

Quarterback的CLI和webhook系统使其非常适合自动化管道——在没有人工参与的情况下更新任务状态、记录可交付成果并触发下游工作。

管道中的直接CLI

将四分卫命令添加到任何CI/CD步骤中。CLI是无状态的,可编写脚本:

# GitHub Actions example: auto-update task on deploy
- name: Mark deploy task complete
  run: |
    pip install quarterback
    export QUARTERBACK_HOME=${{ runner.temp }}/.quarterback
    quarterback update 42 --status completed --notes "Deployed via CI, SHA: ${{ github.sha }}"
# After test suite passes, log results to a task
- name: Report test results
  run: |
    quarterback update 38 --notes "Tests passed: 106/106, coverage 87%. Build #${{ github.run_number }}"
# Nightly: check for overdue deliverables and alert
- name: Nightly priority check
  run: |
    quarterback alert-check
    quarterback priorities today --limit 5

带有webhooks的代理CI/CD

注册一个webhook,让您的自动化层实时对任务事件做出反应:

# Register a webhook pointing at your n8n/Zapier/custom endpoint
quarterback-server  # MCP tools available, or use CLI:
# In your automation script: mark a task agent-ready after PR merge
import subprocess
subprocess.run([
    "quarterback", "update", "55",
    "--status", "completed",
    "--notes", f"PR #{pr_number} merged. Deployed to staging."
])

使用案例:

管道事件 四分卫行动 会发生什么
PR合并 update_task status=已完成 任务标记为已完成,webhook向Slack触发
部署成功 update_task 带有SHA+环境注释 通过审计跟踪跟踪可交付成果
夜行cron get_priorities + alert-check 团队每天都会收到逾期情况的总结
测试套件失败 add_task 带有故障详细信息 Bug自动归档,链接到项目
Sprint开始 get_priorities + detect_conflicts 工作开始前曲面调度冲突
代理完成工作 update_agent_status status=已完成 Webhook通知编排器,下一个任务已调度
发布已标记 advisory-add 附带发行说明 根据项目目标分析变更日志

跨环境共享数据库

将多个环境指向同一个Quarterback实例:

# All CI runners share one database via mounted volume or network path
export QUARTERBACK_HOME=/shared/quarterback

# Or per-environment with migration
quarterback migrate /path/to/source

这使您的本地CLI、CI管道和MCP连接的代理都可以读写同一个任务图,从而在手动和自动工作流中为您提供单一的真实来源。

时间意识规划

quarterback plan-day

考虑你的工作时间、午休时间、会议缓冲时间和当前时间,提出真正适合你剩余一天的任务。

配置

组织背景

之后 quarterback init,跑 quarterback setup 对于交互式向导,或要求Claude通过MCP运行安装向导。您还可以在中手动配置上下文 ~/.quarterback/org-context/:

~/.quarterback/org-context/
├── goals.md          # Your strategic, workflow, and project goals
├── projects.yaml     # Active projects with metadata
├── workflows.yaml    # Groups of related projects
└── constraints.md    # Time, budget, and strategic boundaries

包括示例模板——从以下位置复制 .example 文件和自定义。

如果在设置过程中启用Playbook, goals.md 和 constraints.md 由wiki自动维护 compiled/ 目录。您仍然可以手动编辑组织上下文文件——Playbook是可添加的,不是必需的。

警报配置

在中配置通知 ~/.quarterback/config/alerts.yaml:

  • 安静时间(晚上没有通知)
  • 优先级阈值(仅通知P4+任务)
  • 时间敏感的项目(始终通知账单、税款等)
  • 工作时间和午休时间设置

CLI命令

命令 描述
quarterback init 初始化四分卫
quarterback setup 交互式设置向导
quarterback migrate <dir> 从任务管理器迁移
quarterback priorities [today|week|all] 优先任务列表
quarterback add "task" [options] 添加任务
quarterback update <id> [options] 更新任务
quarterback list [-s status] 列出任务
quarterback quick-wins 寻找速赢
quarterback conflicts 检测优先级冲突
quarterback projects 列出项目
quarterback summary 组织总结
quarterback plan-day 有时间意识的日常计划
quarterback advisory-add 添加咨询文件
quarterback advisory-list 列出咨询文件
quarterback advisory-view --id N 查看文档详细信息
quarterback advisory-analyze --id N 分析文档
quarterback advisory-approve --id N 批准/拒绝建议
quarterback alert-check 检查警报
quarterback alert-summary 发送每日摘要
quarterback playbook status 剧本初始化状态
quarterback playbook index 显示Playbook主目录
quarterback playbook list 列出wiki页面(含 --category 过滤器)
quarterback playbook read <path> 阅读维基页面
quarterback playbook search <query> 跨页面全文搜索

MCP工具(共27个)

当用作MCP服务器时,Quarterback向Claude公开了这些工具:

任务管理: get_priorities, add_task, update_task, get_quick_wins, detect_conflicts, assess_task_value, get_blocking_tasks

项目管理: add_project, list_projects, update_project, get_organizational_summary

咨询系统: add_advisory_document, list_advisory_documents, get_advisory_document, analyze_advisory_document, discuss_advisory_recommendations, adopt_advisory_recommendations

剧本: playbook_read, playbook_write, playbook_search, playbook_ingest

网络钩子: register_webhook, list_webhooks, update_webhook, delete_webhook

代理编排: mark_task_agent_ready, get_agent_ready_tasks, update_agent_status

设置: setup_quarterback

环境变量

变量 默认值 描述
QUARTERBACK_HOME ~/.quarterback 数据目录
PLAYBOOK_PATH ~/.quarterback/playbook 剧本维基位置(或设置在 config/playbook.yaml)
QUARTERBACK_API_URL 无 保留给专业版功能

贡献

看 贡献.md 用于开发设置、代码风格和PR流程。

许可证

麻省理工学院-见 许可证


由...建造 NodeBridge自动化解决方案 | GitHub赞助商