内容
<!-- mcp-name: io.github.bobbyrgoldsmith/quarterback -->
# 四分卫
**读懂比赛场地。指挥比赛进程。**
面向多项目运营者的战略任务优先级和代理编排。
[](https://pypi.org/project/quarterback/)
[](https://pypi.org/project/quarterback/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/bobbyrgoldsmith/quarterback/actions/workflows/ci.yml)
[](https://glama.ai/mcp/servers/bobbyrgoldsmith/quarterback)
---
其他AI任务管理器将**一个项目**分解为子任务。四分卫帮助您决定现在应该优先处理哪些**十个项目** —— 使用5因素加权评分引擎、组织上下文和时间感知规划。它可以在本地运行，免费使用，既可以作为独立的CLI命令行工具，也可以作为Claude的多项目协作协议（MCP）服务器。
## 四分卫的不同之处
| 功能 | 四分卫 | TaskMaster AI | Shrimp Task Manager |
|---------|-------------|---------------|---------------------|
| **多项目优先级** | 5因素加权引擎 | 单项目分解 | 单项目 |
| **咨询文档系统** | 分析文章以匹配您的目标 | 无 | 无 |
| **代理编排** | 自主级别 + Webhooks | 无 | 无 |
| **时间感知规划** | 工作时间、午餐、缓冲时间 | 无 | 无 |
| **组织上下文** | 目标、约束、工作流程 | 无 | 无 |
| **知识库（Playbook）** | LLM维护的wiki，用于跨会话一致性 | 无 | 无 |
| **冲突检测** | 跨项目调度冲突 | 无 | 无 |
| **独立CLI命令行工具** | 完整的CLI命令行工具，无需AI运行时 | 需要AI | 需要AI |
| **成本** | 免费（MIT） | 免费 | 免费 |
## 快速开始
```bash
# 安装
pip install quarterback
# 初始化（创建~/.quarterback/）
quarterback init
# 交互式设置向导 — 带您完成组织、目标、工作流程、项目、约束的设置
quarterback setup
# 添加您的第一个项目和任务
quarterback add "启动登陆页面" --project "我的创业项目" --priority 4 --effort 3 --impact 5
quarterback add "撰写博客文章" --project "内容" --priority 3 --effort 2 --impact 3
# 查看当前需要处理的内容
quarterback priorities
# 查找快速赢得成果
quarterback quick-wins
# 计划您的当天任务，考虑时间因素
quarterback plan-day
```
### 通过MCP进行LLM支持的设置
当使用四分卫作为MCP服务器时，请询问您的LLM： *"为您设置四分卫"* —— 它将调用 `setup_quarterback` 工具，以对话式采访您的业务、目标、工作流程、项目、约束和知识库（Playbook），然后一次性编写所有配置文件和数据库记录。无需手动编辑YAML文件。
## MCP服务器
四分卫与**任何MCP兼容的客户端**配合使用 — Claude Desktop、Claude Code、Cursor、Windsurf、Cline、OpenAI代理等。所有23种工具都使用标准MCP协议（stdio上的JSON-RPC），无LLM特定依赖。
```bash
# 安装MCP支持
pip install quarterback[mcp]
```
添加到您的Claude Desktop配置（ `~/Library/Application Support/Claude/claude_desktop_config.json` ）：
```json
{
"mcpServers": {
"quarterback": {
"command": "quarterback-server"
}
}
}
```
或对于Claude Code（ `~/.claude/settings.json` ）：
```json
{
"mcpServers": {
"quarterback": {
"command": "quarterback-server"
}
}
}
```
相同的 `quarterback-server` 命令适用于任何MCP客户端 — 只需将其添加到客户端的服务器配置中。
然后询问您的LLM： *"我今天应该做什么？"* —— 它将使用所有23个四分卫工具来分析您的优先级。
## 功能
### 5因素优先级引擎
每个任务都根据五个维度进行评分：
| 因素 | 权重 | 衡量内容 |
|--------|--------|-----------------|
| **影响** | 30% | 任务影响 + 项目收入/战略价值 |
| **紧急程度** | 25% | 截止日期临近程度 + 阻塞状态 |
| **战略** | 25% | 项目优先级 + 里程碑状态 |
| **工作量** | 15% | 倒置工作量评分（快速任务得分更高） |
| **快速赢得成果** | 5% | 高影响 + 低工作量奖励 |
### 咨询文档系统
分析外部文章、书籍和建议以匹配您的组织上下文：
```bash
# 导入并自动分析文章
quarterback advisory-add --title "增长策略" --url https://example.com/article
# 查看分析结果
quarterback advisory-view --id 1
# 批准建议（可选地创建任务）
quarterback advisory-approve --id 1 --approve 1,3,5 --create-tasks
```
分析器检查每个建议以匹配您的目标和约束，标记冲突和协同作用。
### 代理编排
用可配置的自主级别标记任务以供自主代理执行：
- **草稿**：代理创建草稿供您审查
- **检查点**：代理在关键决策时暂停以供批准
- **自主**：代理运行至完成
Webhook在任务准备就绪时通知您的自动化层（n8n、Zapier、自定义）。
### Playbook — 知识库
Playbook是四分卫编译的知识层。它是一个LLM维护的markdown wiki，为每个会话 — 本地CLI命令行工具、MCP或自主代理 — 提供相同的规范上下文，关于您的项目、决策和策略。
**它解决的问题：** 没有Playbook，每个AI会话都从头开始，并根据稀疏的信号重新推导您的组织上下文。运行相同查询的两个会话可能会产生不同的结果，因为它们独立地重建理解。Playbook提供了累积的知识，所有会话都可以读取。
**工作原理：
```
~/playbook/ （或 ~/.quarterback/playbook/）
├── CLAUDE.md # 架构 — LLM如何读取/写入页面
├── raw/ # 源材料暂存区
└── wiki/
├── index.md # 主目录 — 先阅读此文件
├── entities/ # 公司、产品、客户、工具
├── concepts/ # 模式、策略、重复主题
├── decisions/ # 决策及理由和替代方案
├── compiled/ # 四分卫兼容文件用于任务评分
│ ├── goals.md # 四分卫优先级引擎读取
│ └── constraints.md # 四分卫冲突检测读取
└── log.md # 附加操作记录
```
**设置：** Playbook在 `quarterback setup` （或MCP设置向导）期间自动创建。采访会询问您的关键实体、概念和决策，然后初始化wiki页面。
**无Playbook：** 四分卫的工作方式与以前完全相同 — 从 `~/.quarterback/org-context/` 文件中读取目标和约束。Playbook是可选的。
**使用Playbook：** 四分卫首先读取Playbook中的 `compiled/goals.md` 和 `compiled/constraints.md` ，如果Playbook未初始化，则回退到 `org-context/` 文件。您的LLM读取 `wiki/index.md` 以获取完整的组织上下文。
```bash
# 检查Playbook状态
quarterback playbook status
# 浏览索引
quarterback playbook index
# 按类别列出页面
quarterback playbook list --category entities
# 读取特定页面
quarterback playbook read entities/my-product.md
# 在所有页面中搜索
quarterback playbook search "budget"
```
**Obsidian集成（可选）：** 在设置期间，您可以选择将Playbook配置为Obsidian vault。使用Obsidian打开Playbook文件夹以进行图可视化和视觉编辑。安装 [Obsidian MCP服务器](https://github.com/iansinnott/obsidian-claude-code-mcp) 以进行编程访问。无需Obsidian依赖 — Playbook作为纯markdown文件工作。
### CI/CD管道集成
四分卫的CLI命令行工具和Webhook系统使其成为自动化管道的天然选择 — 更新任务状态、记录交付成果并在无需人工干预的情况下触发下游工作。
#### 管道中的直接CLI命令行工具
将四分卫命令添加到任何CI/CD步骤。CLI命令行工具是无状态且可脚本化的：
```yaml
# GitHub Actions示例：在部署后自动更新任务
- name: 标记部署任务完成
run: |
pip install quarterback
export QUARTERBACK_HOME=${{ runner.temp }}/.quarterback
quarterback update 42 --status completed --notes "通过CI部署，SHA： ${{ github.sha }}"
```
```yaml
# 测试套件通过后，将结果记录到任务中
- name: 报告测试结果
run: |
quarterback update 38 --notes "测试通过：106/106，覆盖率87%。构建#${{ github.run_number }}"
```
```yaml
# 夜间：检查到期交付成果并提醒
- name: 夜间优先级检查
run: |
quarterback alert-check
quarterback priorities today --limit 5
```
#### 使用Webhook的代理CI/CD
注册Webhook并让您的自动化层实时响应任务事件：
```bash
# 注册指向您的n8n/Zapier/自定义端点的Webhook
quarterback-server # MCP工具可用，或使用CLI命令行工具：
```
```python
# 在您的自动化脚本中：在PR合并后标记任务代理就绪
import subprocess
subprocess.run([
"quarterback", "update", "55",
"--status", "completed",
"--notes", f"PR #{pr_number} 已合并。部署到预发布环境。"
])
```
**用例：**
| 管道事件 | 四分卫操作 | 会发生什么 |
|---------------|-------------------|--------------|
| PR合并 | `update_task` 状态=已完成 | 任务标记完成，Webhook触发到Slack |
| 部署成功 | `update_task` 带有SHA + 环境注释 | 交付成果跟踪，附有审计跟踪 |
| 每夜cron | `get_priorities` + `alert-check` | 团队每天收到总结，显示哪些任务逾期 |
| 测试套件失败 | `add_task` 带有失败详细信息 | 自动创建错误，链接到项目 |
| 冲刺开始 | `get_priorities` + `detect_conflicts` | 在工作开始前显示调度冲突 |
| 代理完成工作 | `update_agent_status` 状态=已完成 | Webhook通知编排器，调度下一个任务 |
| 发布标记 | `advisory-add` 带有发布说明 | 变更日志分析以匹配项目目标 |
#### 跨环境共享数据库
将多个环境指向同一个四分卫实例：
```bash
# 所有CI运行器通过挂载的卷或网络路径共享一个数据库
export QUARTERBACK_HOME=/shared/quarterback
# 或每个环境使用迁移
quarterback migrate /path/to/source
```
这使得您的本地CLI命令行工具、CI管道和MCP连接的代理都可以读写同一个任务图 — 为您提供跨手动和自动工作流的单一事实来源。
### 时间感知规划
```bash
quarterback plan-day
```
考虑您的工作时间、午餐休息、会议缓冲时间和当前时间，推荐适合您剩余时间的任务。
## 配置
### 组织上下文
在 `quarterback init` 后，运行 `quarterback setup` 进行交互式向导，或让Claude通过MCP运行设置向导。您也可以在 `~/.quarterback/org-context/` 中手动配置您的上下文：
```
~/.quarterback/org-context/
├── goals.md # 您的战略目标、工作流和项目目标
├── projects.yaml # 活跃项目，附带元数据
├── workflows.yaml # 相关项目的分组
└── constraints.md # 时间、预算和战略边界
```
示例模板已包含 — 复制 `.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` | Playbook初始化状态 |
| `quarterback playbook index` | 显示Playbook主目录 |
| `quarterback playbook list` | 列出wiki页面（带 `--category` 过滤） |
| `quarterback playbook read <path>` | 读取wiki页面 |
| `quarterback playbook search <query>` | 跨页面全文搜索 |
## MCP工具（共27个）
当用作MCP服务器时，四分卫向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**： `playbook_read` 、 `playbook_write` 、 `playbook_search` 、 `playbook_ingest`
**Webhook**： `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` | Playbook wiki位置（或在 `config/playbook.yaml` 中设置） |
| `QUARTERBACK_API_URL` | 无 | 为Pro功能保留 |
## 贡献
参见 [CONTRIBUTING.md](CONTRIBUTING.md) 以获取开发设置、代码样式和PR流程。
## 许可证
MIT - 参见 [LICENSE](LICENSE)
---
由 [NodeBridge Automation Solutions](https://nodebridge.dev) 构建 | [GitHub Sponsors](https://github.com/sponsors/bobbyrgoldsmith)
