Skip to content

dsh-workflow-recorder

Verified

dsh-workflow-recorder · v0.1.0 · MIT

DSH 插件:把成功会话选段一键提炼为参数化、可回放、可验证的 SKILL.md(SkillRecord + EvidenceReceipt)

Install

dsh plugin add dsh-workflow-recorder

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Tags

Readme

dsh-workflow-recorder

一键把这次成功操作保存成 Skill:从会话选段提炼参数化、可回放、可验证的 SKILL.md(复用 EvidenceReceipt 回执)。

优先级 状态 名称核查 形态
A MVP 已发布(2026-08-16) dsh-workflow-recorder 未被占用(2026-08-15) 纯 DSH 插件

解决什么问题

用户经常让 Agent 成功完成一件复杂事情(服务器巡检、运维报告、多步重构),但成功经验只存在于聊天记录里,下次还要重新解释一遍。本插件把"一次性成功"转成"可重复、可参数化、可测试、可分享的能力",且用户不需要会写 Cordis 或 TypeScript

用法

/skill-record <turnRange> [--name <kebab-case>] [--draft | --static-only]
  • turnRange:Turn 区间(33-5,闭区间;缺失时报日志实际范围);
  • 默认(全量):提取 → 步骤归纳 → 参数化 → 临时 worktree 回放验证命令 → 验收通过(EvidenceReceipt verified)才保存
  • --draft:只生成草稿预览(.workflow-recorder/drafts/<name>/SKILL.md,不保存、不写会话事件);
  • --static-only:跳过回放,静态检查后直接保存(回执 verdict=skipped)——选段无验证命令或回放依赖不可装时的降级路径;
  • --name:kebab-case Skill 名(官方 skill-filesystem 约定);缺省从选段目标自动 slugify。

产出:

  • .workflow-recorder/:草稿 + SkillRecord JSON + 回放 EvidenceReceipt JSON;
  • .dsh/skills/<name>/SKILL.md:官方项目 Skill 目录(rank 100,dsh-tool-skill 自动发现);
  • 会话事件:skill/record(SkillRecord v1)+ evidence/receipt(回放回执)。

核心能力

  1. 会话选段:用户选择若干 Turn(命令式,Web 端可视选段器为迭代项);
  2. 结构化提取:读 session/event 提取工具调用序列与关键决策,区分稳定步骤与偶然步骤(失败/被纠正的调用归入异常处理);
  3. 参数化:绝对路径(项目内 → {{project_dir}})、相对文件路径、工单号、分支名、主机名、日期、重复值自动识别为输入参数;同值多现合并;单现参数标注「建议人工确认」;
  4. 双格式产出:SKILL.md(DSH 官方 skill 机制直接可用;frontmatter/节次与 skill-filesystem 约定一致)+ 官方 evidence/receipt 回执(workflow 格式导出为第二批,不自造 DSL);
  5. 产出内容按"目标 / 输入 / 前置条件 / 步骤 / 异常处理 / 验收标准 / 安全限制"组织,不机械复制 Tool Call;
  6. 回放验证:临时 worktree(当前 HEAD 基线)重跑选段提取的验证命令,经 EvidenceReceipt 验收通过才保存;凭据检测与脱敏(复用 evidence-gate Secret 规则集,命中只计数、正文脱敏为 [redacted:<ruleId>])。

MVP 范围(已实现)

选中会话片段 → 生成 SKILL.md → 自动识别路径/文件名参数 → 在当前仓库回放一次 → 保存到项目 Skill 目录。不做(保持):workflow 格式导出(第二批)、跨项目 Skill 库、分享站。

验证证据

  • docs/verification-report.md — 97 单测全绿;隔离环境三场景(全量/草稿/回放失败)29 项断言通过;平台差异(P1:自定义会话事件的 ignorable 无写入 API,与 evidence-gate 同源)与设计适配记录。
  • 已知限制:回放在裸 checkout 上执行验证命令(无 node_modules),依赖安装类验证命令请用 --static-only;真实 Agent 方法论回放(消耗 Token)为迭代项。

传播力依据(核查后上调预期)

colleague-skill(22.4k★)证明"把 X 转成 Skill"是这个生态传播力最强的动作之一;Codex 生态也已验证"用户自建 Skill"的产品价值。DSH 的增量是透明、可回放、可验证——这正是本插件的定位。

差异化定位

现有项目 Star 方向 关系
icetomoyo/dsh_workflow 57 多 Agent 调度升级为可治理 Workflow 层 做"编排",本插件做"从成功会话提取",互补
csyangwen/dsh-memory-evolve 86 跨会话记忆 + 技能自我进化 自动进化 vs 用户主动提炼,生态位不同
humblebanana/open-record-replay 138 macOS computer-use 录制回放 桌面操作域,非会话域

文档导航