quarterback (Bobbyrgoldsmith)

四分卫

阅读字段。呼叫该剧。

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

______________________________________________________________________

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

是什么让四分卫与众不同

快速开始

# 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因素优先级引擎

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

咨询文件系统

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

# 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."
])

使用案例：

跨环境共享数据库

将多个环境指向同一个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命令

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

环境变量

贡献

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

许可证

麻省理工学院-见 许可证

______________________________________________________________________

由...建造 |