dsh-skillx-workflow
原生 DSH 代理工作流学习与渐进式能力加载
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zaoweiceng/dsh-skillx-workflow#ade05b23091219cf13674c1da4fd5e824593e064Skillx Workflow 以 dsh-skillx-workflow 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
这个插件把 DSH 会话中的成功执行提取成可复用的 SkillX 能力。SkillX 保留 Skill 的“按需发现”方式，但把可重复任务固化为带输入输出 Schema、版本、依赖、执行记录和恢复机制的黑盒能力。
插件运行在 DSH 内，复用 DSH 的 Agent、会话、工具、Skill Provider、PTC 运行时、模型配置、凭据、权限和会话记录。
典型路径是：先由 Agent 完成一次代表性任务，再从该会话提取 SkillX。后续类似任务启用 skillx 后，模型只需要发现能力、读取契约、填充输入并调用 capability_run；内部步骤由插件按已发布版本执行。
成功会话
→ 证据快照
→ DSH 提取 Agent
→ 契约校验与版本发布
→ 模型通过 capability_run 调用
→ 输出校验、回执和恢复
SkillX 对普通 Skill 的改进：
| 维度 | 普通 Skill | SkillX |
|---|---|---|
| 使用方式 | 模型读取说明后自行规划 | 模型读取契约后调用黑盒能力 |
| 上下文成本 | 容易加载长文档和参考资料 | 只暴露名称、说明和 Schema |
| 稳定性 | 每次重新选择工具和步骤 | 固定已验证执行路径 |
| 输出质量 | 依赖模型自检 | 输出必须通过 Schema 校验 |
| 版本治理 | 说明和脚本容易漂移 | 不可变修订、版本锁和依赖闭包 |
| 失败处理 | 调用方继续排查 | 插件分类失败、前台恢复、后台维护 |
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% |
完整测试归档见 DeepSeek 调用基线。这组结果是小样本描述性对照，适合说明固定、多工具、可验证任务启用 skillx 后的收益来源。
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 交付复测 和 复杂工作流验收 单独记录；历史均值不能代替当前版本的验证。完整场景与限制见 实跑验证索引。
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 应由其原启动方式重启。
skill 工具获取功能及输入/输出契约，再调用 capability_run。实现与依赖正文留在插件内部，由 DSH Agent 生成可执行定义，JS 通过宿主 PTC、Python 通过原生进程运行；可组合固定版本的能力，正常执行不调用推理 Agent。timeoutMs 覆盖执行与当前任务恢复；到期停止业务执行并保留证据。后台能力维护使用独立生命周期和预算，由独立诊断子 Agent 判断偶发故障或实现缺陷；仅有依据的缺陷形成修复方案并优化定义。后台任务持久记录状态与关联会话。npm test 运行七组核心回归；范围、环境与已知失败见该文档。npm pack --dry-run 检查发布白名单。
src/：Agent、执行、恢复、存储与证据处理。client/：DSH 网页端插件入口。tests/：提取、执行、存储、版本生命周期与 DAG 回归。scripts/：安装、启动与运行检查。docs/：SkillX 概念、契约、插件设计、运行机制和实跑验证。配置 enableCapabilities 控制模型侧能力发现，管理和手动提取界面独立提供。测试使用现有模型的 endpoint、名称和凭据引用。
架构、能力契约、执行恢复与开发说明见 文档索引。
MIT。DSH 及其他依赖遵循各自许可证。
最新版本保存在数据根目录的 skillx/<name>/、workflow/<name>/，历史快照在平级 revisions/。保留短说明 SKILL.md，入口为 entry.js 或 entry.py，辅助脚本和错误指引放在自身目录内；参见编写约定。