|
|
@@ -0,0 +1,43 @@
|
|
|
+# AI/Butler 域批次 · 开工包（17 SC）
|
|
|
+
|
|
|
+> 归属：契约补建计划 P0「AI成长教练 + 真人管家域」· 生成 2026-11-07 11:20
|
|
|
+> 数据源：sc-key-map.md（origin/cfclub，O-8 归一后 241 全量登记）· 端点核对：cfc-backend controller 源码（origin/cfclub 工作树）
|
|
|
+> 前置：O-7 裁决（主理人 2026-11-06 23:59 最终确认）契约补建工作流正式生效——契约核对 = 文档核对 + 端点比对（防假 RED），产出契约文档后转测试侧补契约 JUnit + 三类流证据，**渐进而非全量**。
|
|
|
+
|
|
|
+## 批次定位
|
|
|
+
|
|
|
+AI 成长教练域 10 个 SC（SC-B-01/02/04/05/06/07/09/10/11/12）与真人管家域 7 个 SC（SC-H-01~07），合计 **17 SC**。台账「对应能力键」列全为 `—`（此前未契约化）。**按 O-7 裁决：本批端点载体须逐条核验，产出契约文档后转测试侧，不建伪实现任务。**
|
|
|
+
|
|
|
+## 端点核验（初核候选，会话须逐条核实并回填）
|
|
|
+
|
|
|
+| SC | 场景标题 | 候选端点载体（origin/cfclub 工作树） | 初核 |
|
|
|
+|----|----------|--------------------------------------|------|
|
|
|
+| SC-B-01 | 问题解答·成长咨询对话 | `AIChatController` `/api/ai/chat/send`（成长咨询对话）；`ButlerController` `/api/butler/apply`（管家申请） | ✅ |
|
|
|
+| SC-B-02 | 任务跟踪·主动成长提醒 | `AIChatController` `/api/ai/health-coach/send`（健康教练主动提醒）；`/api/ai/gate`（AI 入口门控） | ✅ |
|
|
|
+| SC-B-04 | 问题解答·成长报告智能解读 | `AIChatController` `/api/ai/report/analyze`（报告解析） | ✅ |
|
|
|
+| SC-B-05 | 安全与韧性·敏感问题拦截与隐私保护 | `AIChatController` `/api/ai/gate`（敏感词/隐私拦截门控）；`/api/ai/health-coach/gate` | ✅ |
|
|
|
+| SC-B-06 | 安全与韧性·LangGraph 不可用 Fallback | `AIChatController` `/api/ai/chat/send`（fallback 分支，需核验实现降级逻辑） | ⚠ fallback 语义待核实 |
|
|
|
+| SC-B-07 | 任务跟踪·个性化任务/饮食推荐与采纳 | `AIChatController` `/api/ai/nutrition/send`（营养推荐）；`ButlerController` `/api/butler/commissions` | ✅ |
|
|
|
+| SC-B-09 | 任务跟踪·教练转接成长规划师 | `ButlerController` `/api/butler/apply`→转接；`FamilyButlerSelectController` `/api/butler/select` | ⚠ 转接语义待核实 |
|
|
|
+| SC-B-10 | 任务跟踪·家庭成长看板（教练聚合视图） | `ButlerController` `/api/butler/members` / `service-records`（聚合视图）；`AdminButlerController` `/api/admin/butler/list` | ✅ |
|
|
|
+| SC-B-11 | 问题解答·报告细节追问 | `AIChatController` `/api/ai/chat/send`（追问上下文）；`/api/ai/chat/conversations` / `chat/messages` | ✅ |
|
|
|
+| SC-B-12 | 任务跟踪·同步规划师建议主动跟进 | `AIChatController` `/api/ai/health-coach/send`（跟进推送） | ✅ |
|
|
|
+| SC-H-01 | 人工介入与升级·接收 AI 升级并人工介入 | `AdminButlerController` `/api/admin/butler/review`（升级介入）；`/api/admin/butler/assignments` | ✅ |
|
|
|
+| SC-H-02 | 一对一服务与协调·一对一家长陪跑 | `AdminButlerController` `/api/admin/butler/assign-member` / `list`；`ButlerController` `/api/butler/profile` | ✅ |
|
|
|
+| SC-H-03 | 一对一服务与协调·多方沟通协调 | `AdminButlerController` `/api/admin/butler/service-records`（多方记录）；`/api/admin/butler/assignments` | ✅ |
|
|
|
+| SC-H-04 | 人工介入与升级·升级与应急处理 | `AdminButlerController` `/api/admin/butler/unassign` / `toggle-accepting`（接管开关） | ⚠ 应急语义待核实 |
|
|
|
+| SC-H-05 | 资源对接与协同闭环·线下资源与活动对接 | `AdminButlerController` `/api/admin/butler/list`（资源清单）；`AIChatController` `/api/ai/gate` | ⚠ 对接语义待核实 |
|
|
|
+| SC-H-06 | 资源对接与协同闭环·与 AI 管家协同闭环 | `AIChatController` `/api/ai/butler/send`（AI→管家协同）；`/api/ai/chat/send` | ✅ |
|
|
|
+| SC-H-07 | 服务质量·服务质检与满意度 | `AdminButlerController` `/api/admin/butler/settlements` / `service-records`（质检台账） | ✅ |
|
|
|
+
|
|
|
+## 会话要求
|
|
|
+
|
|
|
+1. **端点核对 = 文档核对 + 端点比对**（防假 RED）：逐条用 grep 在 `cfc-backend/src/main/java` 实测定位端点载体，回填上表候选是否成立（✅/⚠/❌），确无载体的登记为契约缺口，不建伪实现任务。
|
|
|
+2. **先拉取**：开工前 `git fetch origin cfclub` 并基于 `origin/cfclub` 新建分支 `feature/evd14-ai-butler-contract`（独立 worktree，不与主工作树 WIP 冲突）。
|
|
|
+3. **产出 2 文件**：`docs/superpowers/specs/2026-11-07-ai-butler-contract.md`（新建）+ `docs/superpowers/api/API_REFERENCE.md` 追加 AI/Butler 域契约段（章节号 4.63 起，避开 EVD-9 孩子端 4.61 / EVD-13 家长域 4.61 / EVD-12R2 服务商域 4.62）。
|
|
|
+4. **完成后必须 push**：`git push -u origin feature/evd14-ai-butler-contract`，汇报 commit sha 与文件清单。
|
|
|
+5. 不改任何业务代码、不改测试文件、不动 `.tdd/`。
|
|
|
+
|
|
|
+## 交付
|
|
|
+
|
|
|
+契约文档 + API_REFERENCE 增补 + commit sha + 逐 SC 端点核对结论（满足/缺口）。
|
Agnes Agent