DSH SkillX 插件

这个插件把 DSH 会话中的成功执行提取成可复用的 SkillX 能力。SkillX 保留 Skill 的“按需发现”方式，但把可重复任务固化为带输入输出 Schema、版本、依赖、执行记录和恢复机制的黑盒能力。

插件运行在 DSH 内，复用 DSH 的 Agent、会话、工具、Skill Provider、PTC 运行时、模型配置、凭据、权限和会话记录。

SkillX 在 DSH 插件中的应用

典型路径是：先由 Agent 完成一次代表性任务，再从该会话提取 SkillX。后续类似任务启用 skillx 后，模型只需要发现能力、读取契约、填充输入并调用 capability_run；内部步骤由插件按已发布版本执行。

成功会话
→ 证据快照
→ DSH 提取 Agent
→ 契约校验与版本发布
→ 模型通过 capability_run 调用
→ 输出校验、回执和恢复

SkillX 对普通 Skill 的改进：

维度	普通 Skill	SkillX
使用方式	模型读取说明后自行规划	模型读取契约后调用黑盒能力
上下文成本	容易加载长文档和参考资料	只暴露名称、说明和 Schema
稳定性	每次重新选择工具和步骤	固定已验证执行路径
输出质量	依赖模型自检	输出必须通过 Schema 校验
版本治理	说明和脚本容易漂移	不可变修订、版本锁和依赖闭包
失败处理	调用方继续排查	插件分类失败、前台恢复、后台维护

测试效果

DeepSeek Flash High

2026-10-14 的三轮对照使用 DeepSeek Flash High，任务为本地 commit、创建模拟 MR、合并 MR、回读核验。

指标	未启用 skillx	启用 skillx	变化
平均耗时	74.583 秒	51.381 秒	减少 31.11%
平均会话 Token	244,280	139,644	减少 42.83%
平均模型调用	10.333 次	6.333 次	减少 38.71%

完整测试归档见 docs/tests/2026-10-14。这组结果是小样本描述性对照，适合说明固定、多工具、可验证任务启用 skillx 后的收益来源。

GPT-5.5 medium

2026-10-18 的三组对照使用 GPT-5.5 medium，复用同一已提取工作流，任务为创建分支、提交指定文件、推送到本机远端并创建模拟 MR。

指标	未启用 skillx	启用 skillx	变化
平均耗时	74.378 秒	16.742 秒	减少 77.49%
平均会话 Token	221,273	68,366.667	减少 69.10%
平均模型调用	7.333 次	3 次	减少 59.09%
模拟交付成功率	3/3	3/3	—

六次调用的提交范围、正文和 MR 结果均正确。启用组完整应用指定 PATH 前缀；关闭组三次均遗漏该参数，在实验环境中仍能完成交付。工作流内部每次执行六个工具步骤，耗时 0.719～1.053 秒，模型 Token 为 0。

GPT-5.5 medium 的单次从零提取样本耗时 127.348 秒、166,044 Token，自动完成验收与发布。逐轮数据、提取成本及实验条件见 GPT-5.5 实验归档。Token 均包含报告的缓存读取；两批实验分别用于各自条件下的启用与关闭对照。

安装

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 应由其原启动方式重启。

使用与边界

• SkillX 默认打开首页；在 SkillX / 工作流选项卡为条目打开“在首页展示”，即可通过首页卡片直接进入参数调用界面。展示选择持久保存，独立于能力启用状态，优化版本后保留。首页说明最多显示 80 个字符，悬停查看全文；选项卡右侧的“编辑”开启卡片拖动排序，顺序自动保存（也可用 Alt + 左右方向键排序）。
• 左侧 SkillX 管理面板使用 DSH React 组件，每条能力可启用或关闭。
• “提取模型”后提供“历史快照”和“回收站”。历史快照先按能力展示类型和用途，进入后查看版本并直接打开执行，按原依赖版本运行；回退同步切换必要依赖，较新版本进入回收站，冲突时阻止回退。删除也进入回收站，默认 30 天后清理；合并展示创建、移入时间、删除倒计时与恢复按钮，并保留实际彻底删除记录。历史快照持续保留，被保留版本依赖的回收项延后清理。执行与提取记录不受影响。
• 会话操作菜单可从所选会话提取 SkillX；插件会创建 DSH Agent 读取证据。
• 提取 Agent 通过专属工具提交候选，静态格式检查通过且成功结束后才发布；提取不执行候选程序或模拟验收。草稿可续跑和按字段局部修复，后续请求集中提供当前草稿、相关失败与必要契约；预算采用可调整的工作估计。详见提取草稿与预算。
• 优化支持同时选择最多 8 条执行会话；新的 DSH Agent 先看逐步耗时、用量索引，再分页读取完整证据，并根据原版本完成优化。优化成功后以新修订发布。
• 调用方通过 DSH skill 工具获取功能及输入/输出契约，再调用 capability_run。实现与依赖正文留在插件内部，由 DSH Agent 生成可执行定义，JS 通过宿主 PTC、Python 通过原生进程运行；可组合固定版本的能力，正常执行不调用推理 Agent。
• 提取时随版本保存依赖脚本，执行时通过内部资源接口定位，调用方无需查找文件。未知配置和工具位置向用户询问；资源保存仅做静态检查，不执行业务。
• 执行失败先分类：内部问题在同次调用内由恢复子 Agent 读取该 SkillX 自身 docs 恢复，外部阻塞返回精简原因。输出必须通过契约验证；详细步骤、错误与用量保留在私有执行记录中。
• 前台 timeoutMs 覆盖执行与当前任务恢复；到期停止业务执行并保留证据。后台能力维护使用独立生命周期和预算，由独立诊断子 Agent 判断偶发故障或实现缺陷；仅有依据的缺陷形成修复方案并优化定义。后台任务持久记录状态与关联会话。
• 同名能力优先于普通 Skill。历史执行证据记录来源和观察条件，Agent 根据当前状态判断可复用的验证结果。
• 在 SkillX 面板的“提取模型”选项卡配置提取与优化模型，默认使用 DSH DeepSeek Flash 的 Low 推理档位。各阶段使用任务启动时的配置，并记录实际模型与用量。对话内执行失败后的恢复与后台诊断沿用调用方模型配置；提供方和凭据由宿主管理。

开发与验证

npm test 运行 tests/ 下的插件测试。npm pack --dry-run 检查发布白名单。

• src/：Agent、执行、恢复、存储与证据处理。
• client/：DSH 网页端插件入口。
• tests/：宿主集成与单元验证。
• scripts/：安装、启动与运行检查。
• docs/：SkillX 概念、契约、插件设计、运行机制和测试归档。

配置 enableCapabilities 控制模型侧能力发现，管理和手动提取界面独立提供。测试使用现有模型的 endpoint、名称和凭据引用。

架构、能力契约、执行恢复与开发说明见 文档索引。

许可

MIT。DSH 及其他依赖遵循各自许可证。

最新版本保存在数据根目录的 skillx/<name>/、workflow/<name>/，历史快照在平级 revisions/。保留短说明 SKILL.md，入口为 entry.js 或 entry.py，辅助脚本和错误指引放在自身目录内；参见编写约定。