Prompt Spark:把短草稿扩成可执行的结构化提示词

前言

在 DSH Composer 里写提示词,常见问题是想法只有一两句,下游模型却需要任务边界、验收标准和约束才能稳定执行。手工逐条补全费时,单纯「润色文笔」的工具又未必给出机器可解析的骨架。Prompt Spark(提示词火花)面向这类场景:在保持输入语言的前提下,把模糊草稿扩成带固定标签的结构化提示词,并支持在替换前全文审阅与编辑。

这是什么

Prompt Spark 是维护者 Erfan817 发布的 DeepSeek Harness 插件,npm 包名为 dsh-prompt-enhancer-plus,当前版本 1.6.0,许可证 MIT。仓库分类上属于模型推理相关能力;一句话定位是:把粗糙想法变成 AI 能稳定解析、人也能直接阅读的可执行提示词。官方简介强调不会在未确认的情况下自动发送任何内容。

除 DSH 外,同一套规则核心还可通过本机服务对接 VS Code/Cursor、Claude Code、CLI 与全局热键等入口;下文以 DSH 安装与 Composer 用法为主,其他 harness 仅作对照说明。

核心功能

结构化输出契约

增强结果使用纯文本标签,不是 Markdown 或 JSON。稳定锚点为英文标签:Task:、Requirements:、Acceptance criteria:、Constraints:;在「详细」档会补充 Context:、Failure cases:。标签后的正文跟随用户草稿语言(中文草稿则正文多为中文)。

三档详细度

  • 简洁:主要润色,结构最少。
  • 标准:适度补充结构,为默认档。
  • 详细:展开边界、验收标准与失败情形。

项目感知(DSH)

在 DSH 会话工作区内,插件会读取 AGENTS.md、CLAUDE.md、README.md、README.zh.md、package.json 作为参考,使强化结果更贴合当前项目上下文。

人格与预览

可保存并跨会话复用改写方向(如产品、工程、写作、极简等 persona)。替换草稿前可编辑完整预览;提供最近五条记录与十秒撤销。

与「只变好读」工具的差别

README 中的设计目标是「可执行」:既要结构化到下游模型能解析,又要自然到人可审阅。DSH 可在 Composer 工具栏提供原生 强化提示词 按钮;其他 harness 受宿主 API 限制,通常通过面板、斜杠命令或本机服务等价实现。

环境要求

  • DSH:>= 0.2.2-rc.1(见 package.json 的 engines.dsh)
  • Node:>= 22(README 徽章说明)
  • 非 DSH 适配器需先运行桌面伴侣本机服务(监听 127.0.0.1 回环端口)

安装与启用(DSH)

通过 DSH 插件管理器安装插件源码目录,然后重启 DSH。资料未给出 dsh plugin add github:... 一类一键命令,安装方式以管理器挂载源码目录为准。

可在 DSH 插件配置中按需调整输入输出与超时(示例来自 README):

- id: prompt-enhancer-plus
  name: dsh-prompt-enhancer-plus
  config:
    maxInputChars: 12000
    maxOutputTokens: 3000
    timeoutMs: 90000

典型用法(DSH Composer)

  1. 在 Composer 输入框写下短草稿。
  2. 点击工具栏 强化提示词(可先选详细度与人格,若界面提供)。
  3. 在预览中审阅或修改结果。
  4. 选择 替换草稿 写回输入框,或 复制 到别处使用。

同一草稿在三档下的形态差异,官方用「导出 CSV」为例说明(节选):

简洁 / concise
Task: 做一个导出 CSV 的功能。
Requirements: 1. 可选择导出字段;2. 支持 UTF-8。

标准 / standard
Task: 做一个导出 CSV 的功能。
Requirements: 1. 可选择导出字段;2. 支持 UTF-8。
Acceptance criteria: 导出文件能在 Excel 中正常打开,字段与选择一致。
Constraints: 不修改现有数据结构。

详细 / detailed
Task: 做一个导出 CSV 的功能。
Context: 现有系统已支持列表筛选,导出需复用筛选结果。
Requirements: 1. 可选择导出字段;2. 支持 UTF-8;3. 大数据量分批写入。
Acceptance criteria: 导出文件能在 Excel 中正常打开;字段与选择一致;10 万行内不超时。
Constraints: 不修改现有数据结构;不新增第三方依赖。
Failure cases: 无数据时导出空文件并提示;字段全不选时按钮禁用。

其他入口(可选)

若你在 Cursor / VS Code 使用同名能力,需先启动桌面伴侣:

npm install --ignore-scripts
npm run desktop

VS Code / Cursor 扩展安装示例(README 给出打包与安装命令):

cd vscode-extension
npx @vscode/vsce package --allow-missing-repository
code   --install-extension prompt-spark-vscode-1.0.0.vsix
cursor --install-extension prompt-spark-vscode-1.0.0.vsix

Claude Code 可将 .claude/commands/enhance.md 复制到项目或用户级命令目录后使用 /enhance ...。CLI 示例:

echo "帮我做一个导出 CSV 的功能" | node cli/enhance.mjs --level detailed

工作原理上,除 DSH 内嵌路径外,适配器多通过本机服务 POST /api/enhance 调用统一的 prompt-core.js 规则集。

适用场景与注意

适合:习惯在 Composer 先写短意图、再交给模型做实现或推理的 DSH 用户;需要在同一会话内利用工作区 AGENTS.md 等文件对齐项目约定的团队。

务必注意:

  • 插件以当前 DSH 进程权限运行,安装前应自行查看仓库源码与 MIT 许可证,确认可接受其读取工作区内上述参考文件的行为。
  • 强化过程会调用模型推理,受 maxInputChars、maxOutputTokens、timeoutMs 等配置约束;超长草稿可能被截断或超时。
  • DSH 社区插件目录(SkillHub)为独立站点,与 DeepSeek / 幻方无官方从属关系;列表信息以你本地安装的版本为准。

结尾

Prompt Spark 的价值在于用一套固定标签把「想说一句」变成「能执行一段」,并在 DSH 里用 Composer 按钮完成草稿—预览—替换的闭环。了解更多可看社区目录页与 GitHub 仓库:

  • 目录页:https://www.skillhub.cn/plugins/Erfan817/prompt-spark
  • GitHub:https://github.com/Erfan817/prompt-spark
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜