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.9 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.
# /pos - 产品定位与差异化
## 命令定位
明确产品在市场中的独特位置、核心价值主张、以及与竞品的差异点。
## 第 0 步:加载项目状态
执行本指令前,先读取项目根目录下的 `.yxstack/_state.md`(如果项目 CODEBUDDY.md
自定义了 YxStack 存档路径,则使用自定义路径):
- 了解项目当前所处的 YxStack 阶段exploration/validation/positioning/pricing/growth
- 确认已有的关键假设和决策
- 检查是否有与本次指令相关的待处理项
- 如果 _state.md 不存在,说明这是项目首次使用 YxStack
然后按原有规则检查历史记录:
执行本指令前,先检查当前项目根目录下的 `.yxstack/` 目录(如果项目 CODEBUDDY.md
自定义了 YxStack 存档路径则使用自定义路径查找近期同指令pos的历史记录
- 如果有同类产品的定位分析 → 标注与历史定位的一致性/差异点
- 如果历史定位已被市场验证失败 → 追问"现在的基础条件有什么变化?"
- 如果没有历史记录 → 跳过,正常执行
### 前置指令摘要
读取 `.yxstack/` 中最近 pfit痛点验证记录提取
- 已验证的痛点结论(一句话)
- 未解决的待处理项
- 本次定位需基于已验证痛点,而非从零重建假设
### Confusion Protocol假设暴露
在执行本指令时,遇到以下情况停止推理,转为追问用户:
- 对用户业务场景的关键事实在猜测而非确认
- 对市场/用户行为的判断缺少定量或定性证据
- 在多个不相容假设之间跳转(信号:假设 > 3 个未验证)
激活时机:上述任一条触发时,列出已知/未知,追问缺失信息,不继续产出。
### 加载知识库
读取 `.yxstack/learn/knowledge.md`(如果存在):
- /pos 优先参考:竞品全景、行业背景、市场数据
- 如果有相关数据,直接引用而非重新追问用户
- 如果知识库信息与本次分析结论矛盾,标记为「待验证」并追问
- 如果 knowledge.md 不存在,跳过
### 加载近期学习
搜索 `.yxstack/_timeline.jsonl` 中最近 10 条高置信度≥7的学习记录type=insight/decision/pitfall
- 若有与本次定位分析相关的洞察 → 引用而非重新推理
- 若发现与历史洞察矛盾的结论 → 标记为「待验证」
- 若无相关记录 → 跳过
## 核心追问清单
### 1. 价值主张提炼
- [ ] 用一句话说清楚:为谁、解决什么问题、带来什么结果?
- [ ] 用户不用你的产品之前,是怎么凑合过的?
- [ ] 你的价值主张能不能让用户 5 秒内听懂?
### 2. 市场位置
- [ ] 你是品类开创者、跟随者、还是搅局者?
- [ ] 你的价格带和品质带在市场的哪个象限?
- [ ] 用户心智里能不能给你安一个位置?
### 3. 差异化拆解
- [ ] 你比竞品好在哪?(不能只说"更好用"
- [ ] 这个差异用户能感知到吗?愿意为这个差异买单吗?
- [ ] 竞品能不能快速抄袭你的差异点?如果能,多快?
### 4. 护城河评估
- [ ] 你的壁垒是什么?(网络效应、数据、品牌、供应链、合规)
- [ ] 资本市场进入会摧毁你的定位吗?
## 输出结构
1. **一句话定位**格式「为___提供___不同于___我们___」
2. **差异化清单**:每项附"用户是否买单"的判断
3. **竞争位置图**:价格 × 品质矩阵中的位置
4. **风险预警**:最容易被攻破的差异点
## 常见误区
- 拿功能当定位("我们更快"不如"你能多睡一小时"
- 面面俱到等于没有定位
- 对标大厂但不具备大厂的资源禀赋
## 存档规则
执行完毕生成报告后,按以下规范存档:
**默认路径**`{项目根目录}/.yxstack/pos-{日期}-{一句话摘要}.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":"pos","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":"pos","event":"completed","type":"insight|decision|pitfall","key":"kebab-case-键","insight":"一句话洞察","confidence":N,"ts":"当前时间"}
```