agentsclimarketplace

Prompt enhancer

Skill konglong87/methodology-skills/skills/prompt-enhancer

[方法论]智能体skills；一键生成公众号文章和贴图、一键小红书信息图 && 技术选型、产品策略、战略分析、MVP、DDD、一次目标追踪器、使命必达skills

Install
npx -y skills add konglong87/methodology-skills --skill prompt-enhancer

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 7 stars7 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

MUST use before task execution. Clarify vague requirements, explore solutions, and ensure full understanding.

SKILL.md

14.4 KB, as published. Nobody here has run it

Prompt Enhancer - 需求细化与方案探索

前置协议

强制触发规则

触发时机：goal-oriented 创建目标后（强制）

触发条件（满足任一即触发）：

  • ✅ 用户需求模糊（单句请求、缺少上下文）
  • ✅ 用户需求不完整（缺少关键维度）
  • ✅ 用户需求有歧义（多种理解可能）
  • ✅ 用户需求缺少成功标准
  • ✅ 复杂任务（涉及多个模块/系统）

例外情况：

  • 用户明确表示"按你的理解执行"
  • 需求已经非常清晰明确
  • 用户在调整已有目标

Overview

prompt-enhancer 是强制前置技能，负责需求细化和方案探索。通过结构化提问，确保充分理解用户需求，探索多种可行方案，避免理解偏差和执行返工。

核心能力：

  1. 需求细化：澄清模糊点、发现隐藏需求、明确范围边界
  2. 方案探索：头脑风暴多种方案、分析优劣势、风险评估
  3. 确认机制：每个关键点问用户3-4个问题确认理解

核心原则：澄清优先，行动在后。猜测定浪费，提问才高效。

关键价值：

  • 避免理解偏差，减少返工
  • 充分论证方案，选择最优解
  • 发现隐藏需求，避免遗漏
  • 节省 token 和时间

When to Use

强制使用场景：

  • 用户需求模糊或不完整
  • 复杂任务（涉及多个模块/系统）
  • 需求有歧义或多种理解可能
  • 缺少成功标准或约束条件

不使用场景：

  • 用户明确表示"按你的理解执行"
  • 需求已经非常清晰明确
  • 用户在调整已有明确目标
  • 简单的澄清性问题本身

The Process

digraph prompt_enhancer {
    rankdir=TB;

    "接收用户需求" [shape=box, style=filled, fillcolor="#c8e6c9"];
    "识别需求类型" [shape=box, style=filled, fillcolor="#bbdefb"];
    "需求细化（3-4问题）" [shape=box, style=filled, fillcolor="#fff9c4"];
    "用户确认需求" [shape=diamond, style=filled, fillcolor="#e1bee7"];
    "方案探索（头脑风暴）" [shape=box, style=filled, fillcolor="#ff9800"];
    "多方案对比分析" [shape=box, style=filled, fillcolor="#ff9800"];
    "用户选择方案" [shape=diamond, style=filled, fillcolor="#e1bee7"];
    "生成需求方案工件" [shape=box, style=filled, fillcolor="#81c784"];
    "传递给后续技能" [shape=doublecircle, style=filled, fillcolor="#81c784"];

    "接收用户需求" -> "识别需求类型";
    "识别需求类型" -> "需求细化（3-4问题）";
    "需求细化（3-4问题）" -> "用户确认需求";
    "用户确认需求" -> "方案探索（头脑风暴）" [label="确认"];
    "用户确认需求" -> "需求细化（3-4问题）" [label="调整"];
    "方案探索（头脑风暴）" -> "多方案对比分析";
    "多方案对比分析" -> "用户选择方案";
    "用户选择方案" -> "生成需求方案工件" [label="选择"];
    "用户选择方案" -> "方案探索（头脑风暴）" [label="重新探索"];
    "生成需求方案工件" -> "传递给后续技能";
}

步骤1：识别需求类型

快速识别请求类型，应用对应的细化框架：

需求类型关键词必问维度
功能开发"做个功能"、"实现XX"平台、技术栈、用户、数据、认证
架构设计"设计系统"、"重构架构"规模、性能、可扩展性、技术选型
性能优化"优化性能"、"提升速度"目标指标、优化范围、优先级
Bug修复"修复bug"、"解决错误"复现步骤、影响范围、优先级
UI/界面"设计界面"、"做个页面"设备、风格、用户、交互
数据分析"分析数据"、"生成报告"数据源、分析维度、输出格式

步骤2：需求细化（3-4问题确认）

核心原则：每个关键点问3-4个问题，确保充分理解

示例：功能开发需求细化

用户需求："做一个用户认证功能"

问题组1：用户与场景

Q1: 谁会使用这个认证功能？（用户类型）
Q2: 在什么场景下使用？（使用场景）
Q3: 期望的用户体验是什么？（体验目标）
Q4: 有多少用户量级？（规模预估）

问题组2：技术约束

Q1: 需要支持哪些认证方式？（密码、OAuth、SSO？）
Q2: 部署在什么平台？（Web、移动端、小程序？）
Q3: 使用什么技术栈？（前端、后端框架？）
Q4: 有现成的用户系统吗？（是否需要集成）

问题组3：功能范围

Q1: 需要哪些核心功能？（注册、登录、找回密码？）
Q2: 是否需要权限管理？（角色、权限控制？）
Q3: 是否需要记住登录状态？（Token、Session？）
Q4: 是否需要多设备登录？（单点登录？）

问题组4：成功标准

Q1: 如何判断功能完成？（验收标准）
Q2: 有性能要求吗？（响应时间、并发量？）
Q3: 有安全要求吗？（加密、防护？）
Q4: 什么时候需要完成？（时间约束）

步骤3：用户确认需求

展示细化的需求摘要，用户确认或调整：

## 📋 需求确认

### 核心需求
- 功能：用户认证系统
- 用户：普通用户（移动端）
- 认证方式：手机号+验证码、微信OAuth
- 核心功能：注册、登录、找回密码、记住登录

### 技术约束
- 平台：微信小程序
- 技术栈：小程序原生 + Node.js + MySQL
- 集成：需要对接现有用户系统

### 成功标准
- 功能完整：注册、登录、找回密码流程完整
- 性能：登录响应 < 2秒
- 安全：密码加密、Token 7天有效
- 时间：2周内完成

### 范围边界
- ✅ 包含：注册、登录、找回密码
- ✅ 包含：微信OAuth
- ❌ 不包含：权限管理、多角色
- ❌ 不包含：单点登录

---

**是否确认这个需求？**
- A) 确认，继续方案探索
- B) 需要调整（请说明）

步骤4：方案探索（头脑风暴）

核心原则：探索3-5种方案，充分论证

方案探索模板

## 🎨 方案探索

### 方案1：自定义认证系统
**实现方式**：
- 后端：Node.js + JWT
- 数据库：MySQL存储用户信息
- 认证：手机验证码（阿里云短信服务）

**优势**：
- ✅ 完全可控，灵活定制
- ✅ 无第三方依赖

**劣势**：
- ❌ 开发周期长（2周）
- ❌ 需要购买短信服务
- ❌ 需要自己维护安全性

**风险**：
- ⚠️ 短信服务可能被滥用
- ⚠️ 需要处理验证码过期、重发等问题

---

### 方案2：使用云开发（推荐）
**实现方式**：
- 微信云开发
- 云函数处理认证逻辑
- 云数据库存储用户信息

**优势**：
- ✅ 快速开发（1周）
- ✅ 微信原生集成
- ✅ 无需服务器维护

**劣势**：
- ❌ 依赖微信生态
- ❌ 扩展性受限

**风险**：
- ⚠️ 云开发限制（并发、存储）

---

### 方案3：第三方认证服务
**实现方式**：
- Authing、Firebase Auth
- SDK集成

**优势**：
- ✅ 最快上线（3天）
- ✅ 功能完整
- ✅ 安全性高

**劣势**：
- ❌ 有成本（按用户数收费）
- ❌ 数据不在自己手中

**风险**：
- ⚠️ 服务稳定性依赖第三方

---

### 方案对比

| 维度 | 方案1 自定义 | 方案2 云开发 | 方案3 第三方 |
|------|-------------|-------------|-------------|
| 开发周期 | 2周 | 1周 | 3天 |
| 灵活性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| 成本 | 低 | 中 | 中-高 |
| 维护成本 | 高 | 低 | 低 |
| 安全性 | 需自己保证 | 中 | 高 |

---

### 推荐方案

**推荐方案2：云开发**

理由：
1. 时间紧迫（2周），云开发最快
2. 小程序原生支持，集成方便
3. 无需服务器维护，降低运维成本
4. 微信生态，用户体验最佳

步骤5：用户选择方案

用户确认方案，或重新探索：

## ✅ 方案确认

**选定方案**：微信云开发

**实施步骤预览**：
1. 配置云开发环境
2. 实现手机验证码登录
3. 实现微信OAuth
4. 实现找回密码
5. 测试与优化

**是否确认此方案？**
- A) 确认，继续实施规划
- B) 选择其他方案
- C) 重新探索方案

步骤6：生成需求方案工件

创建工件文件，传递给后续技能：

{
  "skill": "prompt-enhancer",
  "version": "2.0.0",
  "timestamp": "2026-03-25T10:00:00Z",
  "requirement": {
    "original": "做一个用户认证功能",
    "refined": {
      "type": "功能开发",
      "core_features": ["注册", "登录", "找回密码"],
      "target_users": "普通用户（移动端）",
      "auth_methods": ["手机号+验证码", "微信OAuth"],
      "platform": "微信小程序",
      "tech_stack": ["小程序原生", "Node.js", "MySQL"],
      "success_criteria": [
        "功能完整：注册、登录、找回密码流程完整",
        "性能：登录响应 < 2秒",
        "安全：密码加密、Token 7天有效"
      ],
      "timeline": "2周"
    }
  },
  "solution": {
    "selected": "方案2：微信云开发",
    "reasons": [
      "时间紧迫（2周），云开发最快",
      "小程序原生支持，集成方便",
      "无需服务器维护，降低运维成本"
    ],
    "alternatives": [
      {
        "name": "方案1：自定义认证系统",
        "pros": ["完全可控", "无第三方依赖"],
        "cons": ["开发周期长", "需要自己维护安全性"]
      },
      {
        "name": "方案3：第三方认证服务",
        "pros": ["最快上线", "功能完整"],
        "cons": ["有成本", "数据不在自己手中"]
      }
    ]
  },
  "next_skills": [
    "planning"
  ]
}

需求细化问题模板库

功能开发类

用户场景（3-4问题）：

  • 谁会使用？用户类型、量级
  • 在什么场景使用？使用频率
  • 期望的体验？用户旅程
  • 有什么痛点？解决问题

技术约束（3-4问题）：

  • 部署平台？Web/移动端/小程序
  • 技术栈？前后端框架
  • 数据存储？数据库类型
  • 第三方集成？现有系统

功能范围（3-4问题）：

  • 核心功能？必须有哪些
  • 扩展功能？可以有哪些
  • 不包含？明确边界
  • 优先级？MVP vs 完整版

成功标准（3-4问题）：

  • 验收标准？如何判断完成
  • 性能要求？响应时间、并发量
  • 安全要求？加密、权限
  • 时间约束？什么时候完成

架构设计类

系统规模（3-4问题）：

  • 用户量级？当前、未来
  • 数据量级？存储、增长速度
  • 并发要求？峰值、平均
  • 可扩展性？未来规划

技术选型（3-4问题）：

  • 架构风格？微服务/单体/Serverless
  • 技术偏好？团队熟悉的技术
  • 第三方依赖？是否需要引入
  • 技术债务？现有系统限制

非功能需求（3-4问题）：

  • 性能指标？响应时间、吞吐量
  • 可用性？SLA要求
  • 安全性？合规要求
  • 可维护性？文档、监控

性能优化类

优化目标（3-4问题）：

  • 具体指标？加载时间、响应速度
  • 目标值？从多少提升到多少
  • 优先级？哪些最重要
  • 用户体验？核心场景

优化范围（3-4问题）：

  • 哪些模块？前端/后端/数据库
  • 瓶颈在哪？已知问题
  • 监控数据？现状分析
  • 约束条件？不能改动的部分

权衡取舍（3-4问题）：

  • 成本预算？资源限制
  • 时间限制？多久完成
  • 风险容忍？稳定性要求
  • 可逆性？是否可以回退

Examples

案例1：模糊需求细化

用户需求："优化性能"

细化过程：

问题组1：优化目标

Q1: 哪方面需要优化？
A: 首页加载速度太慢

Q2: 当前状态如何？
A: 现在加载要5秒，太慢了

Q3: 期望达到什么效果？
A: 希望能到2秒以内

Q4: 用户量多大？
A: 日活1万左右

问题组2：优化范围

Q1: 首页包含哪些内容？
A: 轮播图、推荐列表、广告位

Q2: 哪些部分最慢？
A: 轮播图加载特别慢

Q3: 图片多大？
A: 每张2-3MB

Q4: 有CDN吗？
A: 没有，都从服务器加载

细化结果：

需求：优化首页加载速度
当前：5秒
目标：< 2秒
瓶颈：轮播图过大（2-3MB/张）
方案：图片压缩 + CDN加速

案例2：方案探索对比

用户需求："实现搜索功能"

方案探索：

方案1：数据库 LIKE 查询

  • 优势：简单快速
  • 劣势：性能差、不支持复杂搜索
  • 适用：小数据量（< 1万条）

方案2：Elasticsearch

  • 优势：强大、快速、支持复杂搜索
  • 劣势：需要部署、学习成本
  • 适用：大数据量（> 10万条）

方案3：Algolia

  • 优势：托管服务、快速集成
  • 劣势：有成本、数据需上传
  • 适用：快速上线、中小数据量

推荐：根据数据量选择

  • < 1万条：方案1
  • 1-10万条：方案3

  • 10万条：方案2

Common Pitfalls

误区1：跳过需求细化直接执行

表现：用户说"做个登录"，直接实现 正确做法：先问3-4个问题确认需求

误区2：只问一个问题就行动

表现：问"什么平台？"就结束 正确做法：每个关键点问3-4个问题

误区3：假设用户需求

表现："我觉得用户想要..." 正确做法：向用户确认，不要假设

误区4：只探索一个方案

表现：想到一个方案就用 正确做法：至少探索3个方案对比

误区5：不生成工件直接传递

表现：细化后不记录 正确做法：生成工件文件，传递给后续技能

References

  • 《需求工程》- Karl Wiegers
  • 《用户故事地图》- Jeff Patton
  • 《设计思维》- IDEO
  • "5 Whys" - Root Cause Analysis
  • "Six Thinking Hats" - Edward de Bono

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.