godv61/dsh-task-engine

DSH Task Engine

把开发步骤、技能规则和交付记录，放进一个个人工作台。
A personal engineering workflow workbench for DeepSeek Harness.

快速开始 ·
工作台 ·
使用文档 ·
功能规划 ·
更新日志

为什么用它

让 AI 修改代码时，你可以先明确需求，再检查方案、推进实施、验证结果，最后审核提交。DSH Task Engine 把这些步骤组织成可检查、可追踪的任务流程，适合在本机使用 DeepSeek Harness 开发个人项目。

- 知道下一步做什么：按所选流程推进，当前阶段需要的条件和产物清楚可查。
- 复用自己的工作方法：把技能和规则安装到项目或个人目录，再挂到对应阶段。
- 找得到过程记录：任务台账集中查看阶段、实施项、验证与审核状态。

快速开始

需要已安装 DeepSeek Harness 和 pnpm。插件装入你使用的 Web profile；下面以 web 为例。

dsh plugin --profile web add @godv61/dsh-task-engine

1. 重启 Harness Web，打开侧边栏的 工程流程。
2. 选择工作区，在 流程配置 中选择一套流程。
3. 新建会话，选择 工程化开发引擎 预设，描述要完成的开发任务。

看到“工程流程”入口和“工程化开发引擎”会话预设，就说明工作台与任务工具已接入。使用 Harness 源码启动的安装方式见安装与启用。

工作台中的“流程预设”决定任务怎么推进；会话中的“工程化开发引擎”预设负责启用 dev_task 工具。两者作用不同。

工作台里有什么

| 页面 | 你可以做什么 |
| :--- | :--- |
| 项目初始化 | 查看或编辑 AGENTS.md，让 AI 生成项目说明，预览后保存。 |
| 流程配置 | 选择内置流程，为各阶段追加技能和规则。 |
| 任务台账 | 查看实施、验证和审核记录，按关键词、阶段或风险筛选。 |
| 技能 | 选择技能文件夹，预览内容与目标目录后安装；支持查看、编辑和删除。 |
| 规则 | 选择 Markdown 文件安装规则，维护项目或个人开发约定。 |

内置技能和规则只读；项目与个人资源可编辑。安装、删除都会明确展示目标位置。

选择适合这次任务的流程

| 预设 | 阶段顺序 | 适用场景 |
| :--- | :--- | :--- |
| 标准研发 standard | 需求评审 → 设计 → 开发 → 交付 → 代码审核 → 完成 | 需要需求、方案和交付检查的完整开发任务。 |
| 敏捷轻量 agile | 需求 → 开发 → 交付 → 审查 | 希望保留任务记录、减少阶段和产物的迭代。 |
| 纯代码 minimal | 开发 → 交付 | 已明确做法的小改动。 |

当前版本的阶段顺序和检查条件由预设固定，默认技能/规则绑定只能追加。可视化自定义流程正在规划，尚未发布，具体范围见功能规划。

把自己的技能和规则带进来

选择文件 → 检查预览 → 选择范围 → 确认安装 → 挂到阶段。

技能选择含 SKILL.md 的文件夹，规则选择一个 .md 文件。预览会显示名称、正文、文件数、体积和目标路径；同名资源不会被覆盖。

| 安装范围 | 存放位置 | 用途 |
| :--- | :--- | :--- |
| 项目 | 工作区 .dsh/skills、.dsh/rules | 当前项目的工作方法与约定。 |
| 个人 | $DSH_HOME/skills、$DSH_HOME/rules | 在这台电脑上的多个项目间复用。 |

技能的脚本、模板和附件会一并保留。文件格式、大小限制和故障处理见技能与规则安装指南。

使用文档

| 想了解什么 | 从这里开始 |
| :--- | :--- |
| 安装、启用与第一次使用 | 快速上手 |
| 项目配置与阶段绑定 | 流程配置 |
| 技能文件夹与 Markdown 规则 | 资源安装 |
| 完整操作说明 | HTML 手册（下载后在浏览器打开） |
| 当前能力与常见问题 | 常见问题 |
| 本地开发与验证 | 开发指南 |
| 真实项目回归修复 | 0.23.1 发布说明 · 回归迭代说明 |
| 版本变化与验证记录 | 更新日志 · 0.23.1 测试说明 |

能力说明

dev_task 按配置检查阶段、产物和提交条件。0.23.1 新任务验证要求真实命令回执；附加技能的回执要求可在任务状态中查看，内置技能使用已有的记录、验证、审核和提交操作。任务保存创建时的流程快照，之后修改项目配置不会直接改变进行中的任务。

审核结论、实施项完成情况和测试覆盖面仍需要你判断。本地提交钩子提供即时检查，不能替代人工审核或项目自己的 CI。详细说明见常见问题。

小修正允许主代理处理，仍须审核和验证。遇到沙箱权限拒绝应使用宿主审批或报告阻塞，不能靠反复切换命令规避。

状态查询会列出过期验证和附加技能回执；commit.allowed 同时检查这些阻塞，文件变化后先补验证再申请提交。

验证命令的单次权限重试先审批后执行，不改变会话权限；操作方式见验证权限说明。

记录需求、方案或评审前，模型可从 artifact_requirements 获取当前阶段允许的字段和缺项，避免猜测字段名。

MIT License · 反馈问题 · Built for DeepSeek Harness