工作流与自动化

dsh-specflow

lonelymoon87/dsh-specflow · ★ 5

lonelymoon87精选

增加规格工件、技能、命令、由 goal 驱动的实施流程和任务进度上下文。

许可证
MIT
收录
2026-08-14
维护状态
active
安装方式
github
npm
dsh-specflow
查看 manifest 检查详情
manifest 状态
已声明
manifest 路径
package.json#dsh
manifest 检查
2026-08-19
生命周期脚本
未发现

manifest 静态检查只记录声明与安装脚本,不代表兼容性或安全审查。

安装

dsh plugin --profile web add github:lonelymoon87/dsh-specflow

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

项目说明

原始 README · 正文语言:中文 · 阅读英文 README

目录
  1. 一分钟开始
  2. 它解决什么问题
  3. 文件协议
  4. 权限与数据
  5. 安装
  6. 配置
  7. 发布验证
  8. 许可证

CI 最新 DSH 兼容性 npm Release License

把一个想法变成可审查的需求规格、实施方案、任务清单,以及可以跨会话恢复的 DeepSeek Harness goal。

SpecFlow 把工作状态写进仓库,而不是留在某一次对话里。新会话能够重新读取同一组文件,找到下一项未完成任务,并恢复对应的持久 goal。

v0.1.4 已发布至 npm,并针对 DSH 0.1.0-rc.8 与 0.1.1-rc.1 完成验证,同时保留兼容 rc.6 的 peer 范围。

English

一分钟开始

dsh plugin --profile web add dsh-specflow
dsh web

进入 DSH 会话后,先输入 /specflow 查看完整流程。一轮标准使用依次执行

/constitution 每一项行为改动都必须有聚焦测试
/specify 给 CLI 增加可恢复的导出任务
/plan-spec 001-resumable-exports
/tasks 001-resumable-exports
/implement 001-resumable-exports

进程重启或切换到新会话后,不用回忆上一段对话,直接读取持久状态并继续

/specflow 001-resumable-exports
/implement 001-resumable-exports
flowchart LR
  Idea["功能想法"] --> Specify["/specify"]
  Specify --> Spec["spec.md"]
  Spec --> Plan["/plan-spec → plan.md"]
  Plan --> Tasks["/tasks → tasks.md"]
  Tasks --> Implement["/implement"]
  Implement --> Goal["持久 DSH goal"]
  Goal --> Verify["验证任务 → 勾选 tasks.md"]
  Verify -->|下一任务| Implement
  Goal -->|新会话| Resume["/specflow → /implement"]

examples/001-resumable-export 提供一套停在 2/4 进度的完整示例文件,可以直接查看断线续跑时保存了什么。

它解决什么问题

SpecFlow 把需求、技术方案和任务进度写入可审查的工作区文件,不依赖某一次对话的记忆。一个持久 goal 对应整份规格,单项任务进度始终以 tasks.md 为准。

SpecFlow 包含以下能力。

  • 5 个可移植技能,包括 constitution、specify、plan-spec、tasks 和 implement;
  • 6 个可在 UI 发现的命令,包括 /specflow、/constitution、/specify、/plan-spec、/tasks 和 /implement;
  • 从 tasks.md 读取复选框进度的 specflow_status 工具;
  • /implement 阶段的 goal 创建和显式恢复;
  • 注入 DSH runtime context 的当前目标与任务进度;
  • spec.md、plan.md、tasks.md 模板。

文件协议

.dsh/
├── memory/
│   └── constitution.md
└── specs/
    └── 001-example-feature/
        ├── spec.md
        ├── plan.md
        └── tasks.md

规格目录是持久状态的唯一事实源。插件不另外维护隐藏的任务数据库,也不为保存任务状态增加必需的自定义会话事件。

权限与数据

  • SpecFlow 通过 DSH filesystem service 读取 tasks.md。各技能可能要求 Agent 经由当前 profile 的正常工具与审批策略,在 .dsh/memory/ 和 .dsh/specs/ 下创建或更新文件。
  • 开启 autoInjectContext 后,当前 goal 与最近一次读取的任务计数会进入模型可见的 runtime context。
  • 插件不发起网络请求,不读取凭据,不发送遥测,也不注册自定义持久会话事件。

安装

当前代码支持 DSH >=0.1.0-rc.6 <0.2.0 插件 API,要求 Node.js ^22.19 || >=24。

dsh plugin --profile web add dsh-specflow

需要固定当前版本,或者不通过 npm 解析时,可以安装预构建的 GitHub Release tarball。

dsh plugin --profile web add https://github.com/lonelymoon87/dsh-specflow/releases/download/v0.1.4/dsh-specflow-0.1.4.tgz

Release tarball 不需要构建权限。也可以固定版本从源码安装。

dsh plugin --profile web add github:lonelymoon87/dsh-specflow#v0.1.4

源码安装会运行本包的 prepare 构建。pnpm 10 及以上版本默认拒绝执行,第一次安装失败时请按 DSH 输出的提示,将准确的包键加入 profile 的构建白名单,然后重新执行同一条命令。需要装进一次性 Agent profile 时,把命令中的 web 换成 headless。

升级时用新版本的 Release URL 再执行一次 dsh plugin add。卸载时执行

dsh plugin --profile web remove dsh-specflow

安装后,用同一 profile 启动 DSH,再依次执行

/specflow
/constitution 每一项行为改动都必须有聚焦测试
/specify 给 CLI 增加可恢复的导出任务
/plan-spec 001-resumable-exports
/tasks 001-resumable-exports
/implement 001-resumable-exports

/specflow <NNN-slug> 会直接显示持久任务进度、下一项任务、文件位置和准确的恢复命令。Agent 也可以通过 specflow_status 读取同一份状态。

配置

- id: specflow
  name: dsh-specflow
  config:
    specsDir: .dsh/specs
    autoInjectContext: true

specsDir 可以是工作区相对路径或绝对路径。autoInjectContext 只控制模型可见的进度快照,不改变 goal 和文件工件的行为。

发布验证

  • v0.1.4 tarball 已从 HTTPS Release URL 直接安装进全新的 DSH 0.1.0-rc.8 与 0.1.1-rc.1 profile;
  • 同一份预构建包已经作为 dsh-specflow 发布,并通过公开 npm registry 完成安装验证;
  • pack 产物与固定版本 GitHub 源码安装均通过 dsh --dump-config 检查;
  • CI 覆盖 Node 22.19 与 Node 24,兼容矩阵会分别使用 DSH 0.1.0-rc.8、npm latest 与 next 标签重跑真实安装;
  • bug 与兼容性问题统一进入 GitHub Issues。

许可证

MIT