SuperAPI AI 工具集

prompt-export

编程与开发

查看项目

更新于 10-15 08:16

技能介绍

用途

prompt-export 用于把设计阶段的产物(问题定义、PRD、UX 规格等)转换为一份按顺序排列的 prompts.md 文件,供 Claude Code 等编码智能体逐步执行开发。它的核心目的是把开发过程拆解为带检查点的分步提示,避免智能体在长任务中失去焦点或自行做出未经确认的假设。

输入要求

该技能期望用户提供以下一种或多种上游上下文:

  • 问题定义文档(Problem framing document)
  • PRD
  • UX 规格(流程、界面、交互)
  • 以上任意组合

如果用户尚未完成上游工作,技能会建议先进行问题定义(problem-framing)或 PRD 生成(prd-generation)。

工作流程

第 1 步:收集产物

要求用户提供设计产物,接受任意格式——markdown、文档、草图图片、要点列表。

第 2 步:提取关键元素

从提供的产物中识别以下内容及其来源:

  • 项目概述:来自问题陈述、目标用户
  • 核心功能:来自 PRD、方案范围
  • 用户流程:来自 UX 规格
  • 界面/组件描述:来自 UX 规格
  • 交互与状态:来自 UX 规格
  • 技术偏好:来自用户输入或根据上下文推断
  • 约束:来自 MVP 范围、不包含的内容
  • 成功标准:来自问题定义、PRD

第 3 步:澄清缺口

如果缺少关键信息,提出针对性问题,例如:

  • “你想要什么技术栈?(React、vanilla JS 等)”
  • “有没有要使用或避免的特定库或框架?”
  • “移动优先、桌面优先还是响应式?”
  • “有没有认证或数据持久化需求?”

问题保持精简——尽可能推断。

第 4 步:分解为提示

把项目拆解为逻辑顺序。典型的提示序列包括:

  1. 项目搭建——脚手架、依赖、配置
  2. 数据/状态基础——类型、模式、状态结构
  3. 核心组件——每个主要组件或界面一个提示
  4. 功能实现——每个功能一个提示
  5. 集成——连接组件、打通流程
  6. 打磨——错误状态、加载状态、边界情况
  7. 最终审查——清理、优化、文档

根据项目复杂度调整。简单项目可能 3-4 个提示,复杂项目可能 10 个以上。

第 5 步:生成 prompts.md

输出单个文件,用户可在使用 Claude Code 时参考。

输出格式

使用 Write 工具自动将输出保存到项目根目录的 prompts.md,同时向用户展示。格式如下:

# [Project Name] — Development Prompts

## Context
[2-3 sentences: what this is, who it's for, core problem it solves]

**Tech stack:** [framework, styling, key libraries]
**Key constraints:** [what's in/out of scope]

---

## Prompt 1: Project Setup
> [Prompt text the user pastes into Claude Code]

**Goal:** [What this accomplishes]
**Checkpoint:** [How to verify it worked before moving on]

---

## Prompt 2: [Name]
> [Prompt text]

**Goal:** [What this accomplishes]
**Checkpoint:** [How to verify]

---

## Prompt 3: [Name]
> [Prompt text]

**Goal:** [What this accomplishes]
**Checkpoint:** [How to verify]

---

[Continue for all prompts...]

---

## Final Checklist
- [ ] [Success criterion 1]
- [ ] [Success criterion 2]
- [ ] [Success criterion 3]

提示编写准则

每个提示应当:

  • 自包含——智能体不需要阅读之前的提示
  • 引用已有文件——例如“在 src/components/Header.jsx 中,添加……”
  • 明确验收标准——“完成”是什么样子
  • 保持聚焦——一个逻辑工作单元

好的提示示例:

“Create a TaskList component in src/components/TaskList.jsx that displays an array of tasks. Each task shows a title, due date, and completion checkbox. Clicking the checkbox toggles completion state. Use Tailwind for styling. The component receives tasks as a prop.”

差的提示示例:

“Build the task management features.”

适配准则

  • 简单项目(3-5 个提示):搭建 → 核心 UI → 功能 → 打磨
  • 中等项目(5-8 个提示):搭建 → 数据层 → 界面 1 → 界面 2 → 功能 A → 功能 B → 集成 → 打磨
  • 复杂项目(10+ 个提示):考虑按阶段分组并附阶段摘要;添加依赖说明(“在 Prompt 3 之后运行”);为高风险步骤加入回滚提示

交接

展示提示后,告知用户:

“Work through these prompts sequentially with Claude Code—each builds on the last. Check the checkpoint before moving to the next prompt.”

并提供以下选项:

  • 调整提示粒度(更多/更少步骤)
  • 重新排序
  • 为特定提示添加细节

注意:文件会自动保存到项目根目录的 prompts.md。

适用场景

适用于已经完成问题定义、PRD 或 UX 规格等上游设计思考,需要将其转化为编码智能体可执行的分步开发提示的场景。

限制

资料未提供关于收费、价格、平台支持范围、具体效果保证等信息。若用户未完成上游设计工作,该技能不会直接生成提示,而是建议先完成问题定义或 PRD 生成。