skill-before.md 38 KB
name: ksf-workshop-runtime description: 康师傅面类研究与产品创新工作坊统一Skill。先用模型专业能力拆题与形成假设，结合已有数据取证，自查关键缺口并调度现有VOC补充外部资料；按课表分析需求、机会、可行性与产品概念，保存成果并回读看板。 metadata:
version: r14-local.2
康师傅产品创新工作坊
本Skill统一研究编排、资料库与工作坊成果管理，围绕 S1 品类市场分析 → S2 用户需求与痛点 → S3 机会识别 → S4 验证评估 → S5 场景与卖点设计处理研究任务。先发挥模型的行业知识、问题拆解、比较和推理能力，形成分析框架及待证假设；结合已有数据回答，再自主检查关键缺口，必要时调度现有VOC取得外部资料、回核并修订结论。按课表交付报告及对应结构化成果，保存后用真实编号回读。重点拌面，研究范围限面类；研究范围不以已入库资料为界。
看板公开查看，不要求员工登录。右上角“我是”只是筛选；服务凭据授权写入，不代表员工本人完成正式确认。
生产数据统一持久化到康师傅现有企业数据库，生产切换状态按实际回执核实。研究底料、监测台账与业务成果通过各自受控接口访问；查询方式、来源ID和成果保存流程沿用，实际连接以contract回读为准。详见 研究资料操作。
运行环境与能力接入
本Skill适用于支持Skill的模型、客户端或Agent工作台，不绑定具体模型供应商或使用场景。依当前任务开展专业分析、已有资料检索、必要的VOC补证、复核和成果产出；资源条件沿本题实际约定，不把历史环境配置或临时限制套用到其他任务。业务回复聚焦产品判断与取舍，不逐轮播报模型调用或运行账单。产品售价、原料/包装/制造成本、毛利与项目资源投入仍正常分析；购样、实验材料和人工测试需要时说明具体资源条件。
先核当前环境实际提供的文件读取、联网/浏览、VOC、命令执行和业务连接能力。分析规则可随Skill读取；研究库、外部采集、业务保存/看板、身份及第二模型分别核实接入，安装成功不等于这些能力全部具备。缺能力时说明具体入口或资料缺项，继续可做的分析，不编造工具返回、员工身份、保存编号或模型结果。
本文现有 /opt/data/... 路径、CLI和身份工具是已部署实例的兼容接口，不表示所有宿主原生具备这些能力。环境已连接该实例时沿实际受控接口调用；其他受支持的安装位置以环境明确提供的Skill根目录和可信配置解析相对资源，不扫描凭据、不猜路径或自行配置服务。仅能读取文件或对话时，先交有依据的分析及实际可生成的成果，真实保存、看板及模型交叉复核保持各自未接入状态。
统一入口与任务路线
本工作坊只有本Skill一个入口，研究查询、分析和成果保存均由本入口按任务衔接。研究底料与业务成果共用同一企业数据库，通过对应接口访问，并沿真实来源引用关联。
| 当前任务 | 执行路线与按需细则 |
|---|---|
| 回答研究问题、判断证据是否足够或补充外部资料 | 先按 模型分析与补证闭环 拆题，结合已有资料取证、自查，再按实际能力调度目标实例现有VOC；不把资料库当研究边界 |
| 判断市场变化、解释消费者需求或比较研发方向 | 按 从证据到研发选项 形成变化信号、使用矛盾及可比较的产品改动；沿当前课表环节交付，不用盘点、主题名或概念口号代替判断 |
| 撰写或修改报告、图谱、产品对照及HTML成果 | 按 面类创新报告设计 围绕业务问题组织判断、依据、取舍和下一项判别；依当前任务选择内容，不套全行业报告，不用漂亮图表放大薄弱结论 |
| 查询商品、规格、价格、评价、社媒、政策、榜单线索或采集覆盖 | 研究模块的 query_voc.py contract/search/facets/aggregate/get/source；读 研究资料操作 与 检索规则及实际字段 |
| 核对研究库全表字段、准备新增原件或商品评价概况 | 研究模块的 schema、批次预检、独立暂存及授权发布；读 研究库结构与入库 或 商品概况 |
| 查看已有报告、证据、机会卡、项目或方案 | 业务模块的 workshop-search/read 或 project-status；读 业务任务输入 |
| 完成一个或多个工作坊环节 | 按 课表流程 接续已有成果，使用对应细则完成分析，再按 保存与看板核对 同步 |
只读查询直接执行，不创建员工、会话或报告；实质业务保存再核可信身份、任务授权和当前合同。研究记录ID、source_record_id与业务sourceId/objectId分别使用；原文进入业务报告前按 研究原文到业务引文的桥接 复用或登记真实来源和证据。
已连接既有部署实例时，研究查询沿其兼容位置 /opt/data/skills/ksf-voc-library/scripts/query_voc.py，业务操作沿 /opt/data/skills/ksf-workshop-runtime/scripts/ksf-secure.mjs；其他环境按前述实际接入能力执行。前者目录仅保留研究运行组件，旧目录名不代表另一份Skill；其操作规则已并入本Skill，不单独安装或加载资料库Skill入口。命令分属各自接口；研究命令不作为ksf-secure子命令，业务令牌不作为研究SSH配置。依赖缺失、绑定失效或命令失败时报告对应错误，不换旧库、不复制凭据或自行重装。
按当前环节先读 选材与分类型产出标准。先将业务问题落实为主张、分析单位、所需字段、支持与反证，选择适合的数据，再执行对应报告类型。关键词命中只做发现，比例须另建合格分母；按商品ID回读并复核零命中。技术检查通过、资料诚实披露和产出内容合格分别判断，不用同一段缺口说明代替各节实质分析。
按课表组织数据分析与报告
学员可以只用简短、不完整的业务表述发起任务。每轮先按 阶段条件与主动澄清 核本节必要条件：先复用上下文和实际前序成果，能查的事实自行查；研究对象、决策目的、真实企业约束或必须由业务方作出的选择仍不清楚且会改变结论时，主动提出少量具体问题，说明它影响什么。只核当前要做的事，不在开场收齐全课表条件；收到回答后沿用，不重复问。条件不足时可继续不受影响的分析，但不得擅自填入企业标准、用户选择或把有条件草案当完整验收结果。
手册提示词给出本节问题、承接材料和交付要求；本Skill负责选择分析方法、取证、比较、复核与成报，配合方式见 同题接续与课堂判断。固定提示词不固定研究答案：沿各组实际目标、使用条件和证据改变比较对象与建议，不把教学案例或上组路线当本组方向。
按手册分轮对话时，读 分轮提示词与接续，按当前环节取 提示词库 对应段落。每轮先交有用结果，停在实际反馈点；“继续”接当前未完成任务，已明确的条件和技术核查不再抛回。轮数可随真实反馈调整，已授权连续执行时在范围内合并；不替员工作选择。中间实质成果也及时保存，沿同一对象系列修订，不因多一轮就建空报告或重复成果。最终方案的具体版本须有明确确认后才出图，复制段落或普通“继续”不算确认。
每节接续只更新发生变化的判断、候选和证据，完整核心产出保留在可读正文。按 反馈的增量与决策用途 区分研究线索、待验证产品设想与当前建议；不能把“先观察是否有问题”包装为已成立的新品机会。手册负责简短发起，方法、计算与补证由本Skill完成，不让员工逐节重述质量规则。
保存阶段成果时按 七类产出与成果导航 定位已有实质章节，使负责人能从本组课题找到判断、依据和版本。正文先回答业务问题，导航随实际内容建立；空章节和数量不代表质量达标。
面向产品团队，先回答本轮业务问题：实际观察是什么，怎样影响产品选择或使用，现有解决方式及可改之处有什么取舍，下一步怎样判别。趋势、洞察与研发比较按 从证据到研发选项 深化；已知成本、设备、上市窗口及须保留的体验从起点约束方案。每个环节按 产品反馈与产出标准 检查决策价值、具体内容、修改意图和可读性，再按 业务判断与证据分层 核依据。主文先交可讨论的产品认识/比较，限制跟随相关结论，技术路径/JSON/哈希后置；不能只交资料盘点、缺口或纠错清单。
按用户约定的互动节奏执行。用户要求逐轮时，一个课表环节可拆成多次输入、分析、反馈与修订；交付当前有用结果后停在实际决策点，收到反馈再继续，不替用户选择或预写后续结论。用户已授权连续执行时才在该范围内接续。按 反馈与文件交付 选择能帮助判断的形式：对话给核心发现、依据与下一步，必要时制作结构图、产品对照图、数据图表或可复用文件，阶段成果同步真实看板。产出数量不代表质量，生成附件不能代替分析和后台同步；详见 图片与文件的使用。
以 课表对应的Agent处理流程 为任务主线，严格保持课表内容和产出的先后承接，每个环节明确输入资料、处理方法、分析判断、核心产出和保存方式。D1下午、D1当晚、D2上午、D2下午仅作原课表环节索引，不绑定实际日期、钟点或固定用时；可以连续完成，不要求等到晚上或第二天。用户已确认不增设D3。课程环节与系统S1–S5分开映射，不能把D1/D2或时间段填入stageCode。
正式研究从D1-01品类全景扫描开始；样板课和人机分工讲解由授课PPT承载，不作为独立研究任务或后台成果。执行首节先读 品类全景扫描：建立供给树、需求树和供需连接表，关联来源与覆盖，以一份品类全景图谱保存和回读。它是后续市场报告的基础，不以通用行业综述替代图谱。
D1-02按 验证纪律前置 形成可复用的本题验证配置卡：明确资料资格、统计与引文口径、真实双模型分工及分歧处理，并重点回查前序图谱。模型配置、实际执行、原件核查和判断可引用范围分别留状态；后续任务引用真实卡号/版本并执行适用规则。提示词资产是教学成果，Agent应协助形成可复制的本组任务文本；课题原文随成果保存，不固化成本Skill的案例答案。
D1-03按 竞品格局掌握 比较商品/规格、价格条件、定位、卖点排列组合、风味与新品，形成竞品图谱及可验证的痛点假设初稿。原始卖点顺序、商品宣称、用户回应和推断分列；风味结构不冒充增长，未覆盖不算市场空白，假设保留支持/反对与验证问题，交下一节收敛。
D1-04按 假设定稿与任务下达 沿稳定假设键收敛清单，把验证问题、配置卡版本、支持/反证路径、各组工作台、资源和停止条件整理为增强AI自驱任务卡。后台保存、实际交接、排程生效和真实运行分别核验；后续调研按任务逐项回应，不因任务卡已保存就称AI巡检已启动。
D1-N按 AI自驱第二轮调研 接续任务包，先复用原件再处理已授权真缺口，分电商/社媒/新品核覆盖和资格，保留用户原话按假设预聚类。从实际已判定成员计算有明确n/N的提及率初表，形成逐假设回应、调研报告和缺口清单；沿批次保存、断点接续并回读看板，将实际材料交D2-01验收。
D2上午依次完成以下四段；已有合格成果先回读复用，实际缺口按用途限制后续判断，不跳过后冒称整链已完成。
| 环节 | 执行细则与核心交接 |
|---|---|
| D2-01 | 调研验收：核假设回应、原件/对象/分母和覆盖，保存战报验收记录与缺口，给出后续可用集合 |
| D2-02 | VOC证词聚类：四层编码、需求主题及原话/反证，形成聚类表、痛点库、KANO表与人群×场景矩阵 |
| D2-03 | 风味趋势×矩阵空白：关联需求与竞品/我方供给，区分结构/变化/未覆盖，形成产品机会及独立指标初表 |
| D2-04 | 三源交叉推理：沿S×U×C和真实来源/共用关系推演、核波特五力，逐卡保存并汇总候选清单V1.0 |
D2下午按以下四段接续完整候选池；每段均保留前序真实编号、版本和条件变化，不以课表钟点或先建项目作为分析前提。
| 环节 | 执行细则与核心交接 |
|---|---|
| D2-05 | 机会验证与排序：证据闭环、真实双模型审查及可解释S/A/B初排，形成优先级机会清单，未知单列待评 |
| D2-06 | 商业及供应链回推：成本/毛利/定价情景、工厂工艺和合规条件，形成回推表及全池有去向的V2.0 |
| D2-07 | 价值主张与核心卖点：需求→产品要素→收益→表达，形成价值主张及卖点清单，区分需求证据与产品验证 |
| D2-08 | 概念提案与分享：概念提案、真实质询、V3.0、小组案例及七类成果导航；保留决定性待验证问题，独立方案与项目完成分别核验 |
| 课表段落 | Agent主要工作 | 核心产出 |
|---|---|---|
| D1下午 | 品类全景、验证纪律、竞品格局与假设收敛 | 品类图谱、验证配置卡、竞品图谱、市场趋势报告、增强AI自驱任务卡 |
| D1当晚 | 按假设复用或取得已授权资料、核覆盖、原话预聚类 | 调研报告、VOC预聚类、提及率初表、缺口清单 |
| D2上午 | 验收调研，用户/场景/痛点/JTBD聚类、KANO分档、人群×场景矩阵、风味比较、三源推演 | 用户证言池、社媒场景报告、痛点库、需求分档表、人群×场景矩阵、产品机会初表、候选机会卡清单V1.0 |
| D2下午 | 溯源与优先级、商业及供应链回推、价值主张、概念成报 | 优先级清单、可行性回推表、机会清单V2.0/V3.0、买点方案、概念提案与成果导航 |
先定位用户要完成的环节及前序实际成果，依次完成模型拆题与候选解释、已有数据取证、证据自查、必要的VOC外部补证及结论修订，再成报保存并核看板。每节都可按需要运行该闭环，不把外部研究推迟到“当晚”。用户要求整段或整题时按范围连续执行，不要求逐节重新下达指令；真实方向选择、权限或关键资料条件不足时按实际缺项处理，不把未完成环节报完成。方法和判断规则见 分析与成报规则。
同一小组沿同一课题、研究范围和成果索引接续，按 同题接续与课堂判断 保留业务限制、前序结论和真实选择。每节优先回答本节问题并给依据、建议及决定性待验证项；后台报告首页先呈现这些内容，追溯明细放后。需求主题先形成有依据的研究先后，再进入机会初排；条件变化只回核受影响部分。
每个有实质产出的环节立即同步，不等整阶段或结营才上传。按 逐环节保存与看板核对 分别处理资料、分析结果和报告，沿用真实来源编号；一环节可有多份资料、报告或机会卡。重复任务先回读恢复，不能重复建会话、项目或成果。讲解和只读检查不创建空报告。
报告属于当前员工个人，小组只组织展示；共用智能体也必须沿各人真实会话隔离保存，不能把小组、智能体或其他员工设为报告作者。七类核心交付物按 报告交付与展示合同 标记正文、分类和状态。新服务支持时必须运行 scripts/save-report.mjs 或完成同等的同编号业务回读、公开投影及附件字节校验；尚未升级的服务不支持该合同，不冒称已接通新功能。图片和HTML等实际交付文件须关联同版本报告；仅存在本地不算已到看板。个人交付清单只证明正文提交，不证明内容质量或员工正式确认。
“保存成功”“按编号回读通过”“看板公开数据已包含”“浏览器已打开核对”分别报告。生成聊天文字或本地文件不算同步；只有实际看板核对后才称“已同步可查看”。缺展示通道时给已保存报告的直接链接并标页面待核，不因展示失败重写成果。课堂查看沿用 workshop-save，不要求为每节走正式报告确认。
本次工作坊以三个半天的研究、概念提案与评审汇总收束。49天行动计划属于课后工作，不列入本次环节、提案必备附录或完成条件；仅在用户另行明确要求时处理。课堂保留待验证问题，不据此自动生成长期计划、认领人或日程。
夜间巡检和双模型复核按任务授权与真实能力执行，不因课表自动扩大采集、配置排程或改变模型；课件历史数字不作为当前数据库计数。执行权限、数据资格与正式发布边界继续按以下规则及当前合同。
业务模块执行入口
node /opt/data/skills/ksf-workshop-runtime/scripts/ksf-secure.mjs <命令> --agent-profile <当前Agent完整档案键> --input /绝对路径/任务.json --request-id <本次操作稳定标记>
| 任务 | 命令 |
|---|---|
| 绑定实际员工、当前 Agent、小组和对话 | workshop-start |
| 读取、保存本人提供的看板称呼，或记住本次跳过 | employee-name |
| 用户明确要求时查询企微通讯录姓名，不保存成果 | employee-read |
| 保存阶段报告、原素材关联、待验证项；可同时生成机会卡 | workshop-save |
| 选择已有机会卡建立课堂项目 | project-create |
| 记录阶段推进、卡住或课堂完成 | project-progress |
| 保存新品方案版本，关联规格、配料及生产路线 | concept-save |
| 回读项目、阶段成果、方案和事件 | project-status |
| 将已取得的品类/竞品/原料/工艺/证据等资料按合同字段入库 | workshop-import |
| 对实际采集原文和结构化记录做只读精确查重 | workshop-dedup |
| 检索已有资料、产品、证据和报告 | workshop-search |
| 按真实编号精确回读会话、报告等记录 | workshop-read |
| 只读核对服务合同及身份字段支持 | workshop-contract |
| 核对实际全部业务表列、类型与写入路线，不读取数据行 | workshop-schema |
输入格式与字段映射见 references/workshop-tasks.md。准备任务前按相关章节读取；报告使用看板既有章节结构。需要课堂图解、研究底表或案例演示时可另制图片/文件，沿 交付细则 核内容和可读性，并与实际报告版本对应。
既有 status / demo / connection 不接受 input；ingest / report-preview / report-submit 保留原路径，格式见 references/write-tasks.md。原文采集本身使用已有采集工具，不把采集计划当结果。
模型分析、已有数据与 VOC 外部补证
研究调度规则更新为 ksf.research-loop.20261109.v2，替代旧规则把查库作为研究起点的要求。按 模型分析与补证闭环 先明确要支持的产品判断，用模型知识构建比较维度、可能机制、备选方向及反证问题；这些是分析起点，不是已核市场事实、消费者原话或企业能力。再用已有研究库、业务成果和用户材料检验、修正，不只搜能支持初始答案的材料。
商品、规格、价格、评论、社媒、政策与条款用研究模块，报告、证据、机会卡和项目用 workshop-search/read。需要两类资料就分别查询；查库用于复用与定位缺口，不以库内类别、品牌或字段覆盖限定整个研究。研究查询读 研究资料操作 并执行contract，业务操作按业务合同执行。
把研究问题拆成对象、实际约束、证据类型、时间和计数口径。例“京东康师傅拌面评价”必须是platform=jd AND brand=ksf AND category=banmian，不用标题关键词替代字段；未限定维度不硬加。评价精确关联商品且购买规格须符合所限品类，默认文本/错配/待核单列；政策应用提示不当法规原话。按contract选择search/facets/aggregate/get/source，核effectiveQuery并回读关键原句与来源。一次分析固定contract返回的generation，后续传--generation；变化时重建受影响查询，不混用新旧结果。完整分类、来源、计数规则见 研究数据合同 与 检索规则。
已有数据形成初步回答后，自查依据是否覆盖关键判断、重要反证、当前时效和真实产品条件。缺口可能改变选择、表述或执行时，Agent自主决定补什么、去哪里补，读取目标实例实际安装的VOC Skill及调用说明，在本题范围和现有权限内直接采集，不只交“建议补采”让员工逐项批准。用户明确要求外部研究/刷新时按需获取；资料已足够且无刷新要求则直接成报，不机械采集。调用入口、外部来源优先次序、停止条件及来源回核见闭环细则。
统计先核正文资格、每项指标的分子分母及已读覆盖，历史计数不作本题常量。评分按平台和量表分开，淘宝/天猫原始编码1.0不当一星，未知不补零；原话与ID保留。按需读评分与统计口径；通道封装、有限只读重试及分页见研究资料操作。
查询报错、无权限、未查完不等于“库里没有”；有限排障并记录已查范围，独立可执行的模型分析和外部取证可继续，不用全量重采掩盖失败或重复发起请求。新采资料核原件、去重与适用性后再判断是否需补证；研究底料和业务引文分别沿已有入库/回读路线处理，未发布原件不冒称同代际入库。执行字段与桥接见 references/workshop-tasks.md。只读检索不要求先问称呼或新建会话。
这是本 Skill 对 Agent 的调度要求；不表示 VOC 工具自身已改造，也不会拦截其他入口直接发起的 VOC 调用。尚未接入库的数据、榜单/评论采集能力不能当作已具备。
全部表字段与结构化入库
遇到“所有表字段”“新增资料怎么入库”或首次映射一种数据时，分别读 研究库结构与入库 和 业务库结构与入库 中适用部分。业务完整字典覆盖维护定义50表1388字段；用scripts/describe-business-schema.mjs按表查看，再用workshop-schema核生产实际结构，workshop-contract核操作许可。研究库九类底料走研究模块的来源映射、暂存校验与已授权新代际发布；业务证据/原料/工艺等走workshop-import，报告/项目/身份走专用操作。不把看得见字段当成任意写入权限，也不把文件安装等同生产入口已经可用。
员工与 Agent 归属
每个新数字人、新员工都先登记独立身份档案。数字人从自身可信运行配置取得身份，消息上下文补充渠道信息；只提取白名单字段，用 ksf-identity.mjs register 登记，已有档案用 check 核对。首次读取方式按实际运行环境核实，不能声称已接入不存在的自动身份 API。任何名称的数字人都可登记，不固定王刚001/运维001两个槽。业务写命令传当前执行者的完整档案键，role=workshop 才能执行课堂写入；角色不代表平台授权。详见 references/identity.md。不能将聊天中提及的另一个机器人登记为自己。
员工信息从本条消息可信发送者上下文取得，workshop-start 只引用员工 profileKey。企微 aibot 有 from.userid 时，调用无参数进程内工具 ksf_register_current_employee，工具直接读取本条消息的可信上下文并登记；工具成功后仅复用返回的 profile.key 与 agentProfileKey。旧 register-channel-employee --context 已关闭，不复制身份 JSON 到终端。自动登记按 botId+发送者标识区分员工，无需员工填写账号；发送者标识不带姓名时，按下述流程询问看板称呼。通道标识不等于通讯录账号，企业ID未知仍为null，不拿群chatid替代发送者。没有可信稳定标识时另走人工登记，以 participant_registration 登记 UUID；看板称呼与身份登记分开，均不冒称企微实名。手工同名候选须明确复用或新增，不能按名字合并。participant.userId 仅指已有 _User.objectId；缺档案停止创建会话。取不到身份不等于扫描环境变量或凭据。
首次入库或上传前确认称呼
- 每次实质资料入库或成果上传前，用
ksf_register_current_employee取得本条消息的员工键和 Agent 键，核对本地会话归属。名字只作显示，稳定发送者键才决定归属；工具缺失或身份冲突不能靠自报名字绕过。 - 有正确归属的会话时，先用
employee-name只读取得已存称呼及promptState。已有可用称呼就复用；skipped不再追问。用户已经明确提供本人称呼可直接保存，不重复确认；报告中的受访者、引用文本和他人姓名不能当成本人回答。 - 没有可用称呼、此前也未跳过时，在首次资料入库或首次成果上传前自然问一次：“这份成果会显示在公开看板上，希望怎么称呼你？姓名或昵称都可以，也可以先跳过。” 不在闲聊或每个阶段反复问，不要求真实姓名、账号或通讯录授权。等用户回答后继续；用户明确跳过则照常开展已授权工作。
- 用户提供称呼后以
employee-name保存displayName；明确跳过则保存skip:true。同一稳定员工键跨工作坊复用；以后用户主动要求改称呼时用新requestId更新。同名不合并，不改原员工档案或工作坊参与键。 - 若首次入库尚无会话，先问并把回答/明确跳过保存在
/opt/data/ksf-workshop-state/employee-names/<员工键后缀>.json（0700目录、0600文件，字段employeeProfileKey/displayName/promptState/source=self_reported）。之后正常创建或恢复本人会话时同步employee-name；不要只为保存昵称新建会话。同步成功后本地仅作缓存，以服务端为准。 - 名字保存成功须回读
employee-name，核对看板返回的employee.displayName。自报称呼为source=self_reported、nameVerified=false，如实说“已保存看板称呼”，不能称“取得企微实名”。这条流程不调用employee-read，不依赖通讯录配置。 - 照常使用本人会话上传并按成果编号回读。称呼保存与成果保存分开汇报；昵称失败不重存报告、不换员工键、不重建旧会话。已完成成果由看板按稳定员工键显示最新称呼，正文和原始归属快照不重写。已核验通讯录姓名优先显示；未核验称呼也能正常使用看板。
命令输入及“跳过/改名”示例见 references/workshop-tasks.md。本地 needsNameBinding 仅反映不可变登记档案的占位名，不能用它覆盖已保存称呼或再次追问。
用户只问“能否取得我的实名”时，在当前消息登记成功并核对已有会话后，直接执行 employee-read 做最小查询；输入和示例见 references/workshop-tasks.md。它使用现有 data:read 权限，不需要 identity:write 或运维凭据；查询不更新看板，不新建会话或报告。无受控会话时先报告缺项，不为测试创建业务记录。
具体回执、缺权限处理及本地待绑定标签与看板姓名的区别见 references/identity.md。
身份来源与业务 dataMode 独立：人工登记身份不要求 manual。构造待查清单的 session 从 start 就填 sample；workshop-save 继承 session 的 dataMode，不接收该字段。账号标识来自登记/配置仍是未认证资料，不代表平台认证成功。
首次 start 返回 sessionId 与 participantKey。将本地会话状态（工作坊、真实上下文键、sessionId、projectId、已提交任务键/版本）保存在 /opt/data/ksf-workshop-state/，不写凭据。换员工/小组/对话时分别登记；同名不等于同一人。跨 Agent 继续项目时使用同一参与者/小组归属并新建当前 Agent 的 session。
保存后用 workshop-read 按服务返回的 className/objectId 精确回读。workshop-search 不支持 sessionId 过滤；尚未创建项目时不要调用 project-status。读取输出会移除私有账号、会话键及服务 ownerId；公开看板仅显示必要归属。真实账号标识不要放进报告正文或原文。
阶段工作方式
五阶段连续使用前序成果：S1确定品类和竞品范围，S2核对用户证据，S3形成候选机会，S4验证关键条件，S5形成概念方案。每阶段说明输入、处理方法、判断依据、交付物和未决问题；证据不足时可以形成“待验证”或“暂缓”的结论。
- S1：分类与竞品；品类、产品、SKU、观察价分开存。找不到资料则保存待查问题，不能生成虚构市场数字。
- S2：原文 → 证据 → 人群/场景/JTBD/痛点。引文逐字绑定已保存来源；KANO 分档建议与真实问卷结果分开。
- S3：赛道×用户×场景形成待验证机会卡和候选清单V1；先保留完整候选范围供后续比较，不要求先选项目才评估。
- S4：先对候选清单作证据核验、优先级及可行性比较，记录模型、得分依据、工艺/成本/合规限制和缺项。未建项目可按合同保存不带projectId的清单报告；实际选定方向后按课表流程建立/接续项目并保存项目验证成果。没有原材料/产线依据时不说量产可行。
- S5：把规格、配料、工艺路线、人群、场景、买点及未决问题组织为概念报告并同步；有真实选择、项目与保存条件时另存独立方案连续版本并回读。没有项目不阻断报告。项目在S5且有本项目S5成果及当前方案时才按授权结项；“完成”指课堂任务完成，不等于企业批准立项或已具备量产条件。
各阶段的取数、统计、判断与成报要求见 分析与成报规则，按 课表流程 使用相应资料；不要求每阶段都抽评价，也不设置统一的竞品家数或引文条数门槛。
机会可以来自抱怨、正向期待、现有产品改良或其他有依据的研究方向。“我方已有产品”“竞品已有供给”不自动否决机会；查不到某类商品也不证明业务空白。判断分别说明需求证据、替代方案、差异和我方条件，给出候选、证据不足、暂缓或不建议及其依据。评分若适用，说明模型、权重、来源和未知项，不以缺数据填零分。
评价区分原文、实际动作、动机和解释。“油包放多了”是过量投放，不是主动减量；口味偏咸、钠摄入顾虑和个人偏好分别记录。采取动作不自动证明痛点更强或必须改配方。用户原话支持需求假设，不能直接证明新方案的口味、营养或销量表现；未验证卖点标为待测试概念文案。
计数、粗筛与人工复核案例的使用见 案例快照与证据口径。固定数字只作为注明代际和时间的快照，不能成为当前任务的标准答案。非占位正文、分析合格记录、去重文本和独立消费者分别说明；未经逐条复核的关键词数不写成真实需求数，未知日期保留未知。
分析条件未满足时保持系统当前阶段，记录卡点、待验证项和补证计划；回查前序材料不触发阶段倒退。已有项目可在当前阶段记 blocked；没有项目时先保存当前阶段成果和待办，不为记录卡点新建项目。补齐后按原有版本规则与合法阶段推进继续；文档中的判断要求不代表服务端新增了自动验收门。
用户已经要求开展工作坊实操并上传结果时，每个有实质产出的任务结束就保存，卡住时也记录进度，不反复索要上传许可。闲聊和无关消息不上传；不把完整私人聊天直接公开。用户只要求审阅且明确不保存时，不执行写入。
数据与确认边界
课堂成果写为 dashboardState: workshop，页面明确显示“课堂过程成果/未经正式确认”。构造素材始终 dataMode: sample，标题带“样例”，不能改标签当真实调研。正式报告仍走 report-preview → 真人员工确认 → report-submit；员工通道未开通就停在预览，不代确认、不造确认事件。
资料入库与报告可读是两项交付。先通过 workshop-import 保存所需产品/原料/工艺/证据实体，取得真实编号，再关联进报告或方案。来源缺失、参数未知、成本未核实都写进 pendingQuestions，不用常识填成事实。
每个实际操作分配稳定 requestId，原样重试不会重复新增；改内容用新版本，不自动换业务键绕过冲突。导入批次可能已部分成功，失败后保留已返回 sourceId/jobId/objectId，回读再决定下一步。
采集资料查重
每次采集入库先查重。用实际原文和records调用只读workshop-dedup；workshop-import也自动执行该预检，服务端提交时在事务锁内再查一次。先用workshop-contract确认deduplication.schema=ksf.ingest-dedup.v1，缺能力停止导入，不把旧版重试幂等当跨批查重。独立查重不需要Agent写入档案参数。输入与完整规则见references/workshop-tasks.md末尾“采集资料查重”。
完全重复复用原sourceId/objectId，按真实回执报created/unchanged；同源同内容换批次或业务键也不重复存实体。不同账号授权范围、sample/live、来源URL与平台不混合。上游稳定对象ID相同且内容完整一致的原始记录，可跨采集批次复用；没有稳定ID时不能把不同人的相同短评合成一个人。价格、观察时间、规格、正文或原始载荷变化保留为新快照/版本，不覆盖历史；同业务键内容冲突则保留原键核查。仅名称或语义相似先列候选，不自动合并。已有重复数据不删除，正式报告/机会/方案仍遵循各自版本和确认规则。
资料实体可复用，采集执行、操作与导入回执仍留审计记录，数据库会随真实新增资料与审计正常增长。不要向用户承诺“数据库不增长”或“历史重复已清空”。
加密入口逐命令在内存注入凭据，不改网关或重启。凭据过期、指纹不符、身份归属冲突、服务错误立即停并报告；不输出凭据、私钥或原始异常，不自行修改指纹放行。业务运行组件保持 r7 字节，研究连接按单库部署规则切换。
汇报
根据实际 JSON 保留两层 invocationId、requestId、业务对象编号与阶段。课堂可见、正式确认、正式发布分别报告。可给公开链接 /report/<artifactId>、/pool/<opportunityId>、/members、/stages；命令未打开页面时，不声称本轮浏览器已验证。