| name | wcb-sync |
| description | 从 WCB Agent API 自动拉取每日任务和事件，落到对应日期的 TASK.md。当用户说"拉一下今天任务"、"wcb sync"、"同步任务"、"看看今天有什么活动"时触发。适用于 web3career-study-track 项目的每日任务收集流程。免去手动从 web3career.build 页面复制任务的步骤。
|
WCB Sync Skill
通过 WCB Agent API 一键拉取指定日期的事件和任务，自动落到对应 daily-log 的 TASK.md。
触发场景
- 用户说"拉一下今天的任务"
- 用户说"wcb sync"或"
/wcb-sync"
- 用户说"同步今天的任务"、"看今天有什么活动"
- 用户说"拉一下 5/24 的任务"（可指定日期）
- 一天开始前需要确认当日 WCB 任务
前置条件
密钥：用户的 WCB Agent API Secret Key 必须配置在 User 级环境变量 WCB_AGENT_SECRET_API_KEY。
验证：
Test-Path env:WCB_AGENT_SECRET_API_KEY
$env:WCB_AGENT_SECRET_API_KEY.Substring(0, 12) # 应输出 "w3cb_sk_..."
如果密钥未配置，提示用户：
密钥未配置。请运行：
[System.Environment]::SetEnvironmentVariable("WCB_AGENT_SECRET_API_KEY", "<your_key>", "User")
然后重启终端或新会话。
API 入口
- Base URL:
https://web3career.build
- 调用端点:
POST /api/agent/call
- 文档:
https://web3career.build/llms.txt
- 当前用户 programId:
cmnx791nl008sru0167pzp4ki（AI x Web3 School）
工作流程
Step 1 · 解析日期参数
- 无参数 → 今天（系统日期）
/wcb-sync 5/24 或 /wcb-sync 2026-05-24 → 解析为 ISO 8601 范围- 时区：默认
Asia/Shanghai (UTC+8)，转换为 UTC 时拉宽一日范围
- 范围：
YYYY-MM-DDT00:00:00.000Z 到 YYYY-MM-DDT24:00:00.000Z（次日 0 点）
Step 2 · 拉取当日 events
$headers = @{ "Authorization" = "Bearer $env:WCB_AGENT_SECRET_API_KEY"; "Content-Type" = "application/json" }
$body = @{
procedure = "events.listForLearner"
input = @{
programId = "cmnx791nl008sru0167pzp4ki"
rangeStart = "<ISO start>"
rangeEnd = "<ISO end>"
}
} | ConvertTo-Json -Depth 3
$events = Invoke-RestMethod -Method POST -Uri "https://web3career.build/api/agent/call" -Headers $headers -Body $body
每个 event 含：title、description、startAt、endAt、meetingUrlPrimary、replayUrl、taskIds[]。
Step 3 · 拉取关联 tasks
收集所有 events 的 taskIds，去重，批量查询：
$body = @{
procedure = "tasks.listForLearnerByIds"
input = @{
programId = "cmnx791nl008sru0167pzp4ki"
taskIds = $allTaskIds
}
} | ConvertTo-Json -Depth 3
$tasks = Invoke-RestMethod -Method POST -Uri "https://web3career.build/api/agent/call" -Headers $headers -Body $body
每个 task 含：title、description、points、status、validTo、exclusiveGroupKey、proofPrompt。
Step 4 · 生成 TASK.md 内容
按以下模板组装内容，写到 daily-log/week-N/YYYY-MM-DD/TASK.md（如已存在，与现有内容 merge）：
# YYYY-MM-DD 任务
> 自动拉取自 WCB Agent API · 拉取时间 <YYYY-MM-DD HH:mm UTC+8>
## 今日任务清单
| # | 任务 | 时间 | 学分 | 状态 |
|---|------|------|------|------|
| 1 | <task title> | <event start time HH:mm> | +<points> | ⚪ 未开始 |
> 状态图例：⚪ 未开始 · ⏳ 进行中 · ✅ 已完成 · ❌ 错过 · 📤 已提交
## 任务详情
### 任务 #N · <task title>
- **学分**：+<points>
- **截止**：<validTo 转 Asia/Shanghai>
- **互斥组**：<exclusiveGroupKey>（若多个任务同组，仅可领其一）
- **会议链接**：<meetingUrlPrimary>
- **直播回放**：<replayUrl>
- **提交要求**：<proofPrompt>
#### 课前准备
<from event description if relevant>
#### 产出（手填）
- [ ]
#### 交付证明（手填）
>
Step 5 · 写入与提示
写入策略：
- 如果 TASK.md 不存在（仅有模板）→ 直接写入
- 如果 TASK.md 已有手填内容（产出 / 交付证明非空）→ 仅在文件顶部更新「今日任务清单」表格 + 任务详情元数据，不覆盖手填内容
- 如果不确定 → 先展示 diff 让用户确认
写入后：
输出汇总：
✓ 拉取到 N 个 event / M 个 task
✓ 写入 daily-log/week-N/YYYY-MM-DD/TASK.md
TODO: 任务完成后回填「产出」和「交付证明」，并到 WCB 平台手动提交
互斥组提示
WCB 经常有"实时参加 / 观看回放"互斥设计（同一直播两个任务，二选一）。检测到 exclusiveGroupKey 重复时：
- 在表格状态列加备注
（与 #X 互斥）
- 在任务详情节强调
边界与限制
- 不自动提交任务：本 skill 只拉取，不写入。提交 evidence 必须用户手动到 WCB 平台或显式调用
tasks.submitEvidence（需用户授权）
- 不动手填内容：用户已经在 TASK.md 写的产出 / 反思一律保留
- 密钥不入版本：永远不要把 API key 写入 commit message、TASK.md 或任何被 git track 的文件
- 编码注意：Windows PowerShell 默认 GBK 显示，写文件时确保 UTF-8 编码（用
Out-File -Encoding utf8 或直接 Write 工具）
与其他规范的关系
- 任务结构遵循
GUIDE.md "任务清单生成流程"节
- 周级任务清单沉淀仍在
week-N/__index__.md，本 skill 只填日级 TASK.md
- 完成后的 commit 走
git-commit-guide（type 用 task）
示例调用
用户：拉一下今天的任务
Agent：
1. 检测今天 = 2026-05-23
2. 调用 events.listForLearner，得到 1 个 event："Open Agentic Economy"
3. 调用 tasks.listForLearnerByIds，得到 2 个 task（实时 +20 / 回放 +10，互斥）
4. 写入 daily-log/week-1/2026-05-23/TASK.md
5. 输出汇总 + 提示用户去 WCB 平台提交
