BrambleXu/dsh-prompt-profile
Reusable Markdown prompt profiles for DeepSeek Harness with per-turn model selection, argument substitution, and state restoration. DeepSeek Harness 可复用 Markdown Prompt Profile,支持单轮模型选择、参数替换和状态恢复。
已收录
1
Dev
Bundle 已验证
预览
功能介绍
DeepSeek Harness 可复用 Markdown Prompt Profile,支持单轮模型选择、参数替换和状态恢复。
适合
- 需要跨会话重复使用标准化审查、分析或任务提示词的团队。
- 需要为单轮选择提供商、模型和推理强度,并在之后自动恢复的工作流。
- 希望用仓库级 Markdown Profile 覆盖可复用用户级 Profile 的项目。
- 需要将位置参数或参数区间替换进提示词正文的命令。
不适合
- 需要多步 Prompt Chain、循环或 best-of-N 编排的流程。
- 需要技能注入、子代理或 worktree 管理的工作流。
- 无需复用的单次提示词场景,此时 Profile 发现、路由和恢复机制价值有限。
README
dsh-prompt-profile

English | 中文
Reusable Markdown prompt profiles for DeepSeek Harness. A profile can select a provider, model, and reasoning effort for one turn, render command arguments into its body, and restore the previous selection afterward.
Why this exists 💡
Model choice and review instructions are often repeated across sessions. dsh-prompt-profile turns those combinations into small, reusable Markdown profiles that can be invoked for one turn and then leave the Agent’s previous model selection intact.
Features ✨
- Discover profiles from user and project directories, with project profiles taking precedence.
- Substitute positional arguments into profile bodies with shell-style placeholders.
- Select a provider, model, and reasoning effort for one turn.
- Restore the previous Agent selection automatically or opt out per profile.
- List available profiles and invoke nested profiles by slash-separated names.
Install 📦
dsh plugin --profile demo add ./dsh-prompt-profile
Create a user profile under ~/.dsh/prompt-profiles/ or a project profile under <repo>/.dsh/prompt-profiles/:
---
description: Deep code review
provider: deepseek
model: deepseek-reasoner
reasoningEffort: high
restore: true
---
Review $1 for correctness, regressions, and missing tests. Extra context: ${@:2}
Project profiles override user profiles with the same relative name.
Use 🚀
/prompt-profile list
/prompt-profile review src/index.ts "focus on cancellation"
Nested files use slash-separated names. For example, .dsh/prompt-profiles/review/security.md is review/security.
Supported placeholders:
| Placeholder | Value |
|---|---|
$1, $2, … |
One positional argument |
$@, @$, $ARGUMENTS
|
All arguments |
${@:N} |
Arguments from position N |
${@:N:L} |
L arguments from position N |
Frontmatter 🧾
| Field | Required | Meaning |
|---|---|---|
description |
No | Text shown by /prompt-profile list
|
provider |
With model
|
Harness provider route |
model |
With provider
|
Provider-owned model ID |
reasoningEffort |
With provider and model
|
Adapter-owned reasoning effort ID |
restore |
No | Restore the prior selection after the turn; defaults to true
|
Omit both provider and model to use the current agent selection.
Configure ⚙️
- id: dsh-prompt-profile
name: dsh-prompt-profile
config:
userDirectory: ~/.dsh/prompt-profiles
projectDirectory: .dsh/prompt-profiles
Develop 🧑💻
pnpm install
pnpm run check
Scope 🎯
Version 0.1 intentionally omits prompt chains, loops, skill injection, subagents, worktrees, and best-of-N orchestration. Those features should be added only when Harness extension points can preserve their lifecycle and durable-session semantics.
License 📄
MIT
Credits 🙏
The core idea comes from pi-prompt-template-model. This first Harness-native release focuses on the smallest useful unit: deterministic discovery, argument substitution, scoped model routing, and restoration.
常见问题常见问题
在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:BrambleXu/dsh-prompt-profile。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。
兼容性以页面上展示的 bundle 与 profile 状态为准。如果某个 profile 尚未检测到,请先保持禁用,并在生产启用前阅读仓库文档。
GitHub 链接和 activity 元数据是 release 与维护状态的来源。新版本发布后重新查看本页,确认目录已经观察到最新版本。