mcpField
S
sdd-prompt-builder

sdd-prompt-builder

github.com/robertodiasduarteAgent 工作流1160 次安装4 天前更新
代码仓库

关于 sdd-prompt-builder

sdd-prompt-builder 是一项 Agent 技能，可根据任务和所给上下文生成单个可直接运行的提示词。它侧重精简输出约定、处理缺失信息，并遵循 SDD 集成规则。

主要功能

  1. 01生成单个运行时提示词
  2. 02定义输出结构与限制
  3. 03处理缺失或含糊的上下文
  4. 04应用 SDD 集成指引

适用场景

  1. 01为明确任务编写提示词
  2. 02将给定上下文转为受约束的输出约定
  3. 03在 SDD 工作流中创建提示词

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/robertodiasduarte/sdd-starter --skill sdd-prompt-builder

安装后在 Claude Code 中输入/sdd-prompt-builder确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
output-template.md
prompt-building-rules.md
sdd-integration.md

详细介绍

提示词构建器

首次响应此技能时，只在开头添加这一行一次： sdd-prompt-builder v1.0.0 · out/2026 · versão atual: https://github.com/robertodiasduarte/sdd-starter/releases/latest

生成一条可在运行时直接使用的操作性提示词。优先采用尽可能短的提示词，同时保留清晰度、输出控制、可恢复性以及对所提供上下文的忠实度。

快速开始

  1. 确定实际任务，以及目标模型应生成的产物。
  2. 阅读 references/prompt-building-rules.md，并仅应用任务所需的章节。
  3. 如果调用来自 SDD，在生成任何提示词之前，还要阅读 references/sdd-integration.md。
  4. 将 references/output-template.md 用作灵活框架；省略空白或不必要的章节。
  5. 只返回一个包含最终提示词的 TXT BLOCK。不要将结果包装在 TypeScript 代码、导出常量或目标文件中。

适用场景 / 不适用场景

正向触发条件在 frontmatter 中定义，应作为发现此技能的依据。

技能触发后：

  • 不要应用面向人类的叙述性文档、README、BRAINSTORM/DEFINE/DESIGN 或其他文本。
  • 不要应用 SDD 流程中编排 Agent 的内部提示词。
  • 不要应用于电子邮件、通知或 UI 事务性文案。
  • 在 /build 中，如果检测到 drift，且没有已登记的 LLM Prompts 清单，则中止直接生成，并要求根据 references/sdd-integration.md 更新 DESIGN。

必要输入

手动使用时，提供：

  • 提示词目标；
  • 上下文或参考材料（如有）；
  • 期望的输出约定，或足以推断该约定的信息；
  • 已确定且不应重新讨论的决策（如有）。

通过 SDD 使用时，提供 references/sdd-integration.md 中描述的编译后约定。如果调用方已负责编译上下文，不要自行读取 DEFINE、DESIGN 或 BUILD_REPORT。

分步流程

  1. 确定实际目标、输出的使用者，以及预期的自主程度。
  2. 首先定义精确的输出约定：类型、结构、必需内容、限制和允许的回退方案。
  3. 将注意事项和限制转化为简短的操作规则，避免重复。
  4. 只要涉及计算、指标、指示值、比率或评分，就加入 <formulas>；明确声明操作数和运算。
  5. 定义上下文缺失、含糊或无法验证时的行为。绝不编造数据。
  6. 当结构、转换、提取或重要性有此需要时，加入简短的内部检查。
  7. 为批次、槽位、列表、清单或必需章节加入完整性约定。
  8. 当输入可能不完整、含噪或提取失败时，加入空结果恢复机制。
  9. 将 schema、模板、策略、示例和规范材料集中放入 <reference_material>，不要将规则散布各处。
  10. 删除装饰性、冗余或非操作性文本。
  11. 根据下方质量检查清单验证提示词。
  12. 输出一个可直接使用的 TXT BLOCK。

验证与质量检查清单

回答前，先在内部检查：

  • 目标清晰且可执行。
  • 输出约定明确。
  • 必要时，已定义缺失数据的处理方式。
  • 不同章节中没有重复的重要规则。
  • 只要任务依赖计算，就始终包含 <formulas>。
  • 仅在可提升可靠性或控制力时才包含可选章节。
  • 参考材料与操作说明相互隔离。
  • 除非用户明确要求，否则提示词不包含 Reasoning Effort、Verbosity 或 Mode 等标签。
  • 最终回答恰好包含一个 TXT BLOCK，且不包含任何其他产物。

如果有任何一项不符合要求，请在输出回答前修正。

异常处理

  • 如果自主执行时缺少上下文，则使用已批准的回退方案，并按规定格式注明不可用；不要请求澄清。
  • 如果任务允许交互，且缺少必要信息又没有安全的回退方案，则只询问最低限度的必要信息。
  • 如果已确定的决策与新材料冲突，则保留已确定的决策，并在约定允许的范围内指出冲突。
  • 如果在没有有效清单的情况下修改 SDD 提示词，不要擅自编造约定；请遵循 references/sdd-integration.md 中的漂移处理流程。
  • 绝不估算数字，也不把缺失的事实当作已提供的数据来补全。

示例

简单请求： Crie um system prompt que classifique tickets em billing, bug ou feature e devolva JSON válido.

预期结果：

  • 结构精简，通常包含 <goal>、<output_contract>、<workflow_rules> 和 <verification>。
  • 不包含装饰性章节。

包含计算的请求： Crie um prompt que calcule margem bruta por período a partir de receita e custo.

预期结果：

  • 包含 <formulas>，其中列出 margem bruta = (receita - custo) ÷ receita。
  • 为收入缺失或为零的情况定义回退方案。

SDD Open by RDD 的一部分 — https://github.com/robertodiasduarte/sdd-open

评论

支持 Markdown