通过 MCP 使用 Sprint 工作台
本手册说明怎样查询、提交和更新控制台记录。
本手册也说明怎样通过每周复核关闭 Sprint。
打开“插件 → 个人 → 由你创建”。
选择 Cave Intelligence 工作台，然后点击“安装”或“连接”。
连接后，在本项目的 ChatGPT 对话中调用工具。
工作台 MCP 地址路径为 /mcp。若插件列表没有工作台，需由工作区管理员在“Workspace settings → Permissions & roles”开启 Use plugins、Upload plugins 和 Create plugins with MCPs。开启后，站点所有者需重新发布一个版本。
工作台网页只展示记录。网页不再接受需求和沟通录入。
一、第一次使用
- 在本项目聊天中调用
get_workbench_guide。 - 调用
get_project_overview查看当前数据。 - 调用
list_sprints查看周历和需求归属。 - 查看单项时调用
get_requirement。 - 完成写入后，点击网页顶部的“刷新记录”。
请调用 Cave Intelligence 工作台的 get_project_overview 和 list_sprints。 说明本周、下周、需求数量和未锁定计划。
二、工具清单
| 工具 | 用途 | 主要参数 |
|---|---|---|
get_workbench_guide | 读取工具规则和操作顺序。 | 无 |
get_project_overview | 查看记录版本、当前 Sprint 和需求计数。 | 无 |
list_sprints | 查看周历、节奏节点和需求关联。 | from_number、count |
list_requirements | 按周次、状态或关键词查需求。 | sprint_number、status、query |
get_requirement | 读取需求全文、证据和沟通记录。 | requirement_id |
submit_requirement | 新建需求，并自动排入下一个 Sprint。 | request_id、title、problem；可选结果、验收、来源和沟通摘要 |
update_requirement | 更新需求正文、方案、验收标准或来源。 | request_id、requirement_id、fields |
append_communication | 追加讨论、来源链接或周度进度。 | request_id、requirement_id、title、body；可选 source、kind |
upload_requirement_attachment | 用 MCP 保存需求附件。单个文件上限为 5 MiB。 | request_id、requirement_id、file_name、mime_type、content_base64 |
get_requirement_attachment | 查看附件信息和下载地址。 | attachment_id |
plan_requirement | 指定需求所属 Sprint、优先级和执行方案。 | request_id、requirement_id、rationale；周次可选 |
change_requirement_status | 更新待确认、待开始、进行中或阻塞状态。 | request_id、requirement_id、status、note |
lock_sprint_plan | 确认 Sprint 范围、目标和验收标准。 | request_id、sprint_number、requirement_ids、goal |
add_sprint_node | 新增节奏节点并关联需求。 | request_id、sprint_number、date、title、description |
review_sprint | 检查本周需求和验收材料。 | sprint_number |
close_sprint | 关闭 Sprint，或把未完成项转到下周。 | request_id、sprint_number、review_date、summary、decisions |
restore_project_backup | 用 JSON 备份替换当前项目记录。 | request_id、expected_version、backup_state、固定确认语 |
三、提交需求
需求提交后会进入下一个自然周 Sprint。
“已排期”表示需求有目标周次。
“已排期”不表示 Sprint 已锁定或任务已开工。
调用工具时，提供问题、期望结果和当前对话来源。
请调用 submit_requirement。 标题：工作台支持 MCP 需求管理 问题：目前表单需要人工录入，操作路径不统一。 期望结果：通过 MCP 提交、更新、排期和验收。 验收标准：需求、沟通和附件都能通过 MCP 读取。 来源：本项目当前聊天。 请把这段讨论摘要写入初始沟通记录。
工具会返回需求编号和自动排入的周次。
工作台会把提交摘要保存为初始沟通记录。
四、更新和追加沟通
先调用 get_requirement 读取当前需求。
再调用 update_requirement 修改指定字段。
讨论内容调用 append_communication 单独追加。
来源可写聊天标题、日期、文件名或可访问链接。
更新不会改变负责人。负责人始终是 CEO。
请调用 update_requirement。 需求编号：RD-006 更新验收标准：保留证据来源、采集时间和验证状态。 请调用 append_communication。 沟通标题：CEO 确认执行边界 沟通内容：只做资料整理和只读核验。 来源：https://chatgpt.com/c/本项目聊天链接
通过 MCP 添加文件
- 把文件附在当前 ChatGPT 对话中。
- 告诉 ChatGPT 需求编号和文件用途。
- 让 ChatGPT 调用
upload_requirement_attachment。 - 工具会把文件存入附件库，并返回可下载地址。
单个文件最多 5 MiB。
允许 PDF、Office 文档、文本、图片、HTML、JSON 和 ZIP。
网页需求详情会在沟通记录上方显示附件链接。
请把我刚附上的 RD-006 执行文件上传到需求 RD-006。 调用 upload_requirement_attachment。 来源填写：本项目当前聊天。
规划需求和添加节点
新需求会自动排入下一个 Sprint。
需要调整时，调用 plan_requirement 指定 Sprint、优先级和验收标准。
CEO 调用 lock_sprint_plan 确认范围后，需求才成为本轮承诺。
锁定后，调用 change_requirement_status 更新执行状态。
调用 add_sprint_node 添加周内节点和需求关联。
请把需求 RD-006 规划到 Sprint 02。 优先级设为 P1，并确认验收标准。 请先读取 Sprint 02 当前范围。 不要替我锁定范围。
五、每周排期和周度关闭
固定周期 Sprint 01 为 2026-10-05 至 2026-10-11。
后续 Sprint 每 7 天顺延。
新需求默认进入当前自然周之后的下一个 Sprint。
CEO 调用 lock_sprint_plan 后，需求才成为已承诺范围。
- 每周查看时，先调用
review_sprint。 - 逐项判断已完成或未完成。
- 完成项填写验收结果和证据。
- 未完成项填写本周进度、阻塞和下一步。
- 调用
close_sprint提交完整清单。
工具会关闭通过验收的需求。
工具会把未完成需求的进度写入沟通记录。
工具会把未完成需求移入下一个 Sprint。
缺少验收材料或周度进度时，工具会拒绝关闭。
工具不会按日历自动判断任务完成。
CEO 先确认每项结果，再调用关闭工具。
工具会按决定自动关闭或顺延需求。
请先调用 review_sprint 检查 Sprint 02。 然后逐项汇报已完成或未完成。 已完成项提供验收结果和证据。 未完成项提供一周进度、阻塞和下一步。 最后调用 close_sprint，关闭已完成项并把其他项顺延到下周。
六、写入保护
- 每次写入都要用唯一的
request_id。 - 请求超时时，先用相同 ID 和相同内容重试。
- 相同请求不会重复创建需求或沟通记录。
- 更改原请求内容时，必须生成新的 ID。
- 工具会保留版本号和写入人审计记录。
- 工具不连接 TourEvent Core、ECS 或生产服务。
- 附件只允许指定类型，且单个文件不超过 5 MiB。
七、备份和恢复
网页只提供“下载 JSON 备份”。
恢复通过 restore_project_backup 工具完成。
先读取当前版本号，再提交备份和固定确认语。
恢复会替换当前需求、Sprint 和沟通记录。
恢复前先下载一份最新 JSON。