QDKT6-3 AI数据分析报告生成平台需求分析+功能拆解：用Claude Code subagent输出PRD与TaoToken配置骨架

1. 从一句需求到一份能落地的 PRD中间到底缺了什么如果你正在做 AI 数据分析报告生成平台大概率会遇到一个很具体的困境脑子里知道要做什么——用户上传 Excel输入分析需求系统自动写 Python 代码跑数据最后吐出一份带图表的可视化报告——但真要把这些东西写成一份开发能看懂、自己能跟做的 PRD就卡住了。功能清单写不细接口定义写不准数据流图画出来自己都觉得逻辑不通。我试过用单个对话窗口硬扛整个需求分析流程结果是上下文越堆越长写到后面 AI 已经忘了前面定义的用户角色功能模块之间开始互相矛盾。后来换成 Claude Code 的 subagent 机制把需求分析、功能设计、接口定义、PRD 汇总拆成四个独立角色每个角色只关心自己那一块主 agent 负责调度和上下文传递输出质量明显稳定了。这篇要交付的东西很具体一份可复制的settings.json与config.toml配置骨架、TaoToken 统一 Key 的接入步骤、subagent 的任务拆分方式以及 PRD 产出后的验证动作。目标是一次跑通从需求分析到 PRD 输出的完整链路。适合正在搭 AI 数据分析平台、需要快速产出产品文档的开发者也适合想理解多智能体协作逻辑的产品同学。核心检索词先摆清楚Claude Code 是 Anthropic 出的命令行编程助手subagent 是它支持的多角色协作机制PRD 是产品需求文档Node.js 是运行环境API Key 是调用大模型的凭证。这几个东西串起来就是本篇的完整工作流。2. 前置准备Node.js 环境与 TaoToken 统一 Key 接入2.1 Node.js 安装与验证Claude Code 跑在 Node.js 上这一步绕不过去。去 Node.js 官网下载 LTS 版本双击安装全程默认配置不要自定义安装路径。装完之后关掉所有终端窗口重新打开让环境变量生效。验证两条命令node -v npm -v能打印出版本号就说明环境没问题。如果提示「不是内部或外部命令」说明安装时没勾选「添加到环境变量」重新装一遍并勾选即可。2.2 为什么用 TaoToken 统一 Key做数据分析平台你大概率不会只用一个模型。需求分析可能用推理强的代码生成可能用写代码好的PRD 汇总可能用长文本能力强的。如果每个模型都去单独申请 Key、单独配 base URL配置管理会变得很碎。TaoToken 的思路是提供一个统一的 API 入口你只需要一个 Key就能在多个模型之间切换。对于 subagent 场景特别合适——不同子 agent 可以指向不同模型但底层凭证是同一套。接入地址官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 端点https://taotoken.net/api2.3 获取 API Key进入控制台创建 Key# 控制台地址创建和管理 API Key https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite创建完成后复制 Key妥善保存。这个 Key 后面会写进 Claude Code 的配置文件里。2.4 安装 Claude CodeMac 和 Windows 指令不同别混输# Mac npm install -g anthropic-ai/claude # Windows带镜像加速 npm install -g anthropic-ai/claude --registryhttps://registry.npmmirror.com/安装完成后终端没有红色报错即成功黄色警告可以忽略。3. 可复制配置settings.json 与 config.toml 骨架3.1 配置文件放在哪Claude Code 的配置分两层全局配置放在用户目录下的.claude文件夹项目级配置放在项目根目录。做数据分析平台这种多角色协作的项目建议用项目级配置方便版本管理和团队共享。项目结构大致长这样data-report-platform/ ├── .claude/ │ ├── settings.json │ └── agents/ │ ├── requirements.md │ ├── functional.md │ ├── api-design.md │ └── prd-writer.md ├── config.toml └── CLAUDE.md3.2 settings.json 配置骨架这个文件定义 Claude Code 的运行参数包括模型端点、权限模式、subagent 加载路径{ model: claude-sonnet-4-20250514, apiKey: sk-your-taotoken-key-here, baseUrl: https://taotoken.net/api, permissions: { allowFileWrite: true, allowShellExec: true, dangerouslySkipPermissionChecks: true }, agents: { directory: .claude/agents, autoLoad: true }, output: { language: zh-CN, format: markdown } }几个关键参数说明参数作用建议值baseUrlAPI 端点https://taotoken.net/apiapiKey统一凭证你的 TaoToken KeydangerouslySkipPermissionChecks免频繁授权开发阶段 trueagents.autoLoad自动加载子 agenttrue3.3 config.toml 配置骨架如果你更习惯 TOML 格式或者项目里已经有 TOML 配置体系可以用这个骨架[model] provider taotoken base_url https://taotoken.net/api api_key sk-your-taotoken-key-here default_model claude-sonnet-4-20250514 [agents] directory .claude/agents auto_load true max_concurrent 4 [agents.models] requirements claude-sonnet-4-20250514 functional claude-sonnet-4-20250514 api_design claude-sonnet-4-20250514 prd_writer claude-sonnet-4-20250514 [output] language zh-CN format markdown save_path ./outputmax_concurrent控制同时运行的子 agent 数量四个角色刚好对应四个子 agent设成 4 比较合适。3.4 环境变量方式临时测试用不想写配置文件的话临时用环境变量也能跑# Mac export ANTHROPIC_API_KEYsk-your-taotoken-key-here export ANTHROPIC_BASE_URLhttps://taotoken.net/api # Windows PowerShell $env:ANTHROPIC_API_KEYsk-your-taotoken-key-here $env:ANTHROPIC_BASE_URLhttps://taotoken.net/api这种方式重启终端就失效适合快速验证配置是否通。4. subagent 任务拆分与 PRD 生成实操4.1 四个子 agent 的职责划分数据分析报告生成平台的需求拆解我把它分成四个角色每个角色一个提示词文件requirements.md — 需求分析智能体负责输出产品定位、目标用户画像、核心痛点、竞品功能对照。提示词里要约束它不要编造市场数据所有竞品信息必须标注来源或标记为待验证。functional.md — 功能设计智能体负责把需求翻译成功能清单、信息架构、核心数据流。这个角色最关键因为数据分析平台的核心逻辑——上传 Excel → 解析数据 → AI 写代码 → 运行分析 → 流式输出报告——必须在这里定义清楚。api-design.md — 接口定义智能体负责定义前后端接口、数据模型、关键字段。比如文件上传接口的请求格式、分析任务的异步回调机制、报告生成的状态流转。prd-writer.md — PRD 汇总智能体负责合并前三个角色的输出生成完整 PRD 文档包含产品概述、功能清单、接口定义、数据流图、验收标准。4.2 子 agent 提示词模板每个子 agent 文件的结构大致如下以 functional.md 为例--- name: 功能设计智能体 description: 负责将需求转化为功能清单、信息架构和数据流定义 model: claude-sonnet-4-20250514 color: green --- 你是一个数据分析平台的功能设计专家。你的任务是 1. 接收需求分析智能体输出的用户画像和痛点 2. 输出功能清单按优先级分为 P0/P1/P2 3. 定义信息架构画出页面层级关系 4. 描述核心数据流特别是「上传→解析→分析→报告」的完整链路 5. 标注每个功能的输入、处理逻辑、输出 约束 - 功能清单不超过 15 项优先保留核心功能 - 数据流必须包含异常分支解析失败、代码报错、超时 - 输出格式为 Markdown中文4.3 主 agent 调度提示词项目根目录的 CLAUDE.md 定义主 agent 的行为你是数据分析报告生成平台的产品负责人。你的职责是 1. 接收用户的产品需求描述 2. 将需求分解为四个子任务依次调用 - 需求分析智能体requirements - 功能设计智能体functional - 接口定义智能体api-design - PRD 汇总智能体prd-writer 3. 每个子任务完成后审核输出质量不合格则要求重做 4. 最终交付一份完整的 PRD 文档保存到 ./output 目录 调度规则 - 前一个子 agent 的输出作为后一个的输入 - 如果某个子 agent 输出缺少关键信息补充上下文后重新调用 - 全部完成后输出一份交付清单4.4 启动与验证确保终端在项目根目录启动 Claude Codecode --dangerously-skip-permission-checks进入交互界面后输入/agents查看子 agent 是否加载成功。显示四个角色名称即配置正确。然后输入产品需求开发一款数据复盘报告网页应用。用户上传 Excel 表格并输入分析需求 系统调用大模型自主规划分析流程逐步生成 Python 代码并运行 最终输出一份满足需求的可视化分析报告。 请设计产品定位生成完整 PRD 文档和接口定义。主 agent 会自动分解任务依次调用四个子 agent。每个子 agent 工作时会显示不同颜色方便区分进度。4.5 产出物检查跑完之后项目目录下会生成output/ ├── requirements-analysis.md # 需求分析报告 ├── functional-spec.md # 功能清单与数据流 ├── api-definition.md # 接口定义 └── PRD-final.md # 完整 PRD重点检查 PRD-final.md 里的数据流部分确认「上传 Excel → 解析 → AI 写代码 → 运行 → 流式输出 → 生成报告」这条链路完整异常分支有覆盖。5. 验证请求与成功结果确认5.1 配置验证启动 Claude Code 后输入/status查看当前配置Base URL: https://taotoken.net/api Model: claude-sonnet-4-20250514 API Key: sk-****已配置 Agents: 4 loaded确认 base URL 指向 TaoToken 端点模型名称正确四个子 agent 已加载。5.2 单模型连通性测试在 Claude Code 界面里直接问一句请用一句话说明你能做什么。能正常返回中文回答说明 API Key 和端点配置没问题。5.3 subagent 调用测试输入一个简单任务验证调度逻辑请调用需求分析智能体输出一个数据分析平台的目标用户画像。观察是否触发了 requirements 子 agent输出是否符合提示词约束。5.4 PRD 完整性验证清单PRD 生成后用这份清单逐项核对检查项合格标准产品定位一句话说清目标用户和核心价值用户画像至少 2 个角色有具体使用场景功能清单P0 功能不超过 8 项每项有输入输出定义数据流覆盖主流程 至少 3 个异常分支接口定义关键接口有请求/响应示例验收标准每个 P0 功能有可测试的验收条件如果某项缺失直接在 Claude Code 里要求补充PRD 中接口定义部分缺少文件上传接口的请求格式请补充。6. 本篇常见错排查6.1 子 agent 加载失败输入/agents没有显示任何角色。检查三点.claude/agents/目录是否存在提示词文件后缀是否为.md启动 Claude Code 时是否在项目根目录。文件名大小写敏感Requirements.md和requirements.md是两个不同的文件。6.2 API Key 无效/status显示 Key 无效或 401 错误。先确认 Key 复制完整没有多余空格。然后确认 base URL 是https://taotoken.net/api不要多加/v1或路径后缀。如果用的是环境变量方式重启终端后需要重新 export。6.3 任务执行中断子 agent 跑到一半停了。常见原因是上下文超限或网络波动。解决办法把大任务拆小一次只让一个子 agent 处理一个模块或者在 settings.json 里把max_concurrent调低减少并发压力。6.4 生成的 PRD 逻辑矛盾功能清单和数据流对不上比如功能里写了「支持多文件上传」但数据流只描述了单文件处理。这是因为子 agent 之间上下文传递不完整。在主 agent 提示词里加一条约束每个子 agent 的输出必须包含「上游依赖」和「下游影响」两个字段方便主 agent 校验一致性。6.5 中文乱码输出文档出现乱码。在 settings.json 里确认output.language设为zh-CN同时在主 agent 提示词里明确要求「所有输出使用中文格式为 UTF-8 Markdown」。6.6 权限频繁弹窗每次文件写入都弹出授权确认。启动时加上--dangerously-skip-permission-checks参数或者在 settings.json 里把dangerouslySkipPermissionChecks设为true。注意这个选项只建议在开发阶段使用。7. 接入文档与后续动作配置骨架和 subagent 拆分逻辑跑通之后下一步是把这套流程固化到日常开发里。几个建议把.claude/agents/目录纳入版本管理提示词模板的迭代和代码一样需要追踪变更。每次调整子 agent 的职责边界都记录一下改动原因方便回溯。如果你需要更细的接入参数说明可以查阅接入文档# 接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite需要管理多个项目的 Key 时去 API Keys 页面创建独立凭证# API Keys 管理 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite想快速验证某个模型对 PRD 类长文本的输出质量可以直接在模型对话里试# 模型对话 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite如果后续要把这套 subagent 流程用于长期编码任务比如持续迭代数据分析平台的代码可以了解 Coding Plan# Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite最后说一个实操中容易忽略的点subagent 的输出质量高度依赖提示词的约束精度。第一版提示词写完之后至少跑三轮不同的需求输入观察哪些地方输出不稳定然后针对性加约束。比如发现功能设计 agent 总是漏掉异常分支就在提示词里强制要求「每个功能必须列出至少两个异常场景」。这种迭代比一次性写一个完美提示词更实际。