这不是 PRD，是把
docs/backend-prd-v2.md/docs/frontend-prd-v2.md/docs/frontend-style.md/docs/prd-redesign-ai-collaborator.md/docs/wenjin-agent-prototype.html描述的"AI 全程协作者"重构，拆成 AI coding agent 可以逐个领取、独立执行、独立验收的模块。业务细节一律不复述，只给坐标：目标、涉及文件、依赖、验收标准出处。
- 挑一个状态为 ⬜/🔄 且依赖已全部 ✅ 的模块（见 §4 执行顺序），把该模块整段喂给 agent。
- 验收标准列的是 PRD 章节号，不是本文重复的文字——做完对照该章节自检，不要凭本文猜测细节。
- 完成后按
CLAUDE.md「文档同步」表更新对应文档，并回来把这份文件里的模块状态改掉（✅/🔄/⬜）。 - 模块粒度以"一次可独立提交"为准；一个模块内部要不要再拆子任务，由执行的 agent 自己用 TodoWrite/TaskCreate 管理，本文不下沉到函数级别。
状态图例：✅ 已完成并已提交 · 🔄 进行中（有未提交改动）· ⬜ 未开始
Wave 1（B4 收尾、B5、B7、F3）已全部完成并通过验证（后端 113 项 pytest + 手工浏览器验证建档流程；详见各模块状态）：
- B4：
/reports/{id}/refine局部重新生成——审查确认原有未提交改动已完整实现（create_refine_graph/run_refine/接口/patch 构建），补跑测试验证。 - B5：新增用户侧协作 SSE 事件
agents_parallel_started/merged、self_check_round、degraded_notice；同时修复了一个真实缺口——GET /agent/runs/{id}/events之前没有过滤debug:前缀事件，会把 Admin 调试事件泄漏给普通用户 SSE，现已修复。 - B7：candidate 新增
matching_confidence_score/historical_ranks，报告新增condition_commentary（含 version=1 基础版走引导性点评的分支）。 - F3：新增
lib/profileFieldSchema.ts+components/profile/{FieldControl,ClarificationBubble,ProfileChatFlow}.tsx，替换旧的 6 步固定表单向导（ProfileStepper.tsx已删除），/profile页面改为对话式逐字段收集 + 后端/profile/field-check矛盾检测。浏览器验证时发现并修复了一个字段切换时数字输入框残留旧值的 bug（FieldControl缺少key）。
顺带修复（不在 Wave 1 模块范围内，但阻塞验证/属于文档同步硬性要求）：
- 测试基础设施：
test_rules.py/test_scoring.py的 SQLite fixture 对全量Base.metadata.create_all会因 JSONB 列报错，改为只建所需表；删除了整份测试 v1.1 已移除的人工复核（HITL）功能的test_human_review.py，修正test_reflection_agent.py里 3 个仍断言human_review路由的过期用例。 backend/docs/02_agent_design.md：整份重写，移除已删除多个版本的 HITL 章节，补充refine_graph、当前真实的并行实现方式（条件边返回多目标，不是Send()API）、新增 SSE 事件的两层设计说明。
Wave 2（F2、F4、F5）已全部完成并通过验证（后端 113 项 pytest 保持通过 + 前端 next build 干净 + 浏览器实测完整走通"建档→生成→报告"链路，/ 与 /reports/[id] 两个入口都验证过）：
- 新增共享基础设施：
hooks/useAgentRunStream.ts（统一封装 Agent run SSE：断线重连、25s 无业务事件兜底轮询、事件白名单收集，取代旧版reports/generating页面里内联的一次性实现）、lib/reportMapping.ts（ApiReport→ReportViewModel映射，从旧/reports/[id]/page.tsx抽出）。 - F4：
components/chat/InlineGenerationCard.tsx，消费useAgentRunStream派生出并行分组/自我检查分组/降级提示的时间线，默认折叠只显示当前阶段摘要。 - F5：
components/report/{ReportCanvas,LiveReportPanel,ConditionCommentaryCard,DecisionReplayCard}.tsx，实现空/基础版/偏好更新版三态，ReportCanvas同时被/和/reports/[id]复用；新增ConditionCommentaryCard（消费 B7 的condition_commentary）和DecisionReplayCard（只读回放run_summary_json，之前后端已写但前端从未消费）。 - F2：
components/layout/WorkspaceShell.tsx（左右双栏骨架，折叠不卸载 DOM）+components/workspace/ConversationStream.tsx（/页面左栏：建档→生成→问答三阶段同一条对话流）+components/chat/ChatColumn.tsx（取代旧版ChatPanel.tsx的固定定位抽屉，改为可嵌入的常驻列）。重写app/page.tsx（默认首页即对话建档 + 实时报告面板）和app/reports/[id]/page.tsx（同一套组件复用，直接从report_id进入）；下线app/assess、app/profile、app/reports/generating、app/volunteer-check四个独立路由和components/entry/EntryCard.tsx、components/profile/ProfileStepper.tsx（已在 F3 时删除）；lib/store.ts清理了只服务于已删除页面的wizardStep/assessFormData/isChatPanelOpen/openChatPanel/closeChatPanel。报告拿到report_id后用window.history.replaceState无刷新切换地址栏到/reports/[id]（不触发 Next 路由导航，避免组件树被卸载重挂载，真正做到"同一组件树的路由标注变化"）。 - 浏览器验证时发现并修复一个真实 bug：
ConversationStream/ProfileChatFlow场景下没有触发，但在/reports/[id]单独访问时发现 TopNav 渲染成浅色——见下方"顺带修复"。
Wave 2 补丁（对齐 docs/wenjin-agent-prototype.html）：Wave 2 首版把 F3 的建档字段渲染成了"逐条对话气泡"（一次问一个字段），用户反馈这与原型事实源不符——原型第 1039-1131 行明确是一张卡片里的两列网格表单（"基础建档信息"）+ 提交后出现的"已采集信息"（mini-grid 摘要）、"档案摘要"（summary-row 状态表）两张卡片 + 底部自然语言输入框补充偏好，不是逐字段轮流提问。已重做：
components/profile/{ProfileCaptureCard,CapturedInfoSummary,ProfileSummaryStatus,PreferenceComposer,PreferenceCard}.tsx（新增，替代旧版FieldControl.tsx，已删除）：ProfileCaptureCard一次性渲染所有必填字段（field-grid两列网格），点提交时才统一调用一次/profile/field-check做位次/选科矛盾检测；PreferenceComposer复刻原型的自由文本输入框 + 关键词正则识别偏好意图，命中时展示"推荐偏好"卡片（这部分暂为展示层，真正接成/refine局部重新生成是 F6 范围，未接通，已在组件注释里注明）。- 顺带修了一个无障碍 bug：
<label>包裹自定义按钮组（批次/性别选择）导致按钮可访问名称被拼接了外层文字，改成<div>只在真正包裹<select>/<input>时用<label>。 - 修了一个编排 bug：
ConversationStream.tsx之前在stage切到generating/chat后直接卸载了ProfileChatFlow，导致提交后"已采集信息"/"档案摘要"两张卡片和偏好输入框根本没机会渲染；改为ProfileChatFlow全程常驻，由它自己管理"表单/已提交"两态。
设计系统回退（v2.4）：v2.3 的深紫黑深色主题用户实测反馈"看着不舒服"，整体改回纯白背景浅色主题，色值直接采用 wenjin-agent-prototype.html 的 :root 变量（蓝 #1E40AF/绿 #16A34A/橙 #D97706/红 #DC2626，中性色 #0F172A/#64748B/#94A3B8/#E2E8F0）。docs/frontend-prd-v2.md §3 已同步改写为 v2.4，docs/frontend-style.md（深色分析文档）标注废弃仅留历史参考。涉及改动：
app/globals.css/tailwind.config.ts基础层 + 之前深色化过的全部组件（TopNav/WorkspaceShell/Button/Card/Badge/RiskOverview/PlanTabs/CandidateCard/EvidenceDrawer/ConditionCommentaryCard/DecisionReplayCard/LiveReportPanel/ReportCanvas/ChatInput/ChatMessageBubble/ChatSuggestedQuestions/ChatColumn/InlineGenerationCard/ProfileCaptureCard/CapturedInfoSummary/ProfileSummaryStatus/PreferenceComposer/PreferenceCard/ClarificationBubble）全部改回浅色 token。/admin/debug不受影响（本来就没跟深色主题走，也没用这批共享组件）。- 后续任何新组件配色直接参考
frontend-prd-v2.mdv2.4 §3.2 色值表或wenjin-agent-prototype.html的:root变量，不要再引入深色 token。
已知但未处理（超出 Wave 1/2 声明范围，供后续排期）：
gender/has_physical_limits只在建档字段依赖图（_FIELD_ORDER）里出现，StudentProfile模型和ProfileIn都没有对应持久化字段——前端填了也会被后端静默丢弃。体检限制是 CLAUDE.md 里明确的高风险约束，建议单独排一个模块补上模型字段 + 迁移。components/report/EvidenceDrawer.tsx仍是移动端底部 Sheet 布局，未改造成 frontend-prd-v2 §6.2 要求的桌面端右侧滑出抽屉（只做过配色调整，没动布局）。- F8（历史位次/匹配置信分/AI 点评在候选卡片上的呈现）尚未做：后端 B7 已经在
candidate.matching_confidence_score/historical_ranks和plan_json.condition_commentary里回传了数据，ConditionCommentaryCard也已经在 ReportCanvas 里消费了condition_commentary，但CandidateCard.tsx还没展示matching_confidence_score/historical_ranks这两个新字段。 - Wave 2 过程中曾发现一个影响全站的真实 bug（现已随设计系统回退一并解决）：
app/layout.tsx里有一大段 Phase1 深色主题改造前遗留的内联criticalCss（<style dangerouslySetInnerHTML>），定义了.wj-topnav/.wj-button-*/.wj-card/.wj-input等类名的旧浅色样式，和当时的 Tailwind 深色类同优先级但顺序更靠后，导致 TopNav、按钮、输入框等全局组件实际渲染错乱。已整段删除该内联样式块；/admin/debug全程不受影响（未使用这批共享组件）。
未开始：
- B6 ConversationAgent tool-calling 化
- F6（ConversationAgent 前端联调：
ui_action/refine_confirm_required事件处理、版本切换器）、F7（方案对比视图）、F8（候选卡片信息密度升级）
前端 (Next.js App Router)
├─ pages 层 app/* — 路由与页面组合
├─ Generative UI 组件层 components/* — 对话卡片、结构化控件、报告画布
├─ 状态层 lib/store.ts (Zustand) + TanStack Query
└─ BFF app/api/backend/* — 鉴权转发、SSE 代理
后端 (FastAPI)
├─ API 层 app/api/v1/* — 同步请求处理
├─ Agent 层 app/agent/* — LangGraph 主链路 + ConversationAgent
├─ 确定性引擎层 app/engine/* — rules/scoring/risk_engine/planner
└─ 数据层 app/models/* + alembic — ORM + 迁移
前后端通过 REST + SSE（sse:{run_id} Redis Stream）交互，State schema 见 backend/app/agent/state.py。
| ID | 模块 | 状态 | 目标 | 涉及文件 | 依赖 | 验收标准 |
|---|---|---|---|---|---|---|
| B1 | 数据模型基线 | ✅ | 版本血缘、debug摘要等字段迁移 | models/report.py, models/agent_run.py, alembic |
— | backend-prd-v2 §6 |
| B2 | 匿名会话 | ✅ | 匿名建档 + 登录后绑定 | api/v1/auth.py |
— | backend-prd-v2 §5.1 |
| B3 | 建档字段依赖图 + Profile Agent 追问 | ✅ | /profile/field-check，矛盾检测走规则、追问走 Agent |
api/v1/profile.py, agent/nodes/profile_agent.py |
B1 | backend-prd-v2 §5.6, §10.1 |
| B4 | 报告局部重新生成 /refine |
✅ | 轻量约束只重跑 Recommendation→Risk→Report，复用 checkpoint 证据 | agent/graph.py, worker.py, api/v1/reports.py, agent/state.py |
B1 | backend-prd-v2 §5.9, §14.1 对应条目 |
| B5 | 用户侧协作 SSE 事件扩展 | ✅ | 新增 agents_parallel_started/merged、self_check_round、degraded_notice，复用已有 Debug 事件做"技术→友好文案"转译；用户侧端点过滤 debug: 前缀 |
agent/graph.py, agent/nodes/retrieval_agent.py, agent/user_events.py（新增）, api/v1/agent.py |
B1 | backend-prd-v2 §5.7, §2.3(prd-redesign) |
| B6 | ConversationAgent tool-calling 升级 | ⬜ | 从纯 streaming 升级为 5 个工具（4 UI 操作类 + 1 数据变更类），先做 Kimi k2.6 流式+工具调用的 spike 验证 | agent/conversation_agent.py, api/v1/chat.py |
B4（regenerate_recommendations 要调用 /refine） |
backend-prd-v2 §5.10, §10.9；建议先起一个独立 spike 任务验证技术可行性，再落地正式实现 |
| B7 | 报告呈现字段升级 | ✅ | 候选项加 matching_confidence_score/historical_ranks，报告加 condition_commentary |
agent/nodes/recommendation_agent.py, agent/nodes/report_agent.py, engine/scoring.py, api/v1/mock_data.py |
B1 | backend-prd-v2 §6.4 |
| ID | 模块 | 状态 | 目标 | 涉及文件 | 依赖 | 验收标准 |
|---|---|---|---|---|---|---|
| F1 | 深色设计系统 | ✅（基础） | 色彩/字体/间距/圆角落地，Admin 保持浅色不迁移 | app/globals.css, components/ui/* |
— | frontend-style.md, frontend-prd-v2 §3 |
| F2 | 建档+报告统一页面骨架 | ✅ | / 改为左右双栏（对话 + 实时报告面板三态），下线 /assess//profile//reports/generating//volunteer-check 独立路由 |
app/page.tsx, app/reports/[id]/page.tsx, components/layout/WorkspaceShell.tsx（新增）, components/workspace/ConversationStream.tsx（新增）, components/chat/ChatColumn.tsx（替代 ChatPanel.tsx） |
F3（控件渲染需要先有） | frontend-prd-v2 §4.3, §6.1, §6.2 |
| F3 | Generative UI 结构化控件渲染器 | ✅ | 字段 schema → 控件类型映射，前端字段依赖图（配置驱动，零 LLM） | lib/profileFieldSchema.ts（新增）, components/profile/*（替换 ProfileStepper.tsx） |
B3 | frontend-prd-v2 §6.1「确定性逻辑与 Agent 边界」表 |
| F4 | 对话内生成过程卡片 | ✅ | InlineGenerationCard：并行分组、自我检查分组、降级提示 |
hooks/useAgentRunStream.ts（新增）, components/chat/InlineGenerationCard.tsx（新增） |
B5 | frontend-prd-v2 §6.1「对话内生成过程卡片」表 |
| F5 | 实时报告面板三态 + 与报告工作台共享组件 | ✅ | 空/基础版/偏好更新版；/ 与 /reports/[id] 复用同一组件树 |
lib/reportMapping.ts（新增）, components/report/{ReportCanvas,LiveReportPanel,ConditionCommentaryCard,DecisionReplayCard}.tsx（新增） |
B4, F2 | frontend-prd-v2 §6.1「实时报告面板」表, §6.2 |
| F6 | ConversationAgent 前端联调 | ⬜ | 处理 ui_action/refine_confirm_required SSE 事件、版本切换器 ReportVersionSwitcher |
components/chat/ChatPanel.tsx, components/report/*（新增版本切换器） |
B6, B4 | frontend-prd-v2 §6.2「报告对话意图处理」表 |
| F7 | 方案对比视图 | ⬜ | PlanCompareView：手动勾选 + 对话触发共用一套组件 |
components/report/*（新增） |
B6（对话触发需要 open_compare_view；手动入口可先行不必等 B6） |
frontend-prd-v2 §6.2「方案对比视图」 |
| F8 | 候选卡片/AI 点评呈现优化 | ⬜ | 展示历史位次、匹配置信分、生成后 AI 点评卡片 | components/report/CandidateCard.tsx |
B7 | frontend-prd-v2 §6.2「推荐卡片」「生成后 AI 点评卡片」 |
| 波次 | 模块 | 说明 |
|---|---|---|
| Wave 1 ✅ | B4（收尾）、B5、B7、F3 | 已完成——均无阻塞依赖，可立即并行；F3 依赖已完成的 B3 |
| Wave 2 ✅ | F2、F4、F5 | 已完成——F2 依赖 F3 产出的控件渲染器；F4 依赖 B5 的新事件；F5 依赖 B4 |
| Wave 3 | B6 | 建议单独起一个 spike 任务验证 Kimi 流式+工具调用可行性，再做正式实现；不阻塞 Wave 1/2 |
| Wave 4 | F6、F7、F8 | F6 依赖 B6+B4+F5；F7 依赖 B6（对话触发）但手动入口部分可提前做；F8 依赖 B7，且现在 F5 已落地 ReportCanvas，F8 只需改 CandidateCard.tsx 一个文件 |
F2（下线旧路由、合并页面骨架）改动面最大，建议单独一个 PR，不与其他前端模块混在一起提交，避免难以 review。
- 不做：文件上传/OCR、独立
/compare对比中心、支付订单、人工复核——这些是 Phase 2 或明确不做项，见 prd-redesign-ai-collaborator.md §5 和 backend-prd-v2 §10.1「Phase 2 后端方向」。 - 不做：Admin Debug 控制台改造——保留现状，不因本次重构变更（prd-redesign-ai-collaborator.md §4「明确不做」）。
- 完成任一模块后按
CLAUDE.md「文档同步」表检查是否需要同步docs/backend-prd-v2.md/docs/frontend-prd-v2.md/CLAUDE.md本身。