前言¶
DSH 插件生态中的 SkillX 工作流提取插件，解决的是智能体开发中「如何把一次成功的对话固化成可复用能力」的问题。在普通 Skill 模式下，模型每次都需要阅读长文档和参考资料，自行规划步骤，这会导致上下文成本高、执行路径不稳定。SkillX 将可重复任务固化为带输入输出 Schema、版本、依赖、执行记录和恢复机制的黑盒能力，模型只需要发现能力、读取契约、填充输入并调用 capability_run，内部步骤由插件按已发布版本执行。
是什么¶
zaoweiceng/dsh-skillx-workflow 是一个 DSH 原生 SkillX 插件，分类为「记忆」。插件运行在 DSH 内，复用 DSH 的 Agent、会话、工具、Skill Provider、PTC 运行时、模型配置、凭据、权限和会话记录。它把 DSH 会话中的成功执行提取成可复用的 SkillX 能力，支持契约化调用、版本管理与自动恢复。
核心功能¶
从会话提取 SkillX¶
典型路径是：先由 Agent 完成一次代表性任务，再从该会话提取 SkillX。后续类似任务启用 skillx 后，模型只需要发现能力、读取契约、填充输入并调用 capability_run；内部步骤由插件按已发布版本执行。
成功会话
→ 证据快照
→ DSH 提取 Agent
→ 契约校验与版本发布
→ 模型通过 capability_run 调用
→ 输出校验、回执和恢复
SkillX 与普通 Skill 的差异¶
| 维度 | 普通 Skill | SkillX |
|---|---|---|
| 使用方式 | 模型读取说明后自行规划 | 模型读取契约后调用黑盒能力 |
| 上下文成本 | 容易加载长文档和参考资料 | 只暴露名称、说明和 Schema |
| 稳定性 | 每次重新选择工具和步骤 | 固定已验证执行路径 |
| 输出质量 | 依赖模型自检 | 输出必须通过 Schema 校验 |
| 版本治理 | 说明和脚本容易漂移 | 不可变修订、版本锁和依赖闭包 |
| 失败处理 | 调用方继续排查 | 插件分类失败、前台恢复、后台维护 |
会话提取与草稿¶
会话操作菜单可从所选会话提取 SkillX；插件会创建 DSH Agent 读取证据。提取 Agent 通过专属工具提交候选，静态格式检查通过且成功结束后才发布；提取不执行候选程序或模拟验收。草稿可续跑和按字段局部修复，后续请求集中提供当前草稿、相关失败与必要契约；预算采用可调整的工作估计。
版本管理与恢复¶
提取时随版本保存依赖脚本，执行时通过内部资源接口定位，调用方无需查找文件。未知配置和工具位置向用户询问；资源保存仅做静态检查，不执行业务。
执行失败先分类：内部问题在同次调用内由恢复子 Agent 读取该 SkillX 自身 docs 恢复，外部阻塞返回精简原因。输出必须通过契约验证；详细步骤、错误与用量保留在私有执行记录中。
前台 timeoutMs 覆盖执行与当前任务恢复；到期停止业务执行并保留证据。后台能力维护使用独立生命周期和预算，由独立诊断子 Agent 判断偶发故障或实现缺陷；仅有依据的缺陷形成修复方案并优化定义。后台任务持久记录状态与关联会话。
同名能力优先于普通 Skill。历史执行证据记录来源和观察条件，Agent 根据当前状态判断可复用的验证结果。
管理界面¶
SkillX 默认打开首页；在 SkillX / 工作流选项卡为条目打开”在首页展示”，即可通过首页卡片直接进入参数调用界面。展示选择持久保存，独立于能力启用状态，优化版本后保留。首页说明最多显示 80 个字符，悬停查看全文；选项卡右侧的”编辑”开启卡片拖动排序，顺序自动保存（也可用 Alt + 左右方向键排序）。
左侧 SkillX 管理面板使用 DSH React 组件，每条能力可启用或关闭。
“提取模型”后提供”历史快照”和”回收站”。历史快照先按能力展示类型和用途，进入后查看版本并直接打开执行，按原依赖版本运行；回退同步切换必要依赖，较新版本进入回收站，冲突时阻止回退。删除也进入回收站，默认 30 天后清理；合并展示创建、移入时间、删除倒计时与恢复按钮，并保留实际彻底删除记录。历史快照持续保留，被保留版本依赖的回收项延后清理。执行与提取记录不受影响。
安装与启用¶
git clone https://github.com/zaoweiceng/dsh-skillx-workflow.git
cd dsh-skillx-workflow
./scripts/install.sh
./scripts/start.sh --no-open
使用已安装的 dsh，默认接入 web profile、端口 3080。可设置 DSH_BIN、DSH_PROFILE 和 DSH_SKILLX_PORT。已在运行的 DSH 应由其原启动方式重启。
典型用法¶
调用方通过 DSH skill 工具获取功能及输入/输出契约，再调用 capability_run。实现与依赖正文留在插件内部，由 DSH Agent 生成可执行定义，JS 通过宿主 PTC、Python 通过原生进程运行；可组合固定版本的能力，正常执行不调用推理 Agent。
适用场景与注意¶
适合需要在 DSH 中固化、复用、版本化管理成功对话的开发者。
插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
结尾¶
DSH SkillX 工作流提取插件通过将成功会话固化为带契约、版本和恢复机制的能力，帮助开发者减少上下文成本、提升执行稳定性和输出质量。安装后即可通过会话菜单提取能力，在 SkillX 面板中管理版本、启用/关闭和配置恢复策略。更多细节见目录页和GitHub。
