前言¶
在 DeepSeek Harness(DSH)里做智能体或复杂任务时,常见瓶颈不是模型能力,而是提示词本身:目标含糊、约束没写清、交付形态不确定,对话里改几轮仍难复制复用。手写模板或一次性让模型「帮写 prompt」往往缺少结构化核对,定稿后仍漏关键要素。
下面介绍社区插件 dsh-prompt-forge(提示词锻造台):在对话中通过多轮、带选项的反问,逐项确认十项要素,并在侧边栏面板里展示完整度与草稿,最终输出可直接复制的提示词。维护者为 ayi-maker,在 SkillHub 目录中归类为工作流;源码与说明见 GitHub 仓库,许可为 MIT(package.json 版本 1.0.0)。
这是什么¶
dsh-prompt-forge 是 DSH 插件:你把一句模糊想法交给助手 → 助手每轮抛出 3–5 个带选项的问题 → 你点选或补充 → 十项要素逐项确认 → 定稿为完整提示词。
主面板「提示词」页会实时显示:完整度百分比、十项要素确认状态、实时草稿、仍缺哪些信息,以及历史记录。会话 id 与当前 Agent 会话绑定,斜杠命令、工具调用与面板看到的是同一条锻造记录。
核心功能¶
三种入口¶
| 入口 | 用法 |
|---|---|
| 直接说 | 例如「我想做个 X,但描述不清」→ 助手自动进入锻造流程 |
| 斜杠命令 | /prompt 我的想法 |
| 侧边栏 | 点击铅笔图标 → 打开锻造台面板 |
十项要素¶
要素定义以仓库内 slots.js 为唯一事实来源,工具与面板同步:
outcome目标与成功标准deliverable交付物形态constraints硬约束context背景与输入quality质量标准audience受众role角色method方法examples参考样例risks失败模式
定稿规则(README 原文语义):priority 1(outcome / deliverable / constraints / context)与 priority 2(quality / audience)齐备才算「可定稿」;priority 3–4 未确认时,定稿会整节省略对应段落,而不是留「待补」占位。要素设计理由见仓库 WHY-THESE-SLOTS.md。
Agent 工具 prompt_forge¶
Host 向 Agent 注册 prompt_forge 工具,action 包括:
start / update / draft / finalize / status / list / get / delete
数据与 UI 同步方式¶
持久化路径(默认):
~/.dsh/prompt-forge/store.json
即环境变量 $DSH_HOME/prompt-forge/store.json;最多保留 200 条,为普通 JSON,可备份或手工编辑。
面板不轮询:通过 session projection(promptForge,每次 prompt_forge 工具调用计数 +1)感知变化;dock 订阅投影后拉全量,主面板从浏览器内共享 store 读取。运行时除 zod(projection schema)外无其他运行时依赖,无构建步骤。
安装与启用¶
package.json 要求:
- Node:
^22.19.0 || >=24.0.0 - DSH:
>=0.2.1-rc.1 <0.3.0-0
README 给出的安装方式为本地 bundle 安装(将 <绝对路径> 换为你本机插件目录):
plugin_manager { action: "install_bundle", target: "<绝对路径>/dsh-prompt-forge" }
Client 改动通过软链可即时生效,刷新页面即可;Host 改动需重装或重启 DSH 进程。
安装前请自行阅读源码与 MIT 许可证;插件在当前 DSH 进程权限下运行,会读写上述 store.json。
典型用法¶
- 在对话中说清模糊需求,或使用
/prompt 我的想法。 - 按助手每轮 3–5 个带选项的问题点选或补充,观察侧边栏「提示词」页的完整度与要素状态。
- 当 priority 1、2 要素满足「可定稿」条件后,通过对话或
prompt_forge的finalize定稿,从面板复制完整提示词到后续任务。
需要查看或清理历史时,可用 list / get / delete 等 action(由 Agent 经工具调用)。
适用场景与注意¶
适合:经常要把产品想法、任务说明、角色设定等从零整理成结构化提示词的 DSH 用户;希望在同一 Agent 会话里对话锻造与面板状态一致的场景。
注意:
- 未确认的 priority 3–4 要素在定稿时会被省略,若需要样例、风险等段落,请在定稿前在面板或对话中确认对应 slot。
- 社区目录 SkillHub 插件页 与 GitHub 为独立信息源,与 DeepSeek / 幻方无官方从属关系;星标与版本以你安装时的仓库为准。
- 开发自检可运行 README 中的
node --check与test/*.mjs(需在克隆或解压后的插件目录内执行,本文不展开 clone 步骤)。
结尾¶
dsh-prompt-forge 把「模糊一句话」变成可核对、可定稿、可复制的提示词,并把完整度与十项要素状态放在面板里,减少漏写约束与交付形态的情况。
- 目录页:https://www.skillhub.cn/plugins/ayi-maker/dsh-prompt-forge
- GitHub:https://github.com/ayi-maker/dsh-prompt-forge