kangshifu-board/docs/workshop-skill-release-20261109-r3

工作坊统一 Skill 增量更新 r3

适用：R730 原实例 agent-node-u17879018108（此前 hostname 043bb9231c），hermes uid 10000，既有加载源 /opt/data/skills/ksf-workshop-runtime。原资料库入口已经归档；本次保留其运行组件，不恢复旧入口。

更新内容

本包绑定已验收 r2：SKILL.md 31875ed7d93bd6cb559e5fdf32aa117234b9cd514a35638a4d7f827eb3ce815d；清单 4995e7e5a78184ca619debab347f1f46377688353a1d6baf2b0abb1275f43b14。

目标 SKILL.md：d8f3c5bd3ba8cd24a40aad37a19f9e2b3404201726070abc9fef9ade552e06e0。 目标 FILES.sha256：a4da4aa14f1e83cf853cb75594d84f6474e27edc1cdc5ca2aa61d1c59764fc60。

只更新8项、新增1项，共9项：SKILL.md、FILES.sha256、workshop-analysis/category-scan/competitor-landscape/course-flow/delivery/verification.md及新增workshop-feedback.md。

全量目标清单38条，另有清单本身，共39个公开文件；references是30个（28md+2json）。7项运行组件/锁不变。包只提供9项增量内容；不包含完整案例、凭据、密钥、连接配置或数据库。

执行

1. 核对外层ZIP的SHA-256（由转发文字提供）；解包到新的独立目录，勿覆盖Skill目录。读取本说明并执行 sha256sum -c FILES.sha256，须全部通过。
2. 核对原实例、hermes uid10000和原加载路径。不要到历史副本或其他宿主安装。

3. 在包目录运行下列一次性执行器。它逐步留存stdout/stderr和退出码：dry通过且计划为8更新+1新增时，自动apply一次，再以实际备份路径verify；无需再等一次安装确认。

   python3 -B run-update.py --out /opt/data/ksf-workshop-skill-update-20261109-r3-results
   

结果目录必须不存在。dry无副作用；apply在/opt/data/ksf-workshop-docs-backup-*保存8份原文件和journal。verify检查39个目标公开文件及原研究组件、绑定、旧入口状态；不将文件核验冒充Agent已加载。

若此前已执行或隧道中断，先查看既有结果目录、.exit和journal，不要换目录盲目重跑apply。已完整应用时，底层--dry/--apply均识别alreadyApplied且不重复写入；仍须检查前次结果。未知指纹、清单不符、旧入口重新出现、路径链接、权限错误均应停止回传，不现场改文件/重写清单来让预检通过。

实际加载与只读复验

使用现有skill_view/技能刷新机制实际读取新SKILL.md，再读references/workshop-feedback.md和workshop-course-flow.md。保留工具读取证据，确认读取来自原加载路径且内容为本版；不能用磁盘哈希代替加载证明。无需重启服务。

沿用原ssh-channel配置，只引用现有路径，勿复制、打印或打包配置。运行：

python3 -B probe-agent-library-read.py --skill-root /opt/data/skills/ksf-voc-library --instructions-root /opt/data/skills/ksf-workshop-runtime --accept-current --expected-installed-state expected-agent-read.json --out /opt/data/ksf-workshop-skill-update-20261109-r3-read-probe

若原配置未通过KSF_LIBRARY_CHANNEL引用，可增加--channel <既有私有配置路径>；不得改配置。本探针固定本次contract返回的代际，核对CLI文件/标准输入、结构化通道及同代际看板两组检索，另核get/source字段；不强制要求仍是历史82b104fc…代际。不得把数据更新、既有记录不再可见等误认成安装损坏；保留具体失败阶段再判断。

该探针只证明当前查询功能，不证明旧失败请求根因已查明；未知评分量表/默认状态保留未知。不得新建员工、会话、测试报告、机会卡、项目或方案；不得继续已停止的案例。原真实业务闭环验收作为历史证据保留，本轮不重新保存。

回传

先用简短业务文字说明：文件安装、实际加载、只读查询/同代际分别是否通过；任何失败明确指出阶段。汇总9项变更、目标指纹、备份目录、运行组件/绑定/研究文件保留状态、收费及库写入0。实际业务写入、正式发布标为本轮未验证，不把历史通过改写成本轮已做。

如需原件，合并为一个脱敏回传ZIP：执行器的dry/apply/verify stdout、stderr、exit、install-receipt.json、只读探针回执及实际加载证据。不要回传私有绑定、信封、密钥、通道配置、完整环境变量或整个备份目录。

恢复

安装器出错会尝试只恢复它仍拥有的已知内容，并给出FAILED_RESTORED或FAILED_REQUIRES_REVIEW。发生后先回传既有日志；硬中断留下APPLYING也先回传，不自动重复安装。

仅需要撤销一个完整APPLIED更新且没有后续编辑时，先检查备份和现场指纹，再使用：

node update-skill.mjs --rollback --backup /opt/data/ksf-workshop-docs-backup-实际目录

恢复保留旧资料库入口已归档的状态；不会恢复已停用入口。备份损坏或现场有未知后续修改时会停止，不能强制覆盖。