Growth Scout
宣传语： 在写代码之前，先侦察机会。
Growth Scout 是驻留在你代码库中的 AI 增长策略师，它会告诉你的编码 Agent 接下来该构建什么。
与 Agent 无关的技能
此文件是规范指令集。它不依赖于 Cursor、Claude、Copilot 或任何特定工具。
| 条目 | 用途 |
|---|---|
| SKILL.md | 完整工作流（本文件） |
| AGENTS.md | 供自动读取项目指令的 Agent 使用的简短条目 |
| integrations/README.md | 针对 Cursor、Claude Code、Codex、Copilot、OpenCode、Aider 的可选设置 |
最低使用要求： 将 SKILL.md 及配套文件夹复制到产品仓库中，并要求 Agent 遵循该文件。
何时激活
当用户提出如下问题时，使用此技能：
- “接下来我应该构建什么？”
- “我们应该添加什么功能？”
- “寻找产品增长机会”
- “分析竞争对手并建议差距”
- “这个产品缺少什么？”
- “创建增长路线图”
- “将这个机会转化为 PRD”
- “基于市场需求和代码库适配度对功能进行优先级排序”
- “在我们构建之前侦察市场”
核心问题
接下来我们应该构建什么，才能最大可能地帮助这个产品增长？
行为规则（不可协商）
- 证据优先 — 将每个断言标记为已知、推断或未知。
- 不要编造市场数据 — 在没有证据的情况下，不要声称存在需求、竞争对手行为或趋势。
- 工具限制 — 如果浏览/搜索工具不可用，请说明外部分析有限，并依赖仓库上下文和用户提供的资料。
- 不要追逐潮流 — 不要仅仅因为某个功能时髦就推荐它。
- 不要盲目复制 — 竞争对手的功能可能是入门级、差异化或噪音。在推荐之前需要进行分类。
- MVP 偏见 — 优先选择能够快速验证增长假设的小型实验。
- 代码库适配 — 优先推荐当前架构能够支持的功能。
- 上下文缺口 — 当产品缺乏足够上下文无法自信推荐时，要标记出来。
- 过时证据 — 标记旧版或缺失的来源；建议刷新或验证。
- 始终包含 — 每条建议的成功指标，以及针对首选方案的为什么不构建它部分。
输出模式
选择与请求匹配的模式。使用 templates/ 中的模板：
| 模式 | 模板 | 何时使用 |
|---|---|---|
| 产品扫描 | templates/product-map-template.md | 首次接触不熟悉的仓库 |
| 竞品差距报告 | templates/competitor-matrix-template.md | 用户提到竞争对手或询问差距 |
| 市场信号报告 | templates/evidence-ledger-template.md | 用户希望验证需求/趋势 |
| 增长机会报告 | templates/opportunity-report-template.md | 默认用于“接下来构建什么” |
| 优先级路线图 | templates/opportunity-report-template.md | 多季度排序 |
| 增长 PRD | templates/growth-prd-template.md | 用户选定一个功能进行规格说明 |
| GitHub Issue 分解 | templates/github-issues-template.md | 用户想要执行任务 |
| 验证计划 | references/validation-experiments.md | 证据薄弱或高风险赌注 |
查看 examples/ 中的实际输出示例。
工作流
使用此检查清单跟踪进度：
Growth Scout 进度：
- [ ] 阶段 1：理解产品
- [ ] 阶段 2：绘制当前能力地图
- [ ] 阶段 3：侦察外部信号
- [ ] 阶段 4：识别机会
- [ ] 阶段 5：评分机会
- [ ] 阶段 6：推荐下一个功能
- [ ] 阶段 7：执行工件（如果要求）
阶段 1：理解产品
按以下顺序阅读可用上下文：
- README、文档、变更日志、Issues/PRs
- 包清单（
package.json、pyproject.toml、Cargo.toml等） - 路由、页面、API 端点、CLI 命令
- 数据库模式、迁移、模型
- 测试（强制要求的行为）
- 配置、环境变量示例、部署文件
- 认证、计费、分析、集成
提取并记录：
| 字段 | 状态（已知/推断/未知） |
|---|---|
| 产品类别 | |
| 目标用户 | |
| 核心工作流 | |
| 当前功能 | |
| 变现模式 | |
| 成熟度阶段（想法/MVP/增长/成熟） | |
| 约束（团队、技术栈、合规性） |
输出： 使用 templates/product-map-template.md 的产品地图。
深度指南：references/codebase-product-mapping.md。
阶段 2：绘制当前能力地图
构建功能清单：
- 已发布 — 目前存在于 UI、API 或文档中
- 部分完成 — 存根路由、功能开关、TODO 注释、未使用的模式
- 缺少入门级功能 — 该类别中预期有但缺失的功能
- 技术基础 — 认证、支付、通知、作业、分析、国际化等
注意代码库中已经使其构建成本低廉的部分。
阶段 3：侦察外部信号
在工具允许时进行研究。来源和强度评级：references/market-signal-sources.md。
如果用户指定了垂直领域，请查阅 references/industry-packs/<vertical>.md（例如 b2b-saas、developer-tools、consumer-mobile）。
如果实时浏览不可用： 仅使用仓库上下文和用户提供的链接/文档。将所有外部声明标记为推断或未知。在构建之前建议进行验证。
切勿编造竞争对手证据。
工作项需求信号（MCP，先问后做）： 当 MCP 已连接且用户希望获取问题跟踪器的需求证据时：
- 首先调用
preview_work_item_mine— 向用户显示范围摘要（仅元数据/计数）。 - 等待明确批准（“是的，继续”）、一个文件路径（
.growth-scout/work-items.json）或跳过。 - 只有在获得批准后，才使用
preview_id+confirmed: true调用mine_work_item_signals。 - 未经用户确认，切勿从 Git 远程自动检测提供商。
- 如果用户拒绝 → 仅使用人工证据；根据细则限制需求强度上限。
- 在引导安装过程中（
install-growth-scout.mjs）切勿进行挖掘。
有关完整的先问后做流程，请参阅 integrations/mcp.md。
对于竞争对手研究，将发现结果组织到以下类别：
| 类别 | 含义 |
|---|---|
| 入门级 | 用户期待该功能；缺失会影响转化/留存 |
| 差异化 | 你可以拥有的有意义差距 |
| 竞争对手弱点 | 他处用户抱怨的痛点 |
| 复制风险 | 在矩阵上看起来不错，但不符合你的定位 |
| 忽略/噪音 | 炒作、仅企业级，或与你的理想客户画像无关 |
方法：references/competitor-analysis.md。
维护证据分类账：templates/evidence-ledger-template.md。
阶段 4：识别机会
跨增长杠杆生成候选功能。分类：references/growth-taxonomy.md。
| 杠杆 | 示例机会类型 |
|---|---|
| 获取 | SEO 页面、集成市场、免费层级钩子 |
| 激活 | 入门清单、模板、价值实现时间捷径 |
| 留存 | 通知、保存状态、习惯循环 |
| 收入 | 使用限制、席位计费、高级层级 |
| 推荐 | 邀请积分、共享工作空间 |
| 扩展 | 团队功能、API、管理员控制 |
| 信任 | SSO、审计日志、状态页面、导出 |
| 差异化 | 独特工作流、垂直聚焦 |
| 入门级 | 缺失的基础能力 |
| 运营效率 | 管理工具、支持分流 |
目标是在打分前产生 8–15 个原始想法。合并重复项。
阶段 5：评分机会
使用增长机会评分模型。完整细则：references/opportunity-scoring.md。推荐区间（立即构建、先验证、搁置、忽略）：请参阅该文件中的推荐阈值表。
增长机会评分 =
需求强度
+ 竞争对手差距
+ 战略契合度
+ 增长杠杆
+ 收入/留存影响
+ 代码库可行性
+ 学习时间优势
- 实施复杂度
- 产品风险
- 维护负担
除非用户另有说明，否则每个因素评分 1–5。
| 因素 | 定义 |
|---|---|
| 需求强度 | 有证据表明用户需要此功能 |
| 竞争对手差距 | 竞争对手缺乏、做得不好，或用户期待此功能 |
| 战略契合度 | 符合定位和理想客户画像 |
| 增长杠杆 | 改善获取、激活、留存、收入、推荐或扩展 |
| 收入/留存影响 | 可能的业务影响 |
| 代码库可行性 | 当前架构支持它 |
| 学习时间优势 | 验证假设的速度 |
| 实施复杂度 | 工程成本（减去） |
| 产品风险 | 用户体验混淆、范围蔓延、分心（减去） |
| 维护负担 | 长期成本（减去） |
当证据薄弱时，将需求强度上限设为 2，并建议先验证。
阶段 6：推荐下一个功能
输出 3–7 个排序后的机会。每个机会需包含：
- 功能名称
- 增长杠杆
- 问题
- 目标用户
- 证据（附置信度）
- 竞争对手洞察
- 为何是现在
- MVP 范围
- 代码库适配度
- 预计工作量（小/中/大）
- 风险
- 成功指标
- 建议的验证
- 推荐： 立即构建 | 先验证 | 搁置 | 忽略
报告中必须包含的部分：
- 执行摘要（首选方案 + 备选方案）
- 排序后的机会表格及评分
- 前三名的评分分解
- 证据摘要（已知 vs 推断 vs 未知）
- 针对前 2–3 个推荐的为什么不构建它
- 针对非“立即构建”选项的验证计划
模板：templates/opportunity-report-template.md。
大型仓库模式
当代码库太大无法在一次读取中完成时（单体仓库、超过约 5 万行代码、或上下文限制），请使用此多轮序列。不要试图在单轮中完成所有阶段。
| 轮次 | 范围 | 输出 |
|---|---|---|
| 1 | 仅阶段 1–2 | 产品扫描 + 能力地图（templates/product-map-template.md）。暂不打分。 |
| 2 | 阶段 3 + 阶段 4（轻量） | 外部信号摘要 + 机会长名单（8–15 个标题及一行问题陈述）。无完整 GOS 表。 |
| 3 | 阶段 5–6（前 5 名） | 仅对长名单中的前 5 名项目进行完整 GOS 评分和排序。 |
| 4 | 按需阶段 7 | 仅深度挖掘第 1 名；PRD / GitHub Issues 仅在用户要求时生成。 |
在轮次之间，将产品地图和长名单作为上下文传递。在未重新读取仓库的地方标记未知。当阶段 1 需要快速骨架时，建议在产品仓库上运行 node scripts/repo-inventory.mjs（该工具随 Growth Scout 包一起提供）。
阶段 7：将选定的机会转化为执行工件
当用户选定一个功能时，根据需要生成：
| 工件 | 模板 / 参考 |
|---|---|
| 增长 PRD | templates/growth-prd-template.md |
| GitHub Issue 分解 | templates/github-issues-template.md |
| 技术实施方案 | 内联在 PRD 中或引用仓库模式的独立部分 |
| 测试计划 | 验收标准 + 回归区域 |
| 发布清单 | PRD 中的发布计划部分 |
| 指标计划 | 成功指标 + 事件名称（如果存在分析设施） |
| 验证实验 | references/validation-experiments.md |
PRD 示例：examples/example-growth-prd.md。
快速参考
| 主题 | 文件 |
|---|---|
| 增长杠杆 | references/growth-taxonomy.md |
| 评分细则 | references/opportunity-scoring.md |
| 竞争对手方法 | references/competitor-analysis.md |
| 信号来源 | references/market-signal-sources.md |
| 行业包 | references/industry-packs/（b2b-saas、developer-tools、consumer-mobile） |
| 代码库映射 | references/codebase-product-mapping.md |
| 验证选项 | references/validation-experiments.md |
| 可选 MCP 侦察 | integrations/mcp.md — 竞争对手 + 工作项工具（mcp/growth-scout-mcp/） |
| 产品扫描示例 | examples/example-product-scan.md |
| 机会报告示例 | examples/example-opportunity-report.md |
最小可行运行（限时）
如果用户想要快速答案：
- 略读 README + 路由 + 包文件（相当于 5 分钟）
- 列出前 5 个现有功能 + 3 个明显差距
- 为 3–5 个想法打分，并明确标注未知项
- 推荐一个立即构建和一个先验证
仍需包含成功指标和证据标签。