DSH Dev Workflow

把研发对话变成可验证、可交接、可复盘的闭环。
Request → Feedback → Task → Verify → Completion

一个面向 DSH 的轻量研发交付助手。它记录决策与证据，但不会把普通聊天自动变成长期记忆。

为什么用它？

AI coding 的瓶颈往往不是“不会写”，而是上下文断裂、决策丢失、验证不可追溯。

DSH Dev Workflow 把交付过程变成一条可读的证据链：

用户原话 → 可执行任务 → 真实验证 → 带证据的交付总结
     ↘ 反馈与决策 ↗        ↘ 可复盘知识 ↗

它不是一个替你执行一切的“自动驾驶按钮”，而是一个让 AI 更像靠谱队友的工作协议：知道什么时候应该问、什么时候应该等确认、什么时候必须拿证据。

Preset 的性格

冷静、克制、可追责。

• 不把普通聊天自动变成长久记忆；
• 不把“我应该通过了”当成测试证据；
• 不把反馈悄悄升级为团队规范；
• 不跨项目读取，不自动安装依赖，不自动提交；
• 破坏性动作先停下来，把风险和选择交给人。

它的核心优先级是：安全边界 > 仓库规范 > 项目目标 > 用户偏好 > 当前请求。

真实环境里为什么有用？

真实问题	没有闭环时	有了 Dev Workflow
需求在聊天里变化	AI 只记住最后一句	原话、范围、验收条件可回看
多轮反馈互相矛盾	只能靠上下文猜	每条反馈有决策与影响
“已经测过了”	没有退出码和命令	验证记录绑定任务和结果
换人或隔天继续	重新解释项目	dev_context_get 给出有界摘要
长期知识污染	一次偏好变成永久规则	只有明确确认才 promote

记录到底长什么样？

插件使用本地 append-only JSONL。下面是脱敏后的示例，不是预置数据：

{"schemaVersion":1,"requestId":"req_7f21","rawQuote":"把登录页的错误提示改得更清楚","acceptance":["空密码显示字段级提示","错误提示不泄露账号是否存在"],"status":"captured"}
{"schemaVersion":1,"feedbackId":"fb_12ac","requestId":"req_7f21","rawQuote":"文案要短一些，但保留可操作建议","decision":"accept","category":"quality","status":"recorded"}
{"schemaVersion":1,"taskId":"task_91de","title":"更新登录错误提示","acceptance":["单元测试覆盖两种错误分支"],"status":"queued"}
{"schemaVersion":1,"verificationId":"verify_44aa","taskId":"task_91de","command":"npm test -- login","exitCode":0,"status":"passed"}
{"schemaVersion":1,"completionId":"completion_08c1","taskId":"task_91de","status":"succeeded","verificationRefs":["verify_44aa"]}

每个项目默认写入：

<your-project>/.dsh-dev/
├── requests.jsonl
├── feedback.jsonl
├── tasks.jsonl
├── verifications.jsonl
├── completions.jsonl
└── knowledge.jsonl

这些记录只保存在本地；请勿写入密钥、客户资料或其他敏感信息，并确保 .dsh-dev/ 不提交到 Git。

安装

DSH Add plugin

在 DSH 的 Add plugin 中搜索：

dsh-plugin-dev-workflow

Plugin manager

plugin_manager install_bundle target=dsh-plugin-dev-workflow

本地开发

plugin_manager install_bundle target=<本目录绝对路径>

安装后新建会话，选择 研发助手 · Dev Assistant。不要手写 profile 的 package.json 或 cordis.patch.yml。

工具箱

• dev_context_get — 读取项目上下文、未完成任务与最近反馈
• dev_request_capture — 保留用户原话并登记验收条件
• dev_feedback_record — 记录反馈与决策，不自动升级为长期规范
• dev_task_plan — 创建带依赖、风险和验收条件的任务
• dev_verify — 记录验证命令与真实退出码
• dev_complete — 生成带证据的完成总结
• dev_knowledge_promote — 仅在用户明确确认后沉淀知识

兼容性

• DSH：>=0.2.1-rc.2 <0.3.0
• Node.js：>=22.19.0
• 当前版本：0.1.0

开发

node verify/smoke.mjs
node --check index.js
npm pack --dry-run

路线图

• 真实宿主执行器与验证证据绑定
• 完成任务自动更新状态
• 路径边界校验与敏感信息检测
• 干净 profile 安装测试与 CI

项目链接

• Repository: https://github.com/yuna78/dsh-plugin-dev-workflow
• Changelog: CHANGELOG.md
• Issues: https://github.com/yuna78/dsh-plugin-dev-workflow/issues
• npm: https://www.npmjs.com/package/dsh-plugin-dev-workflow

License

MIT