dsh-skillx-workflow

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//、workflow//，历史快照在平级 revisions/。保留短说明 SKILL.md，入口为 entry.js 或 entry.py，辅助脚本和错误指引放在自身目录内；参见编写约定。