内容
# 🗂️ 战略任务跟踪器
> **Notion AI 挑战提交 — Major League Hacking**
一个由 AI 驱动的战略执行助理，它可以将会议记录和笔记转化为跟踪的、跨平台的行动项目 — 自动执行。它从 Notion 读取，检查 Slack 以解决阻塞，创建 Notion 和 Google Tasks 中的任务，并将审批就绪的摘要写回您的会议笔记。
---
## 它能做什么
您将会议记录或笔记放入 Notion 数据库中。代理读取它，提取每个行动项目，检查 Slack 以获取阻塞的上下文，在 Notion 和 Google Tasks 之间同步任务，并将结构化摘要写回源笔记以供您审批。
### 4 个阶段的工作流程
```
阶段 1：摄入和上下文
→ 从您的 Notion "会议笔记" 数据库中读取会议记录
→ 提取：行动项目、负责人、截止日期、项目链接、阻塞
阶段 2：Slack 脉冲检查
→ 对于每个阻塞，搜索过去 24 小时的 Slack 消息
→ 如果已解决 → 在 Notion 中将任务标记为 "进行中" 并附上 ✅ 评论
→ 如果未解决 → 标记为关键阻塞，检查负责人任务负载，
如果负责人有 5+ 个活动任务，则建议委派
阶段 3：多平台同步
→ 在 Notion 中创建/更新任务记录，并具有完整的关联属性
→ 对于 Deborah 拥有的任务 → 还会创建一个 Google Task，包含
标题、截止日期和指向 Notion 源的链接
阶段 4：验证
→ 在源会议笔记中添加 "审批摘要" 块
→ 列出所有创建的任务、已解决的阻塞、未解决的关键阻塞，
以及委派建议
```
### 示例输出写入 Notion
```markdown
## 审批摘要
### 新增和更新的任务
- 设计登陆页面 — 负责人：Deborah — 截止日期：2026-04-05 — 项目：启动 Q2
### 阻塞结果
- ✅ 通过 Slack 上下文解决：API 集成延迟
- 🚨 关键阻塞：预算审批（负责人任务负载：7，委派：是）
### 跨平台同步
- Notion 更新：4
- 创建的 Google Tasks（Deborah）：2
- 由于集成问题跳过的 Slack 检查：0
### 需要审批
- 将预算审批从 Deborah 委派给财务负责人
```
---
## 使用的技术
| 技术 | 用途 |
|---|---|
| **[Notion MCP](https://mcp.notion.com)** | 读取会议笔记、创建和更新任务记录、编写审批摘要 |
| **[Slack MCP](https://github.com/modelcontextprotocol/server-slack)** (`@modelcontextprotocol/server-slack`) | 搜索消息以获取阻塞解决上下文 |
| **[Google Tasks MCP](https://github.com/alvincrave/gtasks-mcp)** (`@alvincrave/gtasks-mcp`) | 为指定负责人创建 Google Tasks |
| **Claude（通过 MCP）** | 使用 SKILL.md 代理定义编排整个 4 个阶段的工作流程 |
| **`mcp.json`** | 连接所有三个集成的 MCP 服务器配置 |
---
## 入门指南
### 先决条件
- 一个 [Notion](https://notion.so) 账户，包含：
- 一个 **"会议笔记"** 数据库（带有记录/笔记页面）
- 一个 **任务** 数据库，包含属性：标题、负责人、截止日期、状态、项目（关联）、来源（关联）
- 一个 [Slack](https://slack.com) 工作区，包含一个 Bot Token
- 一个 [Google 账户](https://tasks.google.com)，启用 Google Tasks API
- [Claude Desktop](https://claude.ai/download) 或任何 MCP 兼容的 AI 客户端
---
### 步骤 1 — 克隆仓库
```bash
git clone https://github.com/Zubbee18/strategic-task-tracker.git
cd strategic-task-tracker
```
---
### 步骤 2 — 获取 API 凭证
#### Notion 集成令牌
1. 前往 [notion.so/my-integrations](https://www.notion.so/my-integrations)
2. 点击 **"新建集成"** → 命名 → **保存**
3. 复制 **内部集成令牌**（以 `secret_...` 开头）
4. 将集成连接到您的会议笔记和任务数据库：
- 打开每个数据库 → 右上角 `...` → **连接** → 选择您的集成
#### Slack Bot 令牌
1. 前往 [api.slack.com/apps](https://api.slack.com/apps) → **创建新应用**
2. 添加 OAuth 范围：`channels:history`、`search:read`、`channels:read`
3. 安装到工作区 → 复制 **Bot 用户 OAuth 令牌**（`xoxb-...`）
4. 从工作区设置中复制您的 **团队 ID**（以 `T...` 开头）
#### Google Tasks 凭证
1. 前往 [console.cloud.google.com](https://console.cloud.google.com)
2. 创建项目 → 启用 **Google Tasks API**
3. 创建 **OAuth 2.0 凭证**（桌面应用类型）
4. 下载凭证并运行 OAuth 流以获取刷新令牌
---
### 步骤 3 — 配置 `mcp.json`
复制示例并填写您的凭证：
```bash
cp mcp.json.example mcp.json
```
编辑 `mcp.json`:
```json
{
"mcpServers": {
"notion": {
"url": "https://mcp.notion.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_NOTION_TOKEN"
}
},
"slack": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-slack"],
"env": {
"SLACK_BOT_TOKEN": "xoxb-your-token",
"SLACK_TEAM_ID": "T0123456789"
}
},
"google-tasks": {
"command": "npx",
"args": ["-y", "@alvincrave/gtasks-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id",
"GOOGLE_CLIENT_SECRET": "your-client-secret",
"GOOGLE_REFRESH_TOKEN": "your-refresh-token"
}
}
}
}
```
> ⚠️ 永远不要提交 `mcp.json` — 它已经在 `.gitignore` 中
---
### 步骤 4 — 在 Claude 中加载技能
将您的 MCP 客户端（Claude Desktop）指向 `mcp.json` 配置文件。然后在新的对话中，将可以使用 `strategic-ea-agent` 技能，该技能在 `SKILL.md` 中定义。
通过类似以下内容触发它：
> *"处理我在 Notion 会议笔记数据库中的最新会议记录，并同步行动项目。"*
---
## Notion 数据库架构
注意，这不是必需的，但这只是一个起点供您测试
### 会议笔记数据库
| 属性 | 类型 | 备注 |
|---|---|---|
| 标题 | 标题 | 会议名称 |
| 日期 | 日期 | 会议日期 |
| 记录 | 富文本 / 页面内容 | 粘贴完整笔记 |
### 任务数据库
| 属性 | 类型 | 备注 |
|---|---|---|
| 标题 | 标题 | 任务名称 |
| 负责人 | 文本 / 人 | 谁拥有它 |
| 截止日期 | 日期 | 截止日期 |
| 状态 | 选择 | `未开始`、`进行中`、`完成`、`关键阻塞` |
| 项目 | 关联 | 链接到项目数据库 |
| 来源 | 关联 | 链接回会议笔记 |
---
## 项目结构
```
strategic-task-tracker/
├── SKILL.md # 代理技能定义（系统的核心）
├── mcp.json.example # MCP 服务器配置模板（可以提交）
├── mcp.json # 您的真实配置，包含凭证（被 gitignore）
├── README.md
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
└── LICENSE
```
---
## 技能的工作原理
`SKILL.md` 文件定义了 `strategic-ea-agent` — 一个结构化的提示，指示 Claude 如何使用 MCP 工具编排整个 4 个阶段的工作流程。它包括：
- **触发条件** — 何时激活技能
- **操作规则** — 如何处理缺少的集成、追溯性和升级
- **阶段性指令** — 确切地调用哪些 MCP 工具以及何时调用
- **输出格式** — 写回 Notion 的确切审批摘要模板
---
## 许可证
MIT
