Files
开阳星 75152c36c2 feat: v0.3.0 — /learn 知识库 + 自动发现
对照 gstack /learn + Operational Self-Improvement 设计:

/learn 知识库:
- 新增 commands/learn.md 指令模板
- 支持全类型外部材料摄入(PDF/DOCX/XLSX/CSV/HTML/图片等)
- 8 模块 knowledge.md(行业背景/市场数据/竞品全景/目标用户/约束/假设/冲突/溯源)
- 子命令:ingest、update、show、prune

自动发现:
- 8 条命令更新项目状态追加 Operational Self-Improvement 段
- _timeline.jsonl 扩展 type/confidence/key 字段
- 写入标准:省时判断 + 非显而易见 + 置信度标注

8 命令第 0 步增强:
- 加载知识库(learn/knowledge.md)
- 加载近期学习(_timeline.jsonl 高置信度记录)

ROADMAP 版本号重排 + state_template 增强 + install.sh 更新
2026-05-03 05:08:39 +08:00

133 lines
5.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# /gtm - 冷启动与推广方案
## 命令定位
设计从 0 到 1 的冷启动策略和推广方案,核心问题是"第一批用户从哪来"
和"怎么让他们留下来并帮你带人"。
## 第 0 步:加载项目状态
执行本指令前,先读取项目根目录下的 `.yxstack/_state.md`(如果项目 CODEBUDDY.md
自定义了 YxStack 存档路径,则使用自定义路径):
- 了解项目当前所处的 YxStack 阶段exploration/validation/positioning/pricing/growth
- 确认已有的关键假设和决策
- 检查是否有与本次指令相关的待处理项
- 如果 _state.md 不存在,说明这是项目首次使用 YxStack
然后按原有规则检查历史记录:
执行本指令前,先检查当前项目根目录下的 `.yxstack/` 目录(如果项目 CODEBUDDY.md
自定义了 YxStack 存档路径则使用自定义路径查找近期同指令gtm或相关pos/comp的历史记录
- 如果已有定位或竞品分析 → 作为推广输入
- 如果已有历史推广方案 → 标注执行结果/调整点
- 如果没有历史记录 → 跳过,正常执行
### Confusion Protocol假设暴露
在执行本指令时,遇到以下情况停止推理,转为追问用户:
- 对用户业务场景的关键事实在猜测而非确认
- 对市场/用户行为的判断缺少定量或定性证据
- 在多个不相容假设之间跳转(信号:假设 > 3 个未验证)
激活时机:上述任一条触发时,列出已知/未知,追问缺失信息,不继续产出。
### 加载知识库
读取 `.yxstack/learn/knowledge.md`(如果存在):
- /gtm 优先参考:目标用户(画像+决策链)、行业背景
- 如果有相关数据,直接引用而非重新追问用户
- 如果知识库信息与本次分析结论矛盾,标记为「待验证」并追问
- 如果 knowledge.md 不存在,跳过
### 加载近期学习
搜索 `.yxstack/_timeline.jsonl` 中最近 10 条高置信度≥7的学习记录type=insight/decision/pitfall
- 若有与本次推广方案相关的洞察 → 引用而非重新推理
- 若发现与历史洞察矛盾的结论 → 标记为「待验证」
- 若无相关记录 → 跳过
## 核心追问清单
### 1. 冷启动策略
- [ ] 第一批 100 个用户从哪来?(不要答"推广"
- [ ] 这批种子用户有什么特征?为什么选他们?
- [ ] 你个人能直接触达多少潜在用户?
### 2. 渠道选择
- [ ] 你的用户在哪?(线上社区、线下场景、行业会议、微信群)
- [ ] 哪个渠道的 CAC 最低?哪个渠道的留存最高?
- [ ] 哪些渠道你团队有资源/关系能撬动?
### 3. 传播机制
- [ ] 用户用了之后为什么会告诉别人?(主动还是被动)
- [ ] 有没有内置的病毒循环?(邀请、分享、协作、展示)
- [ ] NPS 能达到多少才有自传播?
### 4. 推广节奏
- [ ] 第一个月做什么?第三个月做什么?
- [ ] 什么时候开始付费推广?烧钱的拐点在哪?
- [ ] 推广预算是多少?能烧多久?
### 5. 转化漏斗
- [ ] 从曝光到注册、注册到活跃、活跃到付费,各层的转化率预估
- [ ] 哪一层漏得最多?打算怎么补?
## 输出结构
1. **种子用户画像**:人 + 来源 + 触达方式
2. **渠道矩阵**:渠道 × CAC × 预期转化率 × 优先级
3. **传播设计**:分享动机 + 病毒系数估算
4. **推广日历**30天 / 90天 / 180天关键动作
5. **各阶段目标**:用户量、留存率、付费转化
## 常见误区
- 没有种子用户就做大众推广
- 渠道贪多嚼不烂(盯住一两个打透)
- 把「砸钱」当策略而不是助攻
## 存档规则
执行完毕生成报告后,按以下规范存档:
**默认路径**`{项目根目录}/.yxstack/gtm-{日期}-{一句话摘要}.md`
(如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径,优先使用自定义路径)
**格式**YAML frontmatter + 报告正文
```yaml
---
title: "{一句话标题}"
author: "{执行者}"
date: "{YYYY-MM-DD}"
tags: ["关键词1", "关键词2"]
status: draft # draft → validated → outdated
---
```
## 更新项目状态
### 追加事件日志
`.yxstack/_timeline.jsonl` 追加一行:
```json
{"skill":"gtm","event":"completed","ts":"当前时间","phase":"当前阶段","summary":"本次产出核心结论","assumption":"本次新增假设(有则填,无则留空)","decision":"本次关键决策(有则填,无则留空)"}
```
### 更新状态快照
更新 `.yxstack/_state.md`
- 如果本次执行推动了项目阶段前进,更新 `phase` 字段
- 本次新增的假设 → 写入「关键假设」表status: active
- 如果本次结论推翻了旧假设 → 将对应旧假设标记为 challenged 或 outdated
- 如有重要决策 → 追加「决策链」
- 更新「待处理项」:标记已完成的,新增下一步建议
- 如果 _state.md 不存在,按模板创建(参考 templates/state_template.md
- 每个 active 假设必须附带验证标准(一句话:用什么证据可证实/证伪)
- 同时 active 假设不超过 5 条,达到上限时必须先标记一条旧假设为 outdated 才能新增
### 自动发现Operational Self-Improvement
本指令执行完成后,回顾本次产出的核心结论:
- 是否有对后续指令有参考价值的洞察?→ 追加 `_timeline.jsonl`type: insight
- 是否有可复用的决策模式?→ 追加 `_timeline.jsonl`type: decision
- 是否发现了需要避免的判断陷阱?→ 追加 `_timeline.jsonl`type: pitfall
判断标准:「下次执行同类分析时,这个洞察能省时间吗?」
不记录:显而易见的事实、一次性结论、与已有知识完全重复的内容。
追加格式:
```json
{"skill":"gtm","event":"completed","type":"insight|decision|pitfall","key":"kebab-case-键","insight":"一句话洞察","confidence":N,"ts":"当前时间"}
```