alexandreleciel/startup-pitch

创业公司路演

将创始人的文件夹转化为他们能够捍卫的投资人路演材料。每次运行都以 快速运行 开始：一页 pitch/START-HERE.md，并附带一个简短的有来源账本。叙述、完整的投资人问答和演示文稿是创始人请求后添加的附加内容。

规则

1. 先读取，后询问。 先进行资料收集并读取文件。仅询问缺失的、在当前阶段重要的、且无法从文件夹中推导出的信息。
2. 每个数字都有来源。 任何输出中出现的数字，都必须在 pitch/facts.yaml 中有一条记录，包含类型（事实、假设、预测）和来源。如果文件夹中没有数字，则写入 [需要数字] 并询问。编造用户吸引力、收入、市场规模、增长、留存、客户、招聘或估值，是本技能旨在防止的失败行为。
3. 揭示矛盾，绝不平均。 将两个值都记录为 冲突，采用保守值，说明原因，并询问创始人。
4. 机密材料不得出现在面向投资人的文本中。 标记为机密的文件不被读取。估值、条款、股东名册名称、潜在投资人姓名、薪资和合同条款，无论出现在何处，都不得出现在叙述和演示文稿中。
5. 保持创始人的原声。 使用他们特定的措辞和客户引述。去除流行词；不要添加。
6. 精简账本。 仅记录输出中引用的数字，以及每个冲突的两面。不记录中间条目，不记录无人引用的历史。

命令

一个入口点；$SKILL 是本技能的目录（使用其绝对路径）。从创业公司文件夹运行。

python3 $SKILL/scripts/pitch.py intake        # 清单 + 提取 -> pitch/intake/
python3 $SKILL/scripts/pitch.py check         # 验证 pitch/facts.yaml（以及演示文稿如果存在）
python3 $SKILL/scripts/pitch.py deck          # 构建 html + pptx，打印 pdf，QA 截图，追踪数字
python3 $SKILL/scripts/pitch.py comparables --sector saas --round seed   # 研究三个真实的演示文稿
python3 $SKILL/scripts/pitch.py status        # 查看存在什么，什么是开放的
python3 $SKILL/scripts/pitch.py open          # 为创始人打开 pitch/ 目录

pitch.py setup 在技能文件夹内安装演示文稿依赖（首次运行 deck 会自动执行）；pitch.py doctor 显示已安装的内容。

快速运行（始终优先；目标五分钟内完成）

阅读 references/core.md 和 references/file-formats.md。不要打开其他参考资料。

1. 执行 pitch.py intake。阅读 pitch/intake/corpus/INDEX.md，然后按顺序阅读其列出的文件：先是创始人的备忘录和笔记，然后是数据，最后是其余部分。对于任何陈旧的一对文件，优先选择最新的。不要打开标记为机密的文件。索引标记为包含交易条款或薪酬的文件可以被读取；但这些条款不得出现在面向投资人的文本中。
2. 编写 pitch/facts.yaml：15 到 30 条记录，仅限起始页将引用的内容。从 scripts/facts_template.yaml 开始。运行 pitch.py check；修复每个 FAIL。WARN 是给创始人的问题，不是可以掩盖的问题。pitch.py check --explain 会打印检查器如何匹配 id、单位和演示文稿中的数字，因此无需阅读其源代码。
3. 使用 references/file-formats.md 中的模板编写 pitch/START-HERE.md：创始人必须回答的问题（最多五个，矛盾优先，每个都附有在得到回答前使用的值）、两句话路演和 60 秒版本、三到五个重要的数字以及暂时不能使用的声明、创始人准备最不充分的五个投资人问题及诚实回答、前三个危险信号及修复措施，以及从投资人资料中排除的内容。大约 1200 字。如果有超过五个未解决的项目，将其余部分放入 pitch/gaps.md 并链接它。
4. 在聊天中告知创始人：相同的问题、你的假设，以及他们可以请求的下一步（叙述、完整 Q&A、演示文稿、会议准备）。运行 pitch.py open。

如果目标投资人不明确，将此作为五个问题之一；说明来自 core.md 的默认值并继续。

附加内容（执行创始人要求的那些；快速运行仍然优先）

创始人想要	阅读	执行
叙述	references/narrative.md	编写 pitch/narrative.md：目的句、叙述选择、长文版、两句话版、60 秒版和 3 分钟版。内联引用 id。其他变体仅在要求时提供。
投资人 Q&A	references/investor-questions.md；question-bank.md 作为按主题查询的参考	编写 pitch/investor-qa.md：准备最不充分的五个问题、10 题练习、最多 15 个主题问题并附有引用 id 的诚实回答，以及 core.md 格式的危险信号记录。
完整的危险信号审计或发送前检查	references/red-flags.md	将审计添加到 investor-qa.md（或演示文稿审查）中，包含每个信号的触发条件、修复措施和状态。
演示文稿	references/deck-structure.md（容量表），references/design.md	执行 pitch.py comparables 并快速浏览三个演示文稿的结构。在容量表内编写 pitch/deck/deck.json，为本公司选择一个主题、品牌颜色和徽标（如果文件夹中有）。执行 pitch.py deck。通过缩减文字修复每一行 lint 和 QA 问题，重新运行直到总结干净，然后亲自查看 pitch/deck/qa/。
为特定投资人或公司做准备	references/investor-types.md，investor-types-detail.md 中的单个区块，references/meetings.md	调整 Q&A 和请求。仅使用公司公开页面上的信息，并注明来源。
阶段基准、模型特定指标	references/benchmarks.md，metrics-by-model.md 中的单个区块	引用时需注明来源和年份，否则不引用。
“审查我的演示文稿”（文件夹中的 pdf、pptx、html）	references/red-flags.md	资料收集会提取它。根据演示文稿加文件夹构建账本，将起始页编写为审查报告，提供重建服务。
“更新数字”	无	重新运行资料收集和检查，更新账本，重建输出，列出每个变化的值的旧值和新值。
3 分钟演示日路演	references/narrative.md，references/deck-structure.md	演示日变体以及 6 到 8 张幻灯片的结构。

每个附加内容仅扩展账本中新引用的数字。将每个新文件添加到 START-HERE.md 底部的“文件”列表中。

当创始人回答时

首先更新账本，然后更新页面。

• 一个决定（轮次规模、目标投资人、两个数字中哪个是当前的）变为 status: confirmed；冲突的另一方移入其 note 中。
• 一个没有文件支持的声明（退款数量、创始人的背景）记录为 source: founder statement, <date> 且 status: unverified，在输出中如实说明，并将要支持它的记录列入待办事项清单。
• 创始人留待解决的问题（“我需要重做预算”）在其相关条目上获得 open_question:，以便检查报告发出 WARN，而不是 FAIL。不要添加条目来使身份平衡。
• 一个与文件矛盾的答案被采纳，并且在 START-HERE.md 的第 1 节中命名该文件为需要更新。
• 如果他们指定了投资人类型或地区，打开 references/investor-types.md。

运行 pitch.py check，更新 START-HERE.md 以及每个引用已更改 id 的输出，并将每个更改的值报告为旧值到新值。移除已回答的问题；推广下一个未解决的项目。如果他们在仍有未解决项目时要求演示文稿，先构建它，然后在回复中列出剩余的 [需要数字] 位。

当无人能回答时（非交互式运行）

对于每个冲突使用保守值，对于每个缺口使用 [需要数字]。START-HERE.md 的第 1 节列出了每个未解决的项目，因此没有任何隐藏；演示文稿可以保留可见的 [需要数字] 位。

移交前检查

• pitch.py check 没有 FAIL；如果有演示文稿，pitch.py deck 的摘要显示已检查的 PPTX、匹配的 PDF 页数、0 个 QA 问题。
• 每个输出中的每个数字都引用了一个账本 id；面向投资人的文本中没有机密内容。
• 仅凭幻灯片标题就能讲述路演故事（从上到下阅读）。
• 小样本需注明 n 值和背景；超过 18 个月的数据需标注日期。
• 在 pitch/run-log.md 中追加一条带日期的记录：读取的文件、提出的问题、答案、输出。

参考映射

文件	何时打开
references/core.md	每次运行
references/file-formats.md	每次运行（账本、START-HERE 模板、deck.json、文件夹布局）
references/narrative.md	编写 narrative.md 或任何口头变体时
references/investor-questions.md，question-bank.md，meetings.md	Q&A、按主题查询、会议流程表和跟进
references/red-flags.md	演示文稿审查、完整审计、发送前检查
references/investor-types.md，investor-types-detail.md	指定了目标投资人类型或地区时
references/metrics.md，metrics-by-model.md，benchmarks.md	指标定义、一个商业模式指标、阶段基准
references/deck-structure.md，references/design.md	构建或审查演示文稿时
references/deck-library.md	当可比演示文稿在那里有结构笔记时（comparables 命令会说明）

常见错误

• 先编写路演内容，再补充来源。账本优先，这样故事才能建立在真实的基础上。
• 信任创始人备忘录胜过指标导出。备忘录会向上取整：同时记录两者并提出疑问。
• 将一个客户三个月的结果呈现为公司指标。需说明 n 值和背景。
• 因为文件夹中没有相关内容，就用一份报告来填充市场幻灯片。应使用 [需要数字] 并向创始人提供自下而上的方法。
• 在开始前阅读所有参考资料。快速运行只需要两个文件。
• 为了通过检查器而填充账本。对于你求和或计数的值使用 computed: true，并且仅引用你使用的内容。
• 通过缩小字号来容纳超长的幻灯片。应缩减文字或拆分幻灯片。
• 掩盖一个薄弱的答案。投资人会发现它；一个诚实的答案加上一个计划会显得成熟。