AI 产品架构逆向分析

把用户可观察到的产品行为还原成可复核的产品架构。以证据为先，先识别产品领域，再选择对应的数据对象、工具、完成条件和风险检查。任何领域模板都只是分析路由，不代表目标产品实际采用相同字段或实现。

开始前

1. 明确目标产品、产品领域、当前分析阶段、证据所在位置和期望交付格式。
2. 若用户已经提供前序产物，先读取并复用，不要从头重复分析。
3. 若材料不足但仍可形成阶段性结论，继续工作并列出证据缺口；只有缺失信息会实质改变任务范围时才追问。
4. 需要查看页面时遵守只读边界。除非用户另行明确授权，不发送消息，不执行生成、代码修改、查询提交、外部通知、部署、重试、发布、删除、购买、充值、上传或覆盖产物。

领域路由

在建立架构前阅读 references/domain-profiles.md，只选择与目标产品相符的一个或多个领域配置：

• 通用 Agent 与任务执行
• AI 编程与应用构建
• AI 搜索与研究
• AI 数据分析与 BI
• AI 办公与内容生产
• AI 客服、销售与业务流程
• 多模态内容与创作

跨领域产品可组合配置，但必须保留统一的用户、会话、任务、工具执行、状态、权限、计费和评估主干。不要把视频领域的剧本、角色、场景和分镜字段套用到其他产品。

证据纪律

执行任何分析前，完整阅读 references/evidence-protocol.md。

关键原则：

• 从最早记录开始按时间顺序检查聊天、按钮、表单、任务卡、工作区、产物、历史、预览、模型设置、权限、计费和错误。
• Agent 说“已完成”只证明它说过；只有可见资产、状态变化或工具结果才能证明执行发生。
• Agent 的公开“思考完成”“规划完成”可作为功能判断摘要，不得声称读取隐藏思维链。
• 聊天、任务、工作区、产物库、执行记录或最终结果状态冲突时并列记录，不替产品选择一个“真相”。
• 页面未公开官方工具名时使用功能性名称，并注明“非官方工具名”。
• 后端语言、数据库、队列、云服务和模型厂商未被页面或官方资料直接支持时，不得写成事实。

选择分析模式

根据用户目标选择最小必要模式。完整方法见 references/analysis-workflow.md。

• 用户旅程模式：从输入需求到最终结果，梳理正常、修改、失败与中断路径。
• Agent 契约模式：识别实际出现的 Agent，拆解输入、判断、工具、输出、上下文和交接。
• 单 Agent Prompt 模式：为一个目标 Agent 编写功能等价 System Prompt；不冒充官方原文。
• 完整架构模式：整合用户流、Agent 控制流、工具流、数据流、产物流、模型接入、知识、状态、权限、计费、安全与基础设施。

若用户要求完整架构且前序材料已存在，先做差异检查，再直接进入完整架构模式；不要机械重做已经完成的阶段。

通用工作过程

1. 建立证据清单和编号，记录来源、时间顺序、截图或页面位置、原文、组件和可见结果。
2. 把观察拆成用户动作、界面反馈、Agent 回复、工具/状态结果、领域产物变化和异常六类事件。
3. 为每条结论标记证据等级，并把证据编号带入表格、节点和规则追溯。
4. 先还原 As-Is，再提出 To-Be。建议设计不得回写成当前产品能力。
5. 明确定义完成门：必需产物存在、结构化状态写入成功、领域验证通过、必要的用户确认记录存在、下游交接完整。
6. 检查修改后的依赖失效、局部重算、幂等重试、额度冻结、中断传播和状态一致性。
7. 生成用户要求的表格与图；复杂架构优先使用 Mermaid 或原生 HTML/CSS。
8. 做交付自检，列出无法访问和仍无法确认的问题，然后停止在用户指定边界。

输出与可视化

需要 HTML 或完整报告时，必须完整阅读：

• references/report-contract.md：单报告的内容契约。
• references/interactive-report-spec.md：复制、筛选、跳转、打印、导出和降级策略。
• references/deliverables.md：图表库、交付流程与验收门。

单报告交付原则

• 用户要求“完整拆解”或“最终报告”时，默认只交付 1 份最终 HTML。证据表、用户旅程、Agent 契约、工具、上下文、数据流、ER 图、时序图、主架构图、As-Is、To-Be、风险和未知项都应嵌入这一份报告，不再拆成多份阶段文件。

• “完成图表”不等于“完成报告”。最终文件必须同时包含可读结论、结构化表格、证据追溯和可复用的图源码。

• 优先复用 assets/report-template.html 的交互外壳，按实际证据替换所有占位内容；不得把模板文案当成产品事实。

• 交付前运行 python3 scripts/validate_report.py <report.html>。验证未通过时不得声称完成。

• 默认交付单文件、UTF-8、响应式 HTML，内联样式，清晰图例和目录。

• 每张 Mermaid 图必须同时提供可见源码、一键复制和 .mmd 下载；节点或边必须能回溯证据编号或证据等级。

• 证据和追溯表必须支持证据等级筛选；长表应支持 CSV 导出；报告必须支持打印/另存 PDF。

• Mermaid 加载失败不能让核心信息消失；同时提供文字说明、表格或可读的源码回退。

• 若用户需要“链接直接打开”，保存到用户可访问的工作目录并返回绝对路径 Markdown 链接。

• 若用户明确要求上线，再使用可用的网站托管能力；发布前不得擅自上传本地证据或敏感素材。

停止条件

• 达到用户指定交付阶段后停止，不自动进入下一阶段。
• 只读证据无法继续访问时，报告缺口，不绕过安全限制。
• 需要外部写入、购买、发布、权限变化或可能扣费时，取得相应授权后再执行。
• 证据不足以确认时保留为未知，不用“行业通常如此”补成事实。