lonelymoon87/dsh-specflow

面向 DeepSeek Harness 的规格驱动开发套件，直接使用 DSH 原生的 skill、command、goal、tool 和 runtime context。

可安装的 v0.1.2 面向 DSH 0.1.0-rc.6。本项目当前通过 GitHub Release 分发预构建包，尚未发布 npm 包。

English

它解决什么问题

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

MVP 包含以下能力。

• 5 个可移植技能，包括 constitution、specify、plan-spec、tasks 和 implement；
• 4 个可在 UI 发现的命令，包括 /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

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

安装

当前代码面向 DSH 0.1.0-rc.6 插件 API，要求 Node.js ^22.19 || >=24。

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

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

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

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

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

dsh plugin --profile web remove dsh-specflow

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

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

配置

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

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

发布验证

• v0.1.2 tarball 已从 HTTPS Release URL 直接安装进全新 DSH profile；
• pack 产物与固定版本 GitHub 源码安装均通过 dsh --dump-config 检查；
• CI 覆盖 Node 22.19 与 Node 24，定时任务会用 @deepseek-ai/dsh@latest 重跑真实安装；
• bug 与兼容性问题统一进入 GitHub Issues。

许可证

MIT