README.md 5.5 KB
工作坊操作手册 · 开始前：安装与初始化
学员准备：打开支持技能导入与执行的 AI 工作环境，提供完整初始化 ZIP，再发送“一键初始化”提示词。首次安装两项能力：官方 VOC 用户研究 Skill 与康师傅产品创新 Skill。Skill 内容保持通用，不绑定模型供应商。
安装文件与宿主发现是两件事。普通聊天窗口如果只能读附件，没有技能管理、文件写入或执行能力，不能靠一句提示词变成可安装环境；此时准确说明缺什么，使用平台提供的技能导入或工作台入口。不得声称“已永久安装”。
本包与原 r7 的区别
这是新学员使用的完整包，包含完整产品创新 Skill（43 个公开文件），不要求先有 r6。原 r7 ZIP 是旧实例的增量升级器，只适用于已安装的完整 r6；不要把原增量包作为新学员首次安装入口。
VOC 使用官方 npm 发布 @vocmarket/voc-skill@0.3.42。本包只锁定下载地址、摘要和成员指纹，不转售、不改写或重复托管第三方包。安装器从官方地址下载并核验原件，再放到当前环境明确提供的 Skills 目录；也可用完全一致的离线官方 tarball。11 个子技能保留在官方包内，相对资源路径不变。
当前官方安装渠道列出 claude-code、codex、workbuddy、fmode-studio，未列豆包。这里提供的是平台中立的文件安装与 Node 运行准备，不冒称官方已经支持豆包。豆包端是否支持导入、发现和工具调用须在真实端验证；模型名字不能代替宿主能力。
给学员的使用方式
上传完整初始化 ZIP，再发送手册中的“一键初始化”正文。Agent 从当前环境的技能管理或可信说明识别实际 Skills 目录，不能把 .claude/skills、.codex/skills 或 /opt/data/skills 当所有环境的通用目录。
若环境支持命令执行，解压后在包目录运行（目录由 Agent 填成实际绝对路径）：
python -B install.py --skills-dir <实际Skills目录>
python -B install.py --skills-dir <实际Skills目录> --out <新的初始化结果目录> --apply --prepare-runtime
首条只核验与展示计划，不写目录。首次计划为新建两个 Skill；完整相同版本已存在则只核验。不同版本或混装时不覆盖、不删除或换目录制造重复入口，报告具体冲突，沿该环境的升级方式处理。安装中断先读原结果和实际文件再接续；不盲目重复。
运行准备需要 Python 3.9+ 和 Node.js 18+、npm；安装器只在本次 VOC 目录内安装运行依赖，不改系统环境。缺少命令执行或依赖时，文件安装与运行分别报告，使用宿主实际提供的方式处理；不得伪造工具。
官方原包的 .mcp.json 含作者机器路径。核原包通过后，安装器仅将安装副本的这一份配置换成当前实际路径，并在回执记录前后指纹；其余原包文件保持原字节。本包另生成 voc-mcp.fragment.json，作为当前安装路径对应的中立配置片段，不修改宿主配置。宿主支持 MCP 时使用它的正常接入方式合并，保留其他工具；不支持 MCP 但支持命令时，可按官方子技能说明调用本地脚本；都没有则留明确缺项。仅生成配置片段不等于注册成功。
初始化要形成什么结果
| 项 | 怎样算完成 |
|---|---|
| 文件 | 两个 Skill 的完整文件逐项校验通过 |
| 加载 | 宿主实际发现两个入口，读取相应细则；不能只看文件存在 |
| VOC 本地运行 | 可发现官方工具并搜索本地京东接口目录、读取参数文档；这不证明真实资料已采到 |
| 真实 VOC 访问 | 仅在当前任务实际取得对应响应时才标已验证；本次不采业务数据 |
| 康师傅已有资料 | 依据当前企业授权连接检查，缺入口保持未接入，不复制讲师/旧数字人的身份、凭据或库 |
| 成果保存 | 依据企业提供的受控接口检查；没有接口仍可生成本地报告，不能编保存编号或看板状态 |
本次只安装、加载、查本地接口文档及恢复现有连接，不创建企业、员工账号、业务会话或报告，不启动旧案例，不采集业务数据。平台已有可信登录/资源配置按现有方式复用；需要登录时走平台自己的登录界面，不让学员在聊天粘贴密钥。企业开通页与数据通道后续联调，不由这个 Skill 包代替。
安装完成后，回复一张简表说明“产品创新 Skill／VOC Skill／运行与连接”的实际状态；有缺项点名即可，学员不必看安装日志或提供技术参数。
Git 怎样安排
建议用 Git 维护我们自己的 Skill 源码、初始化脚本、手册和发行元数据。已存在的看板仓库是业务应用仓库；发布安装入口时只取本包所列白名单，不把整个脏工作区直接推送。
- 康师傅 Skill：自有源码与版本标签；对学员提供不可变 ZIP 或 release 下载地址。
- VOC：引用官方 npm 的固定版本与摘要；不需要再复制一个第三方仓库。
- 稳定入口：后续发布一个公开可下载的安装说明或发行清单，指向具体版本；私有 Git 必须有学员可用的授权下载通道。
- 不入 Git：账号凭据、企业 Master Key、绑定、原始员工资料、私有研究数据库、运行日志与现场初始化结果。
目前是本地准备件，未推送 Git、未发布外网，未在豆包中实测。以后只需把提示词中的附件来源改成已验证下载地址，学员流程不必重写。