Pitch Your Proj

为当前项目生成一份产品介绍 pitch,像给别人安利一个好工具一样。直接输出可复制文本,支持长短两种篇幅。

ChenxDeng Updated

File contents

Pitch Your Project

为当前项目生成一份简洁有力的产品 pitch,目标是让一个完全没听说过的人快速理解:这是什么、为什么值得关心、怎么用。

流程

第一步:问篇幅

用弹窗(AskUserQuestion)让用户选择:

  • 短:三段式,适合推文/快速分享
  • 长:完整叙事,适合 README/详细介绍

第二步:分析项目

按优先级获取项目信息:

  1. 读 README.md — 最重要的信息源
  2. 读代码结构 — 看目录、入口文件、关键模块
  3. 读 git log — 了解项目演进和核心功能
  4. 读 package.json / 其他配置 — 了解技术栈
  5. 读用户指定的文件夹 — 如果用户给了路径,读取该路径下的关键文件

提取以下信息:

  • 项目名称
  • 一句话描述
  • 解决什么问题(痛点)
  • 核心功能(2-3 个最让人想试的)
  • 技术栈
  • 部署地址 / 使用入口
  • 有没有数据/证据支撑

如果信息不足,再问用户补充。

第三步:生成 Pitch

内容结构

短版本(三段式):

{自然口语化标题,如"我做了一个XXX的工具"}

{一句话钩子}

{痛点背景,2-3句话}

{功能1} — {一句话描述}
{功能2} — {一句话描述}
{功能3} — {一句话描述}

{链接}

长版本(完整叙事):

{自然口语化标题}

{一句话钩子}

{痛点背景,展开叙述,有情绪张力}

{工具怎么工作的,用户视角描述}

{结果/效果展示,分档/分层}

{背后的逻辑/原理,简要说明}

{数据支撑(如果有)}

{链接}
钩子写法要求
  • 不是"我做了个XXX",而是让人产生好奇的陈述句
  • 好的:"你的大学到底值不值得上?我们用一根拔河条量化了它。"
  • 坏的:"这是一个大学就业ROI评估工具。"
痛点写法要求
  • 要能让目标用户产生共鸣
  • 用具体场景而不是抽象描述
  • 好的:"学校用考勤制度把你钉在教室里,辅导员用审批流程拦住你去实习"
  • 坏的:"当前教育体系存在就业导向不足的问题"

第四步:输出

用代码块(```)包裹完整 pitch 文本输出,确保用户可直接复制。输出要求:

  • 标题:自然口语化,如"我做了一个XXX的工具",不要"项目名 · 功能描述"这种格式
  • 纯文本:不含任何 Markdown 格式符号(不用 #、>、-、** 等),直接可粘贴到任何平台
  • 代码块包裹:确保内容可复制

ChenxDeng/pitch-your-proj/tree/main/ commit 0464c545d0

Frequently asked questions

npx skillmds@latest add chenxdeng/pitch-your-proj