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

5.9 KiB
Raw Permalink Blame History

/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 + 报告正文

---
title: "{一句话标题}"
author: "{执行者}"
date: "{YYYY-MM-DD}"
tags: ["关键词1", "关键词2"]
status: draft  # draft → validated → outdated
---

更新项目状态

追加事件日志

.yxstack/_timeline.jsonl 追加一行:

{"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.jsonltype: insight
  • 是否有可复用的决策模式?→ 追加 _timeline.jsonltype: decision
  • 是否发现了需要避免的判断陷阱?→ 追加 _timeline.jsonltype: pitfall

判断标准:「下次执行同类分析时,这个洞察能省时间吗?」 不记录:显而易见的事实、一次性结论、与已有知识完全重复的内容。

追加格式:

{"skill":"pos","event":"completed","type":"insight|decision|pitfall","key":"kebab-case-键","insight":"一句话洞察","confidence":N,"ts":"当前时间"}