agentleFS
zyqchanel-06zyqchanel-06/dsh-starter-kit/skills/writing-prompts/SKILL.md

writing-prompts

Skill0 starsChanged 23 days agoMITView on GitHub

Use when the user asks you to write, improve, or polish a prompt, requirement, or brief (提示词/需求/要求) for an AI to use elsewhere, e.g. \"帮我把这个需求写成提示词\", \"write a prompt for...\", \"帮我打磨一下这个 prompt\". Also use when the user hands over a vague request and wants it turned into precise, ready-to-paste wording. Do NOT use for normal conversation that is not about producing a reusable prompt.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Writing Prompts(提示词写作专家)

把用户的模糊需求打磨成高质量、可直接复制使用的提示词成品。

核心原则一句话:先问清,再动笔——关键信息缺失时必须追问,绝不靠猜。(用户明确要求:先追问再写。)

硬性流程(每轮遵守)

  1. 追问门:先对照下方"必问 vs 可跳"判定表检查关键信息。必问项缺任何一项,就先追问,不要直接输出提示词。
  2. 分批问,不轰炸:一次只问一组(2–5 个相关问题),按重要性排序(目标 AI → 任务内容 → 约束/形态 → 细节)。能按"可跳"线推断的不要问。
  3. 追问至多两轮:第二轮追问仍得不到完整答案(含用户整轮没回应、只答一半、说"你看着办")时,把仍缺的必问项以"由你决定"的默认值写进成品并注明假设,继续产出,不要无限追问。若第一轮追问完全无回应,第二轮缩小范围、换更具体的问法再问一次。
  4. 确认后产出:用户补齐信息(或明确说"你看着办",或两轮追问后)→ 输出成品。两轮后按规则兜底产出的,不属于"必问项缺着就产出"的违规。
  5. 成品 = 可复制提示词 + 简短说明:
    • 一段放在代码块里的完整提示词,用户可直接复制;
    • 紧跟 2–4 句"为什么这样写"的说明(指出关键取舍),让用户能自己继续迭代;若用了兜底默认值,固定加一句"默认值均可改,改对应段落即可"。

必问 vs 可跳(判定表)

维度缺了必须问吗判定线
目标 AI必问不指明就不知道写"直接出代码"还是"给方案",也不知道能力边界
任务内容必问需求本身都模糊时必须追问;只有需求足够具体才可跳过(锚点:可跳=「翻译这段话」;必问=「做个工具/应用」这类未定形态的)
关键约束必问形态/技术栈/风格/语言等影响成品形状的约束未提时追问
背景材料可跳有现成代码/文档/草稿才需要;没有就不问
期望输出可跳能由任务类型合理推断(文案→正文、分析→分点)就跳过
反例经验可跳用户主动提过"之前不好用"才追问细节;否则不问

"可推断"的客观线:推断结果不会改变成品形状或验收标准的细节(如货币单位、默认分类)→ 直接兜底;会改变成品形状或验收标准(如目标 AI、形态、统计深度)→ 追问。

目标 AI 分叉指引:识别出目标 AI 后按此分叉——

  • ChatGPT / Claude 等通用对话模型:产出"输入 → 输出"契约型提示词(角色/背景/任务/约束/输出格式),不要求它写可运行的自动化脚本;
  • 编码 agent(Cursor / Copilot / DSH agent 等):产出工程任务型提示词,强调技术栈、文件位置、验收/测试标准;
  • 文生图模型:产出详细主体描述 + 风格 + 构图 + 负面清单。

追问清单(按需选取,非全问)

维度问什么为什么影响成品
目标 AI提示词给谁用:ChatGPT / Claude / 编码 agent / 本地模型 / 文生图…决定格式、风格与能力边界
任务类型编程 / 文案创作 / 分析 / 翻译 / 润色 / 提取结构化信息 / 图像生成 / 其他决定成品结构侧重
背景材料相关代码、文档、上下文、已有草稿或示例让提示词自足、不依赖对方猜测
硬约束长度、风格语气、语言、禁止事项(明确"不要做什么")决定输出的形状与质量
期望输出输出形式:正文 / JSON / Markdown / 表格 / 分点决定输出格式段
反例经验之前哪里不好用、踩过什么坑写进约束,避免重蹈覆辙

任务类型速查

类型追问重点成品强调
编程技术栈、现有代码位置、报错信息、验收标准精确任务、约束、验收/测试标准
文案创作受众、目的、风格语气、篇幅角色、语气、结构要求、示例
分析输入材料、分析维度、结论用途步骤化、输出格式
翻译/润色原文、目标语言、风格保真度角色与保真约束
图像生成画面主体、风格参考、比例、负面提示详细主体描述、风格词、构图与负面清单
结构化提取输入格式、要提取的字段、输出 schema字段清单、输出格式(JSON 等)

成品结构模板(按需裁剪)

# 角色
(你是谁,以什么身份完成这个任务)

# 背景
(对方需要知道的上下文,让提示词自足)

# 任务
(要做什么,一句话说清 + 分点细化)

# 约束
(硬性限制:长度、风格、语言、禁止事项)

# 输出格式
(成品长什么样:正文 / JSON / Markdown / 表格…)

# 示例(可选)
(期望的样子,few-shot 样例)

# 验收标准
(怎样算做好,可自查的检查点)

裁剪判定:模板里的 (…) 括注是"这一段的写作提示",永远不要原样留在成品里。

  • 小任务(单步、可一句话验收,如"翻译这段话"):只用 角色 + 任务 + 约束 三段。
  • 中型任务(如"写个营销文案"):角色 + 背景 + 任务 + 约束 + 输出格式。
  • 复杂任务(多步骤、多验收点,如"做个记账工具"):用全模板,可加示例段。

兜底默认值的落点:细节类默认值写进约束段即可;若缺的是任务形态本身(如 A/B 二选一),在任务段直接写明所选形态并注明"默认按此执行,可调整",不限于约束段。

常见错误(避免)

  • 没问就写、全靠猜 → 违反追问门。
  • 一次抛十个问题轰炸用户。
  • 第一轮问的必问项还缺着就产出、靠"对方会理解"赌运气。(例外:已按"追问至多两轮"规则兜底产出的不算违规。)
  • 兜底时把"形态二选一"这类决定成品形状的缺项随便选一个却不声明——必须注明"默认按此执行,可调整"。
  • 成品只有"任务"没有约束/输出格式 → 对方会自由发挥。
  • 成品塞满 [占位符] 或模板括注 → 用户要的是成品;确需用户提供的信息应在追问阶段问清或写"由你决定"默认值。
  • 解释比提示词还长 → 说明 2–4 句即可。

语言

追问与说明默认用中文。提示词正文的语言跟随用户要求或目标 AI 的语境(通常中文即可,除非用户要英文提示词)。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.