dsh-workflow-recorder
已验证dsh-workflow-recorder · v0.1.0 · MIT
DSH 插件:把成功会话选段一键提炼为参数化、可回放、可验证的 SKILL.md(SkillRecord + EvidenceReceipt)
安装
dsh plugin add dsh-workflow-recorder 用 dsh --profile default --dump-config 确认 layer 已生效 —— 参见安装指南。
源码
发布到 npm 但没有公开仓库。安装前请检查包内容。
标签
说明文档
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 区间(3或3-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(回放回执)。
核心能力
- 会话选段:用户选择若干 Turn(命令式,Web 端可视选段器为迭代项);
- 结构化提取:读
session/event提取工具调用序列与关键决策,区分稳定步骤与偶然步骤(失败/被纠正的调用归入异常处理); - 参数化:绝对路径(项目内 →
{{project_dir}})、相对文件路径、工单号、分支名、主机名、日期、重复值自动识别为输入参数;同值多现合并;单现参数标注「建议人工确认」; - 双格式产出:SKILL.md(DSH 官方 skill 机制直接可用;frontmatter/节次与 skill-filesystem 约定一致)+ 官方
evidence/receipt回执(workflow 格式导出为第二批,不自造 DSL); - 产出内容按"目标 / 输入 / 前置条件 / 步骤 / 异常处理 / 验收标准 / 安全限制"组织,不机械复制 Tool Call;
- 回放验证:临时 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 录制回放 | 桌面操作域,非会话域 |
文档导航
- docs/design.md — 提取管线与参数化设计
- docs/research.md — 竞品档案与命名核查
- docs/verification-report.md — MVP 验证报告