业务解决方案生成

核心任务

始终按以下流程完成交付：

1. 接收用户资料和调研记录。
2. 首轮先判断是否存在三方系统集成；若有集成，优先建议 351041-集成解决方案。
3. 若无集成，再按复杂度在 351042-简单解决方案 和 351043-中等解决方案 之间判断，并直接向用户确认。
4. 通过多轮追问补齐到“表单”层级；不清楚时继续问，不能盲猜。
5. 生成分析草案并等待确认。
6. 在用户确认模板且允许正式导出后，生成 Word 业务解决方案。

始终把输入资料、对话记录、分析草案和最终 Word 放在同一个案例目录里。

最小工作流

1. 在当前工作区根目录创建案例目录：/-<客户名或主题>/
2. 固定子目录：
• 01-输入资料-inputs
• 02-对话记录-dialog
• 03-分析草案-draft
• 04-正式输出-output
3. 将上传文件复制到 01-输入资料-inputs，不要移动原文件。
4. 在案例根目录维护 case-manifest.md。
5. 在 02-对话记录-dialog 维护 dialog-log.md。
6. 每轮确认后先更新这两个文件，再继续分析或输出。

如果用户已经上传了文件，优先运行：

python scripts/init_case_workspace.py --workspace "<workspace>" --name "<客户名或主题>" --inputs "<file1>" "<file2>"

该脚本会自动：

• 创建案例目录
• 复制上传文件到 01-输入资料-inputs
• 初始化 case-manifest.md
• 初始化 dialog-log.md

客户名或主题可以直接使用中文。若名称中含 Windows 不允许的字符，例如 < > : " / \ | ? *，需要替换或删除。

渐进式披露

默认只执行上面的核心流程。按需读取：

• references/case-workspace.md
• 需要确认案例目录结构、复制规则、输出目录和 _generated-assets 时再读
• references/template-selection.md
• 需要在 351041 / 351042 / 351043 中判断时再读
• references/solution-outline.md
• 开始写分析草案时再读
• references/example-outline.md
• 需要匹配既有示例风格时再读
• references/docx-export.md
• 准备导出 .docx 时再读
• references/team-setup.md
• 需要给同事安装、分发、导入 Codex 时再读
• references/persona.md
• 需要统一语气、边界和风险表达时再读

不要一次性把所有 reference 都读入上下文。

当前仅使用 3 个内置模板

Skill 运行时只使用 assets/templates/ 中的这 3 个文件：

• 351042 XX项目解决方案.docx
• 351043 XX集团项目解决方案.docx
• 351041 XX项目解决方案.docx

D:\项目\模板\ 只作为模板维护来源，不再作为运行依赖。

首轮必须完成的判断

首次收到内容后，不要直接写方案，先完成这 3 件事：

1. 判断是否存在三方系统集成、接口、同步、回写、反写。
2. 若无集成，再判断业务复杂度：
• 是否有后台数据维护层
• 子业务数量
• 表单数量
• 流程分支复杂度
• 是否需要权限说明
3. 直接向用户确认模板，不要静默决定。

推荐表达方向：

• “当前内容涉及三方系统集成和回写规则，我初步判断应使用 351041-集成解决方案，你确认我按这个模板继续吗？”
• “当前没有三方集成，但子业务和表单较多，还需要权限说明，我初步判断应使用 351043-中等解决方案，你确认吗？”
• “当前没有三方集成，结构较轻，适合按 351042-简单解决方案 推进，你确认吗？”

追问门槛

缺失关键内容时必须继续追问，至少补齐到“表单”层级后再允许正式导出。

至少检查这些信息：

• 业务概述是否明确
• 整体逻辑是否明确
• 后台数据维护项是否明确
• 子业务列表是否明确
• 每张表单是否至少有：
• 单据说明
• 单据样式
• 字段说明
• 流程图
• 权限说明（复杂业务时）

默认按结构化方式采集业务逻辑图，不再只收集审批节点。至少追问并确认：

• 系统边界或泳道划分
• 每条泳道对应的系统、角色或业务阶段
• 数据对象或基础档案
• 业务处理节点
• 节点之间的数据流向、触发关系或回写关系
• 前置数据、引用数据、附件或第三方输入
• 是否存在需要虚线框表示的组合节点或子区域

必须追问的典型场景：

• 用户只有业务主题，没有业务概述和整体逻辑
• 用户提到“表单”，但没有表样
• 用户提到“流程”，但没有节点和分支
• 用户提到“权限”，但没有角色与范围
• 用户提到“集成”，但没有对象、方向、回写规则
• 用户要求“逻辑图”，但只提供了审批链，没有说明数据来源、处理节点和流向

结构化数据约定

正式导出前使用 03-分析草案-draft/final-solution-data.json 作为结构化输入。当前支持两类写法：

1. 向后兼容写法

• business_overview: string[]
• module_overview: string[]
• document_description: string[]
• overall_logic_graph / module_logic_graph / process_flow:
• steps
• nodes + edges

2. 推荐写法

• business_overview:
• background
• goals
• scope
• pain_points
• expected_value
• module_overview:
• purpose
• scope
• upstream_downstream
• key_rules
• document_description:
• purpose
• trigger
• source_data
• processing_logic
• output_and_impact
• overall_logic_graph / module_logic_graph / process_flow 推荐使用：
• type: lane_flow
• lanes[{id,title,group_title}]
• nodes[{id,label,lane,shape,row}]
• edges[{from,to,label,style}]
• groups[]

lane_flow 的目标是表达“系统/泳道边界 + 数据对象 + 处理节点 + 数据流向”，不是普通审批流程图。

分析草案要求

• 草案文件：03-分析草案-draft/business-solution-analysis-draft.md
• 结构默认遵循 references/solution-outline.md
• 草案要先梳理：
• 业务概述
• 整体逻辑图
• 后台数据维护
• 子业务
• 表单
• 集成方案（仅 351041）
• 通用假设与待确认项

草案未确认前，不进入正式 Word 导出。

正式 Word 导出

• 导出脚本：scripts/export_solution_docx.py
• 数据模板：assets/workspace/final-solution-data-template.json
• template_type 只允许：
• 351041
• 351042
• 351043
• 正式导出前，必须明确 allow_assumption_export 是否为 true

导出质量要求：

• 方案标题、输出文件名和封面标题自动同步
• Word 目录默认展开到表单层
• 仅“章节 > 子业务/后台项 > 表单”使用 Heading
• “单据说明 / 字段说明 / 逻辑图 / 权限说明”等明细项不进入目录
• 每张表单必须有“单据样式”表格
• 每张表单必须有“字段说明”表格
• “整体逻辑图”和“流程图”自动生成图片并插入 Word
• 所有 [通用假设] 必须红色显示
• 生成的图片统一写入 04-正式输出-output/_generated-assets/

模板图形规则固定为：

• 351042: 仅输出 1 张整体业务逻辑图
• 351043: 输出 1 张整体业务逻辑图，并为每个子业务输出 1 张子业务逻辑图
• 351041: 输出 1 张整体业务逻辑图，并为每个子业务输出 1 张子业务逻辑图，同时保留集成解决方案章节

质量边界

• 不编造业务流程、表样、字段、集成方向或回写规则
• 事实、建议、假设必须分开写
• 未获用户明确允许时，不得带假设正式导出 Word
• 若允许带假设导出，必须显式标红
• 若关键逻辑图缺失，只能输出红字占位说明，不能伪造流程事实
• 输出必须能回溯到上传资料、调研记录或确认对话

资源导航

templates

• assets/templates/351042 XX项目解决方案.docx
• assets/templates/351043 XX集团项目解决方案.docx
• assets/templates/351041 XX项目解决方案.docx

examples

• assets/examples/requirements-spec-example.docx
• assets/examples/requirements-and-solution-example.docx
• assets/examples/research-solution-design-example.docx

workspace scaffolds

• assets/workspace/case-manifest-template.md
• assets/workspace/dialog-log-template.md
• assets/workspace/analysis-draft-template.md
• assets/workspace/final-solution-data-template.json

scripts

• scripts/export_solution_docx.py
• scripts/generate_user_guide_docx.py
• scripts/init_case_workspace.py
• scripts/build_share_package.py
• scripts/requirements.txt