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
羽毛球分组比赛记分
小程序二维码

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

小夜