调研清单生成

核心目标

• 先梳理用户材料，再补齐调研问题，不直接写正式业务解决方案。
• 先判断“标准产品能力 / CAP4 配置能力 / 接口集成能力 / 运维部署约束 / 客户待确认”，再生成清单和交棒底稿。
• 输出必须能直接交给 $business-solution-writer 继续做模板判断、补充追问和成稿。
• 上传文件、调研结果和后续方案默认放在同一个案例包根目录，避免文件散落。

固定工作流

1. 初始化统一案例包

   • 优先运行 scripts/init_research_workspace.py 创建标准目录和模板文件。
   • 如果用户已经给出一个案例包目录，则在原目录内增量更新，不要重新拆目录。
   • 将用户上传资料复制到 01-输入资料-inputs/，不要移动原文件。

2. 先读规则，再读知识源，再读用户材料

   • 先读 references/05-handoff-spec.md，明确交付物结构和字段口径。
   • 再按需读取：
     • references/01-product-docs.md
     • references/02-cap4-and-app-platform.md
     • references/03-integration-and-api-boundaries.md
     • references/04-ops-and-deployment-notes.md
   • 最后读取用户上传材料，抽取合同范围、目标模块、表单、流程、角色、权限、集成、环境和版本信息。

3. 补客户、行业和案例资料

   • 涉及联网调研时，调用 $smart-search，不要随意改成泛搜索。
   • 默认研究范围：客户公开资料、行业/监管背景、相似案例。
   • 搜索结果只作为“公开资料/外部案例”，不能写成客户既成事实。

4. 生成清单与底稿

   • 维护 research-manifest.md 和 02-调研记录-research/dialog-log.md。
   • 生成或更新 03-调研清单-checklist/research-checklist.xlsx。
   • 生成或更新 04-交接材料-handoff/solution-writer-handoff.md。
   • 处理 .xlsx 时，调用 $Excel。

5. 多轮确认

   • 对不清楚项继续追问，直到 P0必须 项达到“已确认”或“待用户确认”。
   • 追问优先级：
     • 这是标准产品能力、CAP4 配置能力，还是接口/定制诉求？
     • 是否涉及外部系统同步、回写、统一认证、组织同步？
     • 是否有部署、环境、版本或移动端前提？

6. 交棒给下游技能

   • 交棒物固定为：
     • 03-调研清单-checklist/research-checklist.xlsx
     • 04-交接材料-handoff/solution-writer-handoff.md
   • 后续方案草稿与正式输出默认写入同一个案例包内的 05-方案草稿-draft/ 和 06-正式输出-output/。
   • 默认交棒语境：让 $business-solution-writer 基于同一个案例包继续模板判断和方案追问，而不是重新从零梳理。

输出目录与文件

标准目录如下：

/-<客户或主题>-案例包/
├─ 01-输入资料-inputs/
├─ 02-调研记录-research/
│  └─ dialog-log.md
├─ 03-调研清单-checklist/
│  └─ research-checklist.xlsx
├─ 04-交接材料-handoff/
│  └─ solution-writer-handoff.md
├─ 05-方案草稿-draft/
├─ 06-正式输出-output/
└─ research-manifest.md

固定文件用途：

• research-manifest.md
  • 跟踪输入资料、已确认事实、能力边界判断、开放问题和下一步动作。
• dialog-log.md
  • 记录每轮对话、检索结果、确认项和新增问题。
• research-checklist.xlsx
  • 正式的调研清单，供用户继续补充，也供下游技能读取。
• solution-writer-handoff.md
  • 给 $business-solution-writer 的结构化交棒底稿。
• 05-方案草稿-draft/
  • 预留给下游技能写分析草稿或过渡材料。
• 06-正式输出-output/
  • 预留给下游技能写正式方案、Word 或其他最终交付物。

清单字段规则

research-checklist.xlsx 固定列为：

• 序号
• 调研对象
• 调研内容
• 优先级
• 信息来源
• 能力归因
• 对应方案输出项
• 确认状态
• 备注

字段口径固定：

• 优先级
  • 只允许：P0必须、P1高、P2补充
• 能力归因
  • 只允许：官方产品能力、CAP4配置能力、接口/集成能力、运维/部署约束、客户待确认
• 确认状态
  • 只允许：已从材料确认、待用户确认、需联网补充、不适用
• 对应方案输出项
  • 只写下游技能能直接消费的标签，例如：业务概述、模块概述、后台数据维护、表单说明、流程说明、权限说明、集成方案、模板判断线索

事实、能力与边界的写法

始终把下面四类内容分开：

1. 客户事实

   • 只能来自用户材料、用户确认或明确可追溯的客户公开资料。

2. 官方能力参考

   • 能从产品文档或应用平台文档找到依据的，写成“官方能力参考”。
   • 这类内容可以支撑“官方产品能力”或“CAP4配置能力”判断。

3. 可能需开发或集成验证

   • 只能从技术/接口文档推断，或者涉及第三方同步、回写、统一认证、组织同步、DEE/API 等的，写成“可能需开发/集成验证”。
   • 这类内容对应 接口/集成能力。

4. 外部案例与公开资料

   • 只能作为参考，不得伪装成客户现状。

如果无法确认，就归为 客户待确认，继续追问，不要替用户做决定。

何时读哪份参考

• 判断 OA 模块、标准功能边界、产品术语时：读 references/01-product-docs.md
• 判断 CAP4、应用平台、表单/流程/页面模板/业务生成器能力时：读 references/02-cap4-and-app-platform.md
• 判断接口、同步、回写、统一认证、ERP/合同集成、API/DEE 时：读 references/03-integration-and-api-boundaries.md
• 判断版本、环境、信创、部署、移动端或插件前提时：读 references/04-ops-and-deployment-notes.md
• 生成清单或交棒底稿前：读 references/05-handoff-spec.md

资源

• scripts/init_research_workspace.py
  • 初始化标准调研包目录并复制模板文件。
• scripts/generate_checklist_template.py
  • 重新生成 research-checklist-template.xlsx。
• scripts/generate_user_guide_docx.py
  • 将说明文档 Markdown 转成 Word。
• scripts/export_codex_package.py
  • 导出可给同事分发的完整技能包，并把说明文档放在最外层。
• references/
  • 官方知识域和交棒规范。
• assets/workspace/
  • 调研包模板文件。
• assets/docs/
  • 技能说明文档源文件。